Skip to main content

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 webhook
  • response_status : Code de statut HTTP retourné par votre endpoint
  • response_body : Corps de la réponse de votre endpoint
  • application : 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

  1. Répondez rapidement : Votre endpoint doit répondre en moins de 30 secondes
  2. Retournez un code 200 : Même si le traitement est asynchrone
  3. Validez les données : Vérifiez l’authenticité et la structure des données reçues
  4. Gérez les doublons : Un même événement peut être envoyé plusieurs fois en cas d’échec
  5. 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
Si votre endpoint retourne régulièrement des erreurs (5xx), les appels webhook peuvent être temporairement suspendus. Surveillez votre historique et corrigez les problèmes rapidement.

Gestion des versions

Les webhooks suivent le même principe de versioning que l’API REST. En cas de changement majeur dans le format des webhooks, vous serez notifié à l’avance.