HaloITSM

Aggiornato il 2 nov 20265 min di letturaDi Emmanuel YazbeckPubblicato 18 ott 2026

Collega HaloITSM in modo che l'agente vocale AI possa trovare i chiamanti, creare e aggiornare ticket e cercare nella tua knowledge base in Halo.

Disponibilità: profili AI Voice e AI Voice + Helpdesk. Solo amministratori.

Prerequisiti

Hai il ruolo Proprietario o Amministratore.
La tua organizzazione utilizza il profilo AI Voice o AI Voice + Helpdesk.
Il tuo indirizzo Halo. Per un'istanza haloitsm.com, ti serve solo la prima parte, ad esempio northwind. Per un'istanza di prova o self-hosted, ti serve il nome host completo, ad esempio northwind.trial.usehalo.com.
Un'applicazione API Halo con un client ID e un client secret. AurionAI accede con questi due valori e richiede lo scope all.
Facoltativo: gli ID Halo dell'esito di chiusura, dello stato aperto e del tipo di ticket di richiesta di modifica.

Collega HaloITSM

Nella barra laterale, seleziona Configurazione.
Apri la categoria Integrazioni e seleziona Fornitori.
Nella sezione Integrazione ITSM, seleziona Configura un fornitore ITSM. Se uno strumento è già collegato, seleziona Modifica credenziali sulla sua scheda.
In Tipo di provider, seleziona HaloITSM.
In Nome istanza, digita la prima parte del tuo indirizzo Halo oppure il nome host completo. Non digitare un indirizzo IP.
Facoltativo: nel riquadro Impostazioni ciclo di vita ticket HaloITSM, compila gli ID:
- ID risultato chiusura: l'esito che AurionAI utilizza per chiudere i ticket.
- ID stato aperto: lo stato che AurionAI utilizza per riaprire i ticket.
- ID tipo richiesta di modifica: il tipo di ticket che AurionAI utilizza per le richieste di modifica.
Lascia un campo vuoto per utilizzare il valore predefinito di AurionAI.
In ID client e Segreto client, incolla i valori della tua applicazione API Halo.
Seleziona Testa connessione. Attendi Connessione riuscita con le credenziali fornite.
Controlla le opzioni Capacità. Leggi Collega i tuoi strumenti ITSM e CS.
Seleziona Salva.

La finestra di dialogo di connessione con i campi HaloITSM.

La prima volta che salvi, AurionAI apre la mappatura dei campi. Su una nuova installazione di Halo, imposta lì Valori predefiniti dei ticket in uscita. Leggi Mappa i campi del provider.

Quando modifichi una connessione salvata, la finestra di dialogo mostra Credenziali archiviate. Lascia vuoti il client ID e il client secret per mantenere i valori salvati.

Come AurionAI compila i nuovi ticket Halo

Un'installazione Halo predefinita rifiuta un nuovo ticket privo di impatto, urgenza e categoria. AurionAI invia questi tre campi per ogni nuovo ticket:

La categoria proviene dalle tue categorie Halo attive. AurionAI cerca prima una categoria che corrisponda al problema del chiamante. In caso contrario, utilizza una categoria generale.
Se AurionAI non riesce a leggere le tue categorie, utilizza impatto 2, urgenza 2 e la categoria General. Tenta di leggere nuovamente le categorie al ticket successivo.

Una categoria o un valore scelto da te ha sempre la precedenza.

Testa la connessione e crea un ticket di prova

Seleziona Testa la connessione sulla scheda. La scheda mostra Connessione riuscita. oppure il motivo dell'errore.
Seleziona Crea un ticket di prova per creare un ticket reale in Halo. Il ticket ha come oggetto "AurionAI - Configuration Test". Eliminalo in Halo al termine.

Modifica o rimuovi la connessione

Per sostituire le credenziali, seleziona Ruota le credenziali ITSM. Incolla i nuovi valori in ID client HaloITSM e Segreto client HaloITSM. Seleziona Testa connessione, poi Ruotare. AurionAI conserva i valori precedenti.
Per tornare alle credenziali precedenti, seleziona Rollback alle credenziali precedenti e conferma.
Per rimuovere la connessione, seleziona Rimuovi integrazione e conferma. Questa operazione non può essere annullata.

Risultato

La scheda mostra HaloITSM e Collegato. AurionAI testa la connessione ogni volta che salvi. Le chiamate che iniziano dopo il salvataggio utilizzano le nuove impostazioni.

Se qualcosa va storto

Credenziali non valide. Controlli la chiave API o il segreto client. Halo ha rifiutato il client ID o il client secret. Verifica entrambi i valori nella tua applicazione API Halo.
Autorizzazioni richieste mancanti. Contatti il Suo amministratore ITSM. L'applicazione API, o l'agente con cui viene eseguita, non dispone dell'autorizzazione per i ticket. Controlla le autorizzazioni dell'applicazione in Halo.
Limite di velocità superato. Riprovi più tardi. Halo limita il numero di richieste. Attendi un momento e riprova il test.
Impossibile raggiungere il fornitore. Controlli l'URL dell'API e la connettività di rete. AurionAI non riesce a raggiungere l'indirizzo. Controlla il nome dell'istanza. Per un'istanza di prova, digita il nome host completo.
Il nome dell'istanza è obbligatorio — un sottodominio o un nome host completo (lettere, numeri, trattini e punti) Digita un sottodominio o un nome host completo. Un indirizzo IP non è accettato.
Inserisca le credenziali sopra prima di testare. Il test nella finestra di dialogo richiede il client ID e il client secret. Incollali, anche se sono già salvati.
Halo rifiuta i nuovi ticket perché l'impatto, l'urgenza o la categoria sono obbligatori. Assicurati che Halo abbia categorie attive. Poi imposta Valori predefiniti dei ticket in uscita nella mappatura dei campi.
L'agente vocale non riesce a riaprire i ticket. Imposta ID stato aperto sull'ID di uno stato aperto nel tuo Halo.
L'agente vocale non riesce a chiudere i ticket. Imposta ID risultato chiusura sull'ID di un esito di chiusura nel tuo Halo.
L'agente vocale non riesce a creare richieste di modifica. AurionAI trova autonomamente il tipo di richiesta di modifica solo quando il tuo Halo ha esattamente un tipo di ticket denominato Change Request. In caso contrario, imposta ID tipo richiesta di modifica.
Test ticket non riuscito, con un messaggio che indica che la connessione non è verificata. Testa prima la connessione. Se il test fallisce, correggi le impostazioni e salvale.
Salvataggio impostazioni di integrazione non riuscito, con un messaggio che richiede di inserire nuovamente le credenziali. Hai modificato l'indirizzo Halo. Incolla nuovamente il client ID e il client secret, poi salva.