DocumentaciónAjuda

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.

Nesta página

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.

type

Quando chega

O que fazer

case.reply

A equipe escreveu uma resposta ao solicitante. Traz data.message.

Mostrar a resposta e avisar o usuário.

case.state

O status mudou.

Atualizar o status que você mostra.

case.resolved

O caso foi resolvido.

Avisar que está resolvido.

case.csat

Chega junto com a resolução se houver pesquisa pendente.

Mostrar a pesquisa de 1 a 5.

case.closed

O caso foi fechado.

Marcá-lo como fechado.

case.test

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.

Relacionado

Pesquisar em Elion ITSM

Digite pelo menos 2 letras para pesquisar em Elion ITSM.

↑↓ navegar · Enter abrir · Esc fechar