Présentation des webhooks

Pourquoi c’est important

Les webhooks transmettent les données d’événements à vos systèmes dès qu’une action se produit — un candidat postule, un entretien est planifié, une offre d’emploi est publiée. Au lieu d’interroger une API en continu, vos intégrations reçoivent des rappels HTTP instantanés avec la charge utile complète de l’événement.

Ce dont vous avez besoin

• Un compte Kit avec un accès administrateur
• Un point de terminaison HTTPS capable de recevoir des requêtes POST

Configuration

Accédez à Intégrations > Webhooks, cliquez sur Nouveau webhook, puis remplissez les champs suivants :

Champ	Requis	Description
URL	Oui	Le point de terminaison HTTPS qui recevra les événements
Description	Non	Un libellé pour vous aider à identifier ce webhook
Événements	Oui	Les types d’événements auxquels vous souhaitez vous abonner

Sélectionnez des événements individuels ou abonnez-vous à des catégories entières. Cliquez sur Créer le webhook pour enregistrer. Kit génère un secret de signature que vous utiliserez pour vérifier les charges utiles.

Événements disponibles

Kit déclenche des webhooks dans six catégories :

Événements de candidature

Événement	Se déclenche quand
application.submitted	Un candidat soumet une candidature
application.rejected	Une candidature est rejetée
application.advanced	Une candidature passe à l’étape suivante
application.withdrawn	Un candidat retire sa candidature
application.offer_extended	Une offre est proposée à un candidat

Événements d’offre

Événement	Se déclenche quand
offer.accepted	Un administrateur accepte une offre
offer.declined	Un administrateur décline une offre
offer.candidate_accepted	Un candidat accepte une offre
offer.candidate_declined	Un candidat décline une offre
offer.revised	Une offre est révisée avec de nouvelles conditions

Événements d’entretien

Événement	Se déclenche quand
interview.scheduled	Un entretien est planifié
interview.confirmed	Un candidat confirme l’entretien
interview.completed	Un entretien est marqué comme terminé
interview.cancelled	Un entretien est annulé
interview.no_show	Un candidat est marqué comme absent

Événements d’exercice de code

Événement	Se déclenche quand
code_assignment.submitted	Un candidat soumet son exercice de code
code_assignment.auto_submitted	Un exercice de code est soumis automatiquement à l’échéance

Événements d’évaluation

Événement	Se déclenche quand
review.submitted	Un membre de l’équipe soumet une évaluation

Événements d’offre d’emploi

Événement	Se déclenche quand
job_posting.published	Une offre d’emploi est publiée
job_posting.paused	Une offre d’emploi est mise en pause
job_posting.closed	Une offre d’emploi est clôturée
job_posting.reopened	Une offre d’emploi est rouverte

Gestion des webhooks

Chaque webhook affiche son statut, les événements auxquels il est abonné et l’historique récent des livraisons.

• Mettre en pause — Suspendre les livraisons. Les événements déclenchés pendant la pause ne sont pas mis en file d’attente.
• Reprendre — Réactiver un webhook en pause ou désactivé automatiquement. Réinitialise le compteur d’échecs.
• Modifier — Changer l’URL, la description ou les événements souscrits.
• Rotation du secret — Générer un nouveau secret de signature. Mettez à jour votre point de terminaison avant d’effectuer la rotation.
• Supprimer — Supprimer définitivement le webhook et son historique de livraisons.

Tester votre point de terminaison

Cliquez sur Envoyer un ping de test sur n’importe quel webhook pour envoyer un événement test.ping à votre point de terminaison. Utilisez cette fonctionnalité pour vérifier la connectivité et la validation de la signature avant de vous abonner à des événements réels.

L’onglet Livraisons affiche les en-têtes de la requête, le code de statut de la réponse et le temps de traitement pour chaque tentative de livraison.

Aide-mémoire

• Accédez à Intégrations > Webhooks
• Ajoutez l’URL de votre point de terminaison HTTPS
• Sélectionnez les événements que vous souhaitez recevoir
• Copiez votre secret de signature
• Envoyez un ping de test pour vérifier la connectivité
• Implémentez la vérification de signature dans votre point de terminaison
• Retournez un code de statut 2xx pour confirmer la réception