HaloITSM

Atualizado em 02/11/20266 min de leituraPor Emmanuel YazbeckPublicado a 18/10/2026

Ligue o HaloITSM para que o agente de voz com IA possa encontrar os chamadores, criar e atualizar tickets e pesquisar a sua base de conhecimento no Halo.

Disponibilidade: Perfis AI Voice e AI Voice + Helpdesk. Apenas administradores.

Pré-requisitos

Tem a função Proprietário ou Administrador.
A sua organização utiliza o perfil AI Voice ou o perfil AI Voice + Helpdesk.
O seu endereço Halo. Para uma instância haloitsm.com, precisa apenas da primeira parte, por exemplo northwind. Para uma instância de avaliação ou alojada localmente, precisa do nome de anfitrião completo, por exemplo northwind.trial.usehalo.com.
Uma aplicação API do Halo com um ID de cliente e um segredo de cliente. O AurionAI inicia sessão com estes dois valores e solicita o âmbito all.
Opcional: os IDs do Halo para o resultado de fecho, o estado de abertura e o tipo de ticket de pedido de alteração.

Ligar o HaloITSM

Na barra lateral, selecione Configuração.
Abra a categoria Integrações e selecione Fornecedores.
Na secção Integração ITSM, selecione Configurar um fornecedor ITSM. Se já existir uma ferramenta ligada, selecione Editar credenciais no respetivo cartão.
Em Tipo de Fornecedor, selecione HaloITSM.
Em Nome da Instância, escreva a primeira parte do seu endereço Halo ou o nome de anfitrião completo. Não escreva um endereço IP.
Opcional: na caixa Configurações do ciclo de vida de tickets HaloITSM, preencha os IDs:
- ID do resultado de encerramento: o resultado que o AurionAI utiliza para fechar tickets.
- ID do estado aberto: o estado que o AurionAI utiliza para reabrir tickets.
- ID do tipo de pedido de alteração: o tipo de ticket que o AurionAI utiliza para pedidos de alteração.
Deixe um campo vazio para utilizar o valor predefinido do AurionAI.
Em ID do Cliente e Segredo do Cliente, cole os valores da sua aplicação API do Halo.
Selecione Testar ligação. Aguarde por Ligação bem-sucedida com as credenciais fornecidas.
Verifique os interruptores de Capacidades. Leia Ligar as suas ferramentas ITSM e CS.
Selecione Guardar.

A caixa de diálogo de ligação com os campos do HaloITSM.

Na primeira vez que guardar, o AurionAI abre o mapeamento de campos. Numa nova instalação do Halo, defina aí os Valores predefinidos de tickets de saída. Leia Mapear campos do fornecedor.

Quando editar uma ligação guardada, a caixa de diálogo mostra Credenciais armazenadas. Deixe o ID de cliente e o segredo de cliente vazios para manter os valores guardados.

Como o AurionAI preenche novos tickets do Halo

Uma instalação predefinida do Halo recusa um novo ticket sem impacto, urgência e categoria. O AurionAI envia estes três campos em cada novo ticket:

A categoria provém das suas categorias ativas do Halo. O AurionAI procura primeiro uma categoria que corresponda ao problema do chamador. Caso contrário, utiliza uma categoria geral.
Se o AurionAI não conseguir ler as suas categorias, utiliza impacto 2, urgência 2 e a categoria Geral. Tenta ler as categorias novamente no ticket seguinte.

Uma categoria ou um valor que escolha manualmente tem sempre prioridade.

Testar a ligação e criar um ticket de teste

Selecione Testar ligação no cartão. O cartão mostra Ligação bem-sucedida. ou o motivo da falha.
Selecione Criar um ticket de teste para criar um ticket real no Halo. O ticket tem o assunto "AurionAI - Configuration Test". Elimine-o no Halo depois.

Alterar ou remover a ligação

Para substituir as credenciais, selecione Rodar credenciais ITSM. Cole os novos valores em ID do Cliente HaloITSM e Segredo do Cliente HaloITSM. Selecione Testar ligação e, em seguida, Rodar. O AurionAI mantém os valores anteriores.
Para voltar às credenciais anteriores, selecione Reverter para credenciais anteriores e confirme.
Para remover a ligação, selecione Remover integração e confirme. Esta ação não pode ser anulada.

Resultado

O cartão mostra HaloITSM e Ligado. O AurionAI testa a ligação sempre que guardar. As chamadas iniciadas após guardar utilizam as novas definições.

Se algo correr mal

Credenciais inválidas. Verifique a sua chave API ou segredo do cliente. O Halo recusou o ID de cliente ou o segredo de cliente. Verifique ambos os valores na sua aplicação API do Halo.
Permissões insuficientes. Contacte o administrador do seu ITSM. A aplicação API, ou o agente com o qual é executada, não tem permissão para tickets. Verifique as permissões da aplicação no Halo.
Limite de pedidos excedido. Tente novamente mais tarde. O Halo limita o número de pedidos. Aguarde um momento e teste novamente.
Não é possível alcançar o fornecedor. Verifique o URL da API e a conectividade de rede. O AurionAI não consegue aceder ao endereço. Verifique o nome da instância. Para uma instância de avaliação, escreva o nome de anfitrião completo.
O nome da instância é obrigatório — um subdomínio ou um nome de anfitrião completo (letras, números, hífenes e pontos) Escreva um subdomínio ou um nome de anfitrião completo. Não são aceites endereços IP.
Introduza as credenciais acima antes de testar. O teste na caixa de diálogo requer o ID de cliente e o segredo de cliente. Cole-os, mesmo que já estejam guardados.
O Halo recusa novos tickets porque o impacto, a urgência ou a categoria são obrigatórios. Certifique-se de que o seu Halo tem categorias ativas. Em seguida, defina os Valores predefinidos de tickets de saída no mapeamento de campos.
O agente de voz não consegue reabrir tickets. Defina ID do estado aberto com o ID de um estado aberto no seu Halo.
O agente de voz não consegue fechar tickets. Defina ID do resultado de encerramento com o ID de um resultado de fecho no seu Halo.
O agente de voz não consegue criar pedidos de alteração. O AurionAI encontra o tipo de pedido de alteração automaticamente apenas quando o seu Halo tem exatamente um tipo de ticket denominado Change Request. Caso contrário, defina ID do tipo de pedido de alteração.
Teste de ticket falhado, com uma mensagem a indicar que a ligação não está verificada. Teste primeiro a ligação. Se o teste falhar, corrija as definições e guarde-as.
Falha ao guardar definições de integração, com uma mensagem a indicar que deve introduzir novamente as credenciais. Alterou o endereço do Halo. Cole novamente o ID de cliente e o segredo de cliente e, em seguida, guarde.