---
title: Configurer des webhooks pour réagir aux événements
description: Abonner une adresse https à des événements RH, vérifier la signature HMAC, comprendre les relances et le journal des livraisons.
url: "https://illizeo.com/centre-aide/configurer-des-webhooks-pour-reagir-aux-evenements/"
updated: "2026-10-12"
category: "Plateforme / Intégrations & API"
---

# Configurer des webhooks pour réagir aux événements

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.

- **Lecture**5 min
- **Niveau**Avancé
- **Mise à jour**Octobre 2026
- **Module**Intégrations & API

## 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

1. **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.
2. **Déclarer l’adresse.** Donnez un nom et une adresse en https. Les adresses de réseau interne sont refusées.
3. **Choisir les événements.** Un événement, une famille ou tout.
4. **Conserver le secret.** Il sert à vérifier la signature. Il peut être renouvelé à tout moment.
5. **Envoyer un test.** Le bouton envoie un message `ping` et 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

1. **Lire l’en-tête.** `Illizeo-Signature: t=<horodatage unix>,v1=<signature>`.
2. **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é.
3. **Comparer en temps constant** avec `v1`, et refuser un horodatage trop ancien (5 minutes conseillées) pour bloquer les rejeux.
4. **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.

### Lire les données par l’API

Le webhook prévient ; l’API donne le détail.

[Voir l’API REST](/api-rest/)

### *Similaire*