Recevoir des notifications par webhook
Les notifications qu'Elion ITSM envoie à votre système quand l'équipe répond, change le statut, résout ou clôture un dossier, et comment les traiter.
Si le canal a une URL de sortie, Elion ITSM informe votre système de ce qui arrive à chaque dossier créé par ce canal. Votre application affiche ainsi la réponse à l'utilisateur et le prévient, sans interroger le serveur en permanence.
Avant de commencer
L'URL de sortie se configure dans le canal : lisez Canaux de dossiers. C'est un champ de chaque canal ; vous pouvez la modifier quand vous voulez.
Votre système doit vérifier la signature de chaque notification avec le secret de sortie. Lisez Signer les requêtes.
Les notifications
Chaque notification est un POST avec ce corps :
{
"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 contient le dossier complet, comme dans l'API (lisez Créer et suivre des dossiers par API). Recherchez-le dans votre système par externalId.
| Quand il arrive | Que faire |
|---|---|---|
| L'équipe a écrit une réponse au demandeur. Contient | Afficher la réponse et prévenir l'utilisateur. |
| Le statut a changé. | Mettre à jour le statut affiché. |
| Le dossier a été résolu. | Signaler qu'il est résolu. |
| Arrive avec la résolution s'il y a une enquête en attente. | Afficher l'enquête de 1 à 5. |
| Le dossier a été clôturé. | Le marquer comme clôturé. |
| Quelqu'un a cliqué sur Tester la sortie dans le canal. | Répondre simplement 200. |
Les notes internes de l'équipe ne sont jamais envoyées.
Comment répondre
Répondez 2xx dès que vous avez enregistré la notification. Si un traitement prend du temps, faites-le ensuite.
Si vous répondez un autre code ou ne répondez pas dans les 15 secondes, Elion ITSM réessaie après 30 secondes, 2 minutes, 10 minutes, 1 heure, 6 heures et 12 heures, pendant 24 heures au maximum. Ensuite, il la marque échec.
Le
webhook-idest le même à chaque nouvelle tentative d'une notification. Si vous l'avez déjà traitée, répondez 200 sans refaire ce que vous avez fait.
Consulter les livraisons
Dans les Réglages de l'espace → Canaux de dossiers, cliquez sur Voir les livraisons pour le canal. Vous voyez les 50 dernières notifications avec leur événement, dossier, statut, tentatives, code HTTP et erreur. La liste des canaux affiche aussi le Dernier envoi et la dernière erreur.