Abonnez une adresse de votre système d’information à des événements RH : Illizeo y envoie un message signé à chaque fois qu’ils se produisent.
Ce que fait un webhook #
Le jeton d’API permet à un outil tiers de lire Illizeo ; le webhook le prévient. Quand un événement se produit, Illizeo envoie une requête POST en JSON à l’adresse https que vous avez déclarée. Votre système n’a plus besoin d’interroger l’API à intervalles réguliers.
Les événements disponibles #
| Famille | Événements |
|---|---|
| Collaborateurs | employee.created, employee.updated, employee.contract_ended |
| Absences | absence.requested, absence.approved, absence.rejected, absence.cancelled |
| Temps et présences | attendance.day_closed |
| Documents | document.uploaded, document.generated |
| Signatures électroniques | signature.completed, signature.declined, signature.cancelled |
| Exports planifiés | export.ready |
Un abonnement peut écouter un événement précis, une famille entière (employee.*) ou tous les événements (*).
Créer un abonnement #
-
Ouvrir l’écran. Paramètres › Gérer Illizeo › Webhooks. Il faut le droit de gérer les webhooks ; le droit de les consulter suffit pour voir la liste et le journal.
-
Déclarer l’adresse. Donnez un nom et une adresse en https. Les adresses de réseau interne sont refusées.
-
Choisir les événements. Un événement, une famille ou tout.
-
Conserver le secret. Il sert à vérifier la signature. Il peut être renouvelé à tout moment.
-
Envoyer un test. Le bouton envoie un message
pinget affiche la réponse de votre serveur.
Le message reçu #
Le corps contient id (identifiant unique de l’événement), event, occurred_at, tenant et data. data ne porte que des identifiants et des états : jamais de numéro AVS ou de sécurité sociale, de salaire ni de pièce jointe. Pour le détail, votre système lit l’API avec son jeton.
En-têtes : Illizeo-Event, Illizeo-Event-Id, Illizeo-Delivery et Illizeo-Signature.
Vérifier la signature #
-
Lire l’en-tête.
Illizeo-Signature: t=<horodatage unix>,v1=<signature>. -
Recalculer. HMAC-SHA256, avec le secret de l’abonnement, de la chaîne
<t>.<corps brut reçu>, en hexadécimal. Utilisez le corps brut, pas un JSON réencodé. -
Comparer en temps constant avec
v1, et refuser un horodatage trop ancien (5 minutes conseillées) pour bloquer les rejeux. -
Dédoublonner sur
Illizeo-Event-Id: une relance peut livrer deux fois le même événement.
Livraison, relances et journal #
| Règle | Valeur |
|---|---|
| Moment de l’envoi | Après l’enregistrement définitif : une saisie annulée n’émet rien |
| Délai par tentative | 10 secondes ; toute réponse 2xx vaut réception ; les redirections ne sont pas suivies |
| Relances | 6 tentatives : immédiate, puis après 1 min, 5 min, 30 min, 2 h et 12 h |
| Après la dernière | La livraison est abandonnée ; elle se relance à la main depuis le journal |
| Échecs continus | Après 72 heures, l’abonnement est désactivé et son créateur prévenu |
| Journal | Code de réponse, durée et erreur de chaque livraison, conservés 30 jours |
FAQ #
Les webhooks sont-ils inclus dans mon abonnement ?
Ils dépendent de votre abonnement. Si l’écran Webhooks n’apparaît pas, contactez-nous.
Un webhook peut-il bloquer une saisie RH ?
Non. L’envoi se fait en file, après l’enregistrement. Un serveur lent ou en panne ne ralentit ni n’annule rien dans Illizeo.
Peut-on brancher Zapier ou Make ?
Oui, avec un déclencheur « webhook entrant » : déclarez son adresse https comme abonnement. Pensez à vérifier la signature si l’outil le permet.
Et le bouton Approuver dans Slack ?
C’est l’inverse : Slack appelle Illizeo. Ce n’est pas un webhook configurable, c’est un rouage interne du connecteur Slack.
