DocumentaciónAide

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.

Sur cette page

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.

type

Quand il arrive

Que faire

case.reply

L'équipe a écrit une réponse au demandeur. Contient data.message.

Afficher la réponse et prévenir l'utilisateur.

case.state

Le statut a changé.

Mettre à jour le statut affiché.

case.resolved

Le dossier a été résolu.

Signaler qu'il est résolu.

case.csat

Arrive avec la résolution s'il y a une enquête en attente.

Afficher l'enquête de 1 à 5.

case.closed

Le dossier a été clôturé.

Le marquer comme clôturé.

case.test

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

Voir aussi

Rechercher dans Elion ITSM

Saisissez au moins 2 caractères pour rechercher dans Elion ITSM.

↑↓ naviguer · Enter ouvrir · Esc fermer