Webhooks

Les webhooks envoient un petit message vers une URL que tu contrôles chaque fois qu’un événement se produit dans PeekHire — tu peux ainsi réagir en temps réel au lieu d’interroger l’API en continu.

Fonctionnement des webhooks

1. Tu crées un endpoint (une URL sur ton serveur ou un outil d’automatisation) dans Outils de développement → Webhooks.
2. Tu choisis les événements qu’il doit recevoir.
3. Quand un événement se produit, PeekHire envoie un POST HTTP avec une charge utile JSON à ton endpoint.

Les charges utiles sont volontairement petites — elles indiquent ce qui s’est passé et l’objet concerné, afin que tu puisses récupérer les détails complets depuis l’API REST si tu en as besoin.

Événements disponibles

Les événements couvrent le cycle de recrutement, notamment :

• Candidatures — application.submitted, application.updated, application.stage_changed, application.rated, application.archived, application.restored, application.deleted.
• Commentaires de candidature — application.comment.created, application.comment.updated, application.comment.deleted.
• Campagnes — campaign.created, campaign.activated, campaign.paused, campaign.archived, campaign.restored.

Vérifier les envois

Chaque envoi est signé afin que tu puisses confirmer qu’il provient bien de PeekHire. Vérifie la signature sur ton endpoint avant de faire confiance à la charge utile, puis réponds avec un statut 2xx pour accuser réception.

Inspecter les envois

La vue Envois affiche les tentatives récentes de webhook et leurs résultats, afin que tu puisses confirmer que les événements arrivent et déboguer un endpoint qui ne répond pas.

Conseils

• Réponds rapidement avec un 2xx et effectue les tâches lourdes de manière asynchrone.
• Rends ton gestionnaire idempotent — le même événement peut parfois être envoyé plusieurs fois.
• Commence avec un outil comme Make, Zapier ou n8n si tu préfères ne pas gérer de serveur.