Receber avisos por webhook
Os avisos que o Elion ITSM envia ao seu sistema quando a equipe responde, muda o status, resolve ou fecha um caso, e como processá-los.
Se o canal tiver URL de saída, o Elion ITSM avisa seu sistema do que acontece com cada caso criado por esse canal. Assim sua aplicação mostra a resposta ao usuário e o avisa, sem consultar o tempo todo.
Antes de começar
A URL de saída é configurada no canal: leia Canais de casos. É um campo de cada canal; você pode mudá-la quando quiser.
Seu sistema deve verificar a assinatura de cada aviso com o segredo de saída. Leia Assinar as requisições.
Os avisos
Cada aviso é um POST com este corpo:
{
"type": "case.reply",
"timestamp": "2026-10-13T14:20:46.120Z",
"data": {
"case": { "number": "INC-000123", "externalId": "7c1e0b9a-…", "stateLabel": "En revisión", "publicMessages": [] },
"message": { "id": "981", "side": "agent", "author": "Carla Soto", "body": "Hola Ana, ¿qué formato elegiste?", "at": "2026-10-13T14:20:45.000Z", "attachments": [] }
}
}data.case traz o caso completo, igual à API (leia Criar e acompanhar casos por API). Procure-o no seu sistema pelo externalId.
| Quando chega | O que fazer |
|---|---|---|
| A equipe escreveu uma resposta ao solicitante. Traz | Mostrar a resposta e avisar o usuário. |
| O status mudou. | Atualizar o status que você mostra. |
| O caso foi resolvido. | Avisar que está resolvido. |
| Chega junto com a resolução se houver pesquisa pendente. | Mostrar a pesquisa de 1 a 5. |
| O caso foi fechado. | Marcá-lo como fechado. |
| Clicaram em Testar saída no canal. | Só responder 200. |
As notas internas da equipe nunca são enviadas.
Como responder
Responda 2xx assim que registrar o aviso. Se algo demorar, faça depois.
Se você responder outro código ou não responder em 15 segundos, o Elion ITSM tenta de novo após 30 segundos, 2 minutos, 10 minutos, 1 hora, 6 horas e 12 horas, durante no máximo 24 horas. Depois o marca como falhou.
O
webhook-idé o mesmo em cada nova tentativa de um aviso. Se você já o processou, responda 200 sem repetir o que fez.
Ver as entregas
Em Ajustes da mesa → Canais de casos, clique em Ver entregas no canal. Você vê os últimos 50 avisos com evento, caso, status, tentativas, código HTTP e erro. A lista de canais também mostra o Último enviado e o último erro.