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 huit 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.rejection_reverted |
Une candidature précédemment rejetée est rétablie |
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 |
É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 de revue
| Événement |
Se déclenche quand |
review.submitted |
Un membre de l’équipe soumet une revue |
É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 |
Événements de rapport CSIRT
| Événement |
Se déclenche quand |
csirt.report.submitted |
Un chercheur soumet un rapport de vulnérabilité |
csirt.report.triaged |
Un rapport est trié |
csirt.report.validated |
Un rapport est validé |
csirt.report.resolved |
Un rapport est résolu |
csirt.report.fix_verified |
Le correctif d’un rapport est vérifié |
csirt.report.dismissed |
Un rapport est rejeté |
csirt.report.assessed |
Un rapport est évalué |
csirt.report.assigned |
Un rapport est assigné à un membre de l’équipe |
csirt.report.bounty_approved |
Une prime est approuvée pour un rapport |
csirt.report.paid |
Une prime est versée |
Événements Outreach
| Événement |
Se déclenche quand |
outreach.prospect.drafted |
Un message est rédigé pour un prospect |
outreach.message.approved |
Un message de prospection est approuvé |
outreach.message.sent |
Un message de prospection est envoyé |
outreach.message.bounced |
Un message de prospection n’est pas distribué (bounce) |
outreach.message.failed |
L’envoi d’un message de prospection échoue |
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