Introduction aux Webhooks
Les webhooks permettent à JobAffinity de notifier votre système en temps réel lors d’événements importants (nouvelle candidature, changement d’étape, etc.).Événements disponibles
Les principaux événements webhook sont :ProcessStepChange: Changement d’étape dans le processus d’une candidature- Autres événements disponibles (contactez le support pour la liste complète)
Configuration
Pour configurer les webhooks, contactez le support d’Intuition-Software : support@intuition-software.fr Vous devrez fournir :- L’URL de votre endpoint qui recevra les notifications
- Les événements auxquels vous souhaitez souscrire
- Les méthodes de sécurité souhaitées (authentification, signature, etc.)
Historique des appels Webhook
Vous pouvez consulter l’historique des appels webhook effectués par JobAffinity.Requête
Réponse
Champs de la réponse
event: Type d’événement déclenchédatetime: Date et heure de l’appel webhookresponse_status: Code de statut HTTP retourné par votre endpointresponse_body: Corps de la réponse de votre endpointapplication: Référence à la candidature concernée
Cette ressource est paginée. Utilisez le champ
_next pour parcourir l’historique complet.Implémentation d’un endpoint
Bonnes pratiques
- Répondez rapidement : Votre endpoint doit répondre en moins de 30 secondes
- Retournez un code 200 : Même si le traitement est asynchrone
- Validez les données : Vérifiez l’authenticité et la structure des données reçues
- Gérez les doublons : Un même événement peut être envoyé plusieurs fois en cas d’échec
- Loggez les appels : Conservez une trace des webhooks reçus pour le débogage
Exemple d’endpoint (Python/Flask)
Exemple d’endpoint (Node.js/Express)
Monitoring
Utilisez l’historique des webhooks pour :- Vérifier que votre endpoint répond correctement
- Déboguer les erreurs
- Détecter les problèmes de performance
- Auditer les événements reçus