Les webhooks WhatsApp dans le recrutement : ce qu'il faut savoir

Un webhook WhatsApp API dans le recrutement est un callback HTTP déclenché en temps réel à chaque interaction d'un candidat sur WhatsApp — réponse à une offre, confirmation d'entretien, envoi de CV, feedback post-entretien. Pour les éditeurs d'ATS (Applicant Tracking System) et les plateformes HR tech, ce mécanisme permet d'automatiser des flux candidats complets sans que le recruteur ou le candidat n'ait à utiliser un portail dédié.

Pourquoi WhatsApp et les webhooks transforment le recrutement

Le recrutement souffre d'un problème de réactivité : les meilleurs candidats reçoivent plusieurs offres simultanément. L'employeur ou l'agence qui répond le plus vite remporte souvent la mise. Les emails de confirmation mettent des heures à être lus. Les appels téléphoniques interrompent et génèrent de la frustration.

WhatsApp avec webhooks change l'équation :

• Qualification automatisée : un candidat postule, reçoit un template WhatsApp avec 3 questions de qualification (disponibilité, prétentions salariales, mobilité). Ses réponses arrivent via webhook dans l'ATS en quelques minutes, sans qu'un recruteur n'ait à appeler.
• Confirmation d'entretien : le rappel J-1 propose deux options (Confirmer / Reporter). La réponse via bouton génère un webhook qui met à jour automatiquement l'agenda du recruteur et le statut du candidat dans l'ATS.
• Collecte de documents : un candidat envoie son CV en PDF ou une photo de son diplôme directement via WhatsApp. Le webhook récupère le document et l'attache au dossier candidat.
• Feedback candidat : après l'entretien, un message de remerciement avec un lien vers un court sondage (ou des boutons de notation) recueille l'expérience candidat. Les données arrivent en temps réel via webhook.

Événements webhook prioritaires pour un ATS

Événement	Type payload	Application recrutement
Réponse bouton	messages (type button_reply)	Confirmation entretien, choix de créneau
Réponse liste	messages (type list_reply)	Qualification : disponibilité, poste visé
Document entrant	messages (type document)	CV PDF, lettre de motivation, diplôme
Image entrante	messages (type image)	Photo de pièce d'identité, portfolio
Message texte libre	messages (type text)	Réponse à question ouverte, message spontané
Statut read	statuses	Confirmation de lecture d'une convocation
Statut failed	statuses + errors	Numéro invalide dans la base candidats
Opt-out	messages	Désabonnement du vivier de candidats

Le statut read est particulièrement utile en recrutement : si un candidat n'a pas lu la convocation 24h avant l'entretien, le recruteur peut décider d'appeler pour confirmer. Ce niveau de granularité n'existe pas avec l'email.

Architecture d'intégration dans un ATS

L'intégration webhook-ATS suit une logique standard, avec quelques spécificités liées aux données candidats :

1. Endpoint HTTPS sécurisé Votre ATS (ou son module d'extension) expose un endpoint dédié. La vérification HMAC-SHA256 est obligatoire — les données candidats (numéros, contenus de CV) ne doivent pas être accessibles à des requêtes non authentifiées.

2. Mapping candidat par wa_id Le numéro de téléphone (wa_id) est l'identifiant de corrélation entre WhatsApp et votre base candidats. À chaque webhook entrant, le worker résout le wa_id vers un candidate_id interne avant tout traitement.

3. Récupération des documents Quand un candidat envoie un CV, le webhook contient un media_id. Votre worker appelle l'API Media Meta pour télécharger le fichier, puis le stocke dans le module documentaire de l'ATS lié au bon dossier candidat.

4. Gestion des états de conversation En recrutement, les conversations WhatsApp suivent des états définis (candidature reçue → qualification → convocation → confirmation → entretien). Votre système doit maintenir un état de conversation par candidat pour router les messages entrants vers la bonne logique. Un message texte reçu en phase "qualification" n'a pas le même traitement qu'en phase "post-entretien".

5. Multi-tenant pour les agences d'intérim Une plateforme qui gère plusieurs agences ou plusieurs marques doit router les webhooks par phone_number_id. Chaque agence dispose de son numéro WhatsApp dédié.

Conformité RGPD et données des candidats

Les données de candidats sont protégées par le RGPD avec des règles spécifiques (durée de conservation limitée à 2 ans en France, droit à l'effacement, droit d'accès). Les webhooks introduisent des données supplémentaires à gérer :

• Consentement opt-in : le candidat doit avoir consenti explicitement à être contacté via WhatsApp lors de sa candidature. Ce consentement doit être documenté.
• Opt-out immédiat : un message "STOP" ou "Désinscription" capté par webhook doit déclencher la suppression du numéro de toutes les files d'envoi actives en quelques secondes.
• Durée de conservation : les logs webhook contenant des données candidats (numéros, contenus de messages) doivent être purgés selon la même politique que les données ATS (généralement 2 ans après le dernier contact).
• Droit à l'effacement : si un candidat demande l'effacement de ses données, les logs webhook le concernant doivent également être supprimés — pas seulement sa fiche dans l'ATS.
• Hébergement EU : les données de candidats français ne doivent pas transiter ou être stockées hors UE. Vérifiez l'infrastructure de votre fournisseur API WhatsApp.

FAQ

Les webhooks WhatsApp peuvent-ils alimenter directement un ATS comme Lever, Greenhouse ou un outil français comme Flatchr ?

Via les APIs de ces outils. Votre worker webhook ne s'intègre pas directement à l'ATS par magie — il appelle l'API REST de votre ATS pour mettre à jour le statut candidat, créer une note, ou attacher un document. La faisabilité dépend des endpoints exposés par votre ATS. La plupart des ATS modernes proposent des APIs suffisamment riches pour ce cas d'usage.

Comment gérer un candidat qui change de numéro en cours de processus ?

C'est un cas de désynchronisation wa_id / candidate_id. Votre système doit permettre à un recruteur de mettre à jour manuellement le numéro associé à un dossier candidat. Si un webhook entrant provient d'un wa_id inconnu, routez vers une boîte de traitement manuel plutôt que d'ignorer silencieusement.

WhatsApp est-il adapté pour les entretiens vidéo ou les tests de recrutement ?

WhatsApp permet d'envoyer des liens vers des outils de visioconférence ou des plateformes de test en ligne. WhatsApp ne remplace pas ces outils — il est le canal de coordination et de rappel qui y mène. Un webhook peut capter la confirmation de participation à un test et déclencher l'envoi du lien de connexion.

Quel est le coût d'envoi d'une convocation d'entretien via WhatsApp API ?

Une convocation envoyée en dehors de la fenêtre de session de 24h est un message utility facturé ~0,0336 € pour un numéro français (0,0248 € frais Meta + 0,0088 € Whakup). Comparé au coût d'un appel téléphonique de confirmation (temps recruteur + frais téléphoniques) ou d'un SMS sans accusé de lecture, l'économie et la valeur ajoutée sont significatives.

---

Pour déployer les webhooks WhatsApp dans votre ATS ou votre plateforme HR tech, consultez l'API WhatsApp Whakup. Whakup est Meta Tech Provider certifié, avec embedded signup, hébergement EU et multi-tenant natif pour les agences d'intérim et les éditeurs RH.

Approfondissez avec notre article sur le build vs buy pour l'intégration WhatsApp API et notre guide du prix de l'API WhatsApp Business en 2026 pour modéliser votre ROI.