Introduction
Les webhooks VoiceHire vous permettent de recevoir des notifications HTTP en temps réel lorsque des événements se produisent dans votre compte. Cela vous évite d’avoir à interroger constamment l’API pour détecter les changements.Configuration
1. Accéder aux paramètres
Connectez-vous à votre tableau de bord VoiceHire et accédez à la section API, puis à l’onglet Webhooks.2. Configurer votre endpoint
string
required
L’URL HTTPS où VoiceHire enverra les notifications
string
Clé secrète optionnelle pour signer les payloads (recommandé)
array
required
Sélectionnez les événements que vous souhaitez recevoir
3. Tester la configuration
Utilisez le bouton “Tester” pour envoyer un événement de test à votre endpoint.Format des webhooks
Tous les webhooks suivent le même format JSON :Headers HTTP
Vérification de la signature
Si vous avez configuré un secret partagé, VoiceHire signe chaque webhook avec HMAC-SHA256 :Événements disponibles
Campagnes
campaign.created
Déclenché lors de la création d’une nouvelle campagne.campaign.status_changed
Déclenché lorsque le statut d’une campagne change.Candidats
candidate.added
Déclenché lorsqu’un candidat est ajouté à une campagne.candidate.sourced
Déclenché lorsqu’un candidat est sourcé via SMS.Entretiens
candidate.interview.started
Déclenché lorsqu’un entretien téléphonique commence.candidate.interview.completed
Déclenché lorsqu’un entretien est terminé avec succès.candidate.interview.completed.extended
Version étendue avec les réponses détaillées (optionnel).candidate.interview.failed
Déclenché lorsqu’un entretien échoue ou est incomplet.failure_reason :
voicemail: Le candidat n’a pas décroché, messagerie vocaleno_answer: Pas de réponse du candidatuser_hangup: Le candidat a raccroché pendant l’entretientechnical_error: Erreur technique pendant le traitement

