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 huit catégories. Ce sont exactement les types d’événements auxquels vous pouvez vous abonner dans l’éditeur de webhook. Pour connaître la structure complète de la charge utile de chaque événement, consultez la Référence des événements webhook.

É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 au nom du candidat
offer.declined	Un administrateur décline une offre au nom du candidat

É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.paid	Une prime est versée
csirt.report.dismissed	Un rapport est rejeté
csirt.report.informative	Un rapport est clôturé comme informatif — valide, mais sans correction à apporter

Les webhooks CSIRT suivent le statut du rapport tout au long de son cycle de vie. Les actions qui ne modifient pas ce statut — évaluer la gravité, attribuer le rapport à un membre de l’équipe, approuver une prime — ne déclenchent aucun webhook propre. Abonnez-vous plutôt aux événements de statut qui les encadrent.

csirt.report.dismissed et csirt.report.informative clôturent tous deux un rapport et ne sont pas interchangeables : un rapport rejeté a été refusé, tandis qu’un rapport informatif est une découverte valide sans correction à apporter, qui peut malgré tout donner lieu à un bonus discrétionnaire. Si votre intégration assimile « clôturé » à « non valide », abonnez-vous séparément aux deux événements.

É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

• 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