Recibir avisos por webhook
Los avisos que Elion ITSM envía a tu sistema cuando el equipo responde, cambia el estado, resuelve o cierra un caso, y cómo procesarlos.
Si el canal tiene URL de salida, Elion ITSM avisa a tu sistema de lo que pasa con cada caso creado por ese canal. Así tu aplicación muestra la respuesta al usuario y le avisa, sin consultar a cada rato.
Antes de empezar
La URL de salida se configura en el canal: lee Canales de casos. Es un campo de cada canal; puedes cambiarla cuando quieras.
Tu sistema debe verificar la firma de cada aviso con el secreto de salida. Lee Firmar las peticiones.
Los avisos
Cada aviso es un POST con este cuerpo:
{
"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 trae el caso completo, igual que la API (lee Crear y seguir casos por API). Búscalo en tu sistema por externalId.
| Cuándo llega | Qué hacer |
|---|---|---|
| El equipo escribió una respuesta al solicitante. Trae | Mostrar la respuesta y avisar al usuario. |
| Cambió el estado. | Actualizar el estado que ves. |
| El caso se resolvió. | Avisar que está resuelto. |
| Llega junto con la resolución si hay encuesta pendiente. | Mostrar la encuesta de 1 a 5. |
| El caso se cerró. | Marcarlo como cerrado. |
| Presionaron Probar salida en el canal. | Solo responder 200. |
Las notas internas del equipo nunca se envían.
Cómo responder
Responde 2xx apenas registres el aviso. Si algo toma tiempo, hazlo después.
Si respondes otro código o no respondes en 15 segundos, Elion ITSM reintenta a los 30 segundos, 2 minutos, 10 minutos, 1 hora, 6 horas y 12 horas, durante 24 horas como máximo. Después lo marca falló.
El
webhook-ides el mismo en cada reintento de un aviso. Si ya lo procesaste, responde 200 sin repetir lo que hiciste.
Revisar las entregas
En Ajustes de la mesa → Canales de casos, presiona Ver entregas en el canal. Ves los últimos 50 avisos con su evento, caso, estado, intentos, código HTTP y error. La lista de canales muestra también el Último enviado y el último error.