Connexion Essayez gratuitement →

Plateforme · Webhooks

Des webhooks : Illizeo vous prévient

Le jeton d’API permet à un outil tiers de lire ; le webhook le prévient. Abonnez une adresse https de votre système d’information à des événements RH : à chaque événement, Illizeo y envoie un message signé.

Essayez gratuitementEn parler avec nous

14 événements, en 6 familles

Collaborateurs
employee.created créé · employee.updated modifié · employee.contract_ended contrat terminé
Absences
absence.requested demandée · absence.approved validée · absence.rejected refusée · absence.cancelled annulée
Temps et présences
attendance.day_closed journée de présence close
Documents
document.uploaded déposé · document.generated généré
Signatures
signature.completed terminée · signature.declined refusée · signature.cancelled annulée
Exports planifiés
export.ready fichier prêt à télécharger

Un abonnement écoute un événement précis, une famille entière (employee.*) ou tout (*). Le bouton « Envoyer un test » livre un message ping pour vérifier votre récepteur.

Ce que contient un message

Des identifiants, pas de données sensibles

Le message porte un identifiant unique, le nom de l’événement, sa date, votre espace et des identifiants et états. Jamais de numéro AVS ou de sécurité sociale, de salaire ni de pièce jointe : votre système complète en lisant l’API avec son jeton.

Une signature à vérifier

En-tête Illizeo-Signature: t=…,v1=… : un HMAC-SHA256, avec le secret de l’abonnement, de l’horodatage suivi d’un point et du corps brut reçu. Comparez en temps constant et refusez un horodatage trop ancien (5 minutes conseillées) pour bloquer les rejeux.

POST https://votre-si.example/illizeo
Illizeo-Event: absence.approved
Illizeo-Event-Id: 6f1c…
Illizeo-Delivery: 4821
Illizeo-Signature: t=1791820800,v1=5d2a…

{"id":"6f1c…","event":"absence.approved","occurred_at":"2026-10-12T09:14:03+02:00","tenant":"acme","data":{"absence_id":912,"employee_id":148,"absence_type_id":3,"from":"2026-10-20","to":"2026-10-24","status":"approved"}}

Livraison et fiabilité

Adresse
https obligatoire. Les adresses de réseau interne sont refusées et les redirections ne sont pas suivies.
Moment de l’envoi
Après l’enregistrement définitif : une saisie annulée n’émet rien. Un webhook ne fait jamais échouer un enregistrement RH.
Délai
10 secondes par tentative. Toute réponse 2xx vaut réception.
Relances
6 tentatives au total : immédiate, puis après 1 min, 5 min, 30 min, 2 h et 12 h. Ensuite, la livraison est abandonnée et se relance à la main.
Désactivation
Un abonnement en échec continu depuis 72 heures est désactivé, et son créateur est prévenu.
Journal
Chaque livraison est tracée (code de réponse, durée, erreur) pendant 30 jours.
Secret
Un secret par abonnement, renouvelable à tout moment.

Les webhooks se règlent dans votre espace Illizeo (menu Paramètres), avec deux droits distincts : consulter et gérer. Ils dépendent de votre abonnement. Pour lire les données elles-mêmes, voir l’API REST.

Brancher vos outils sur les événements RH

En parler avec nous