Au lieu de poller l’API toutes les minutes, abonnez votre système aux événements Illizeo en webhooks. Création de fiche, validation de congé, paie produite : votre serveur reçoit un POST en moins de 200ms.
Événements disponibles #
| Domaine | Événements |
|---|---|
| employee | created, updated, archived, reactivated |
| leave | requested, approved, rejected, cancelled |
| payroll | generated, validated, exported, error |
| expense | submitted, approved, paid |
| document | uploaded, signed, downloaded |
| integration | connected, disconnected, error |
Procédure pas à pas #
-
Créer un webhook #
Paramètres → API → Webhooks → Nouveau. URL endpoint, événements écoutés, secret de signature.
-
Vérifier la signature #
Chaque webhook envoyé est signé avec HMAC SHA-256. Votre serveur vérifie pour authentifier l’expéditeur.
-
Répondre rapidement #
HTTP 200 sous 5 secondes. Au-delà, retry automatique avec exponential backoff (1, 5, 25, 125 sec).
-
Tester avec ngrok ou webhook.site #
Pour développer localement. Le bouton Test webhook envoie un événement fictif.
-
Monitorer la santé #
Dashboard Webhook Health : taux de succès, latence, derniers échecs avec payload.
FAQ #
Que se passe-t-il en cas de panne de mon serveur ?
Retry pendant 24h avec backoff. Au-delà, le webhook est marqué failed et vous recevez une alerte.
Combien de webhooks par tenant ?
Jusqu’à 50 webhooks actifs. Quota augmentable sur demande.
Ordre des événements garanti ?
Non, à cause des retry. Utilisez l’ID + timestamp pour réordonner si critique.
Format du payload ?
JSON avec metadata standard (event_id, type, created_at, tenant_id) + data spécifique au type.
Voir Sécurité & SSO #
Apprenez à sécuriser l’accès à votre tenant.
