DocumentaciónAyuda

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.

En esta página

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.

type

Cuándo llega

Qué hacer

case.reply

El equipo escribió una respuesta al solicitante. Trae data.message.

Mostrar la respuesta y avisar al usuario.

case.state

Cambió el estado.

Actualizar el estado que ves.

case.resolved

El caso se resolvió.

Avisar que está resuelto.

case.csat

Llega junto con la resolución si hay encuesta pendiente.

Mostrar la encuesta de 1 a 5.

case.closed

El caso se cerró.

Marcarlo como cerrado.

case.test

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-id es 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.

Relacionado

Buscar en Elion ITSM

Escribe al menos 2 letras para buscar en Elion ITSM.

↑↓ moverse · Enter abrir · Esc cerrar