API WhatsApp et l'embedded signup : guide pour les logiciels RH

L'embedded signup WhatsApp est le mécanisme qui permet à vos clients RH de connecter leur numéro WhatsApp Business directement depuis votre interface, sans jamais quitter votre logiciel. Pour un éditeur de solution RH, c'est la condition sine qua non pour proposer WhatsApp comme canal natif — sans rediriger l'utilisateur vers une console Meta tierce.

Ce qu'est vraiment l'embedded signup

L'embedded signup est un flux OAuth initié depuis votre produit. L'utilisateur clique sur un bouton dans votre logiciel RH, une fenêtre Facebook s'ouvre en overlay, il autorise les permissions, crée ou lie son compte WhatsApp Business Account (WABA), et revient dans votre interface avec un token d'accès utilisable immédiatement.

Le résultat côté éditeur : vous récupérez un access_token, un waba_id et un phone_number_id que vous stockez côté serveur. Côté client RH : il est opérationnel sur WhatsApp en moins de dix minutes, sans documentation à lire.

Ce flux est réservé aux Business Solution Providers (BSP) et Meta Tech Providers certifiés. Vous ne pouvez pas l'implémenter seul — vous devez passer par un partenaire comme Whakup, qui vous fournit l'accès au flux embedded signup dans le cadre de sa solution en marque blanche.

Prérequis techniques pour l'intégrer dans votre logiciel RH

Avant d'ouvrir le flux, votre logiciel RH doit remplir plusieurs conditions :

Côté Meta :

• Votre application Meta doit être en mode Live (pas sandbox).
• Votre app_id doit être déclaré comme app partenaire du BSP.
• Les scopes whatsapp_business_management et whatsapp_business_messaging doivent être requis.

Côté frontend :

• Charger le SDK JavaScript de Facebook (https://connect.facebook.net/fr_FR/sdk.js).
• Initialiser avec votre app_id et la version API cible (minimum v19.0).
• Gérer l'événement message sur window pour capter le code d'autorisation renvoyé par Meta.

Côté backend :

• Échanger le code contre un token long-durée via l'endpoint /oauth/access_token.
• Stocker le token, le waba_id et le phone_number_id en base, associés au compte client.
• Abonner le numéro à votre webhook pour recevoir les messages entrants.

// Exemple de capture du code depuis l'événement window.message
window.addEventListener('message', (event) => {
  if (event.origin !== 'https://www.facebook.com') return;
  const data = JSON.parse(event.data);
  if (data.type === 'WA_EMBEDDED_SIGNUP' && data.event === 'FINISH') {
    const { code } = data.data;
    // Envoyer `code` à votre backend pour échanger contre un token
  }
});

Cas d'usage concrets dans un logiciel RH

L'embedded signup ouvre des flux très concrets pour vos clients DRH et responsables recrutement :

• Onboarding de nouveaux collaborateurs : le RH envoie automatiquement les documents d'accueil (contrat, badge, accès) via WhatsApp dès que le profil est créé dans le SIRH.
• Notifications de candidature : le candidat reçoit un message WhatsApp à chaque changement de statut de sa candidature, sans que le RH ait à intervenir manuellement.
• Rappels de rendez-vous : convocations à un entretien, rappels de formation, signature de documents — autant de messages à haute valeur ajoutée qui arrivent là où les collaborateurs lisent vraiment (taux d'ouverture WhatsApp : 95 %+).
• Authentification 2FA : codes OTP envoyés via WhatsApp pour les accès sécurisés au portail RH.

Flux RH	Type de conversation Meta	Coût moyen (FR)
Notification recrutement	Utility	~0,0336 €/msg
Envoi documents onboarding	Utility	~0,0336 €/msg
Campagne offres d'emploi	Marketing	~0,08 €/msg
Code OTP accès portail	Authentication	~0,0336 €/msg

Ce que change le passage par un Meta Tech Provider

Implémenter l'embedded signup seul, directement via Meta, demande d'obtenir la certification BSP — un processus long (plusieurs mois), coûteux, et conditionné à des volumes de messages et des critères techniques stricts.

En passant par Whakup, Meta Tech Provider certifié, vous intégrez l'embedded signup en quelques jours. Whakup vous fournit :

• L'app_id partenaire prêt à l'emploi.
• La documentation du flux et les exemples de code.
• Un accès multi-tenant : chaque client RH obtient son propre WABA isolé.
• L'hébergement EU, conforme RGPD — critique pour les données RH.

Le tarif Whakup est de 0,0088 €/message auxquels s'ajoutent les frais Meta selon la catégorie. Aucun coût fixe d'infrastructure, aucune certification Meta à passer.

Pour aller plus loin sur l'architecture multi-tenant et la gestion des comptes, consultez notre guide sur les WABA multi-numéros et la gestion avancée des comptes.

Pour comprendre comment les templates s'articulent avec ces flux RH, référez-vous à notre article sur les catégories de templates WhatsApp.

FAQ

L'embedded signup fonctionne-t-il pour tous les types de numéros WhatsApp ?

Oui, il fonctionne pour les numéros fixes, mobiles et les numéros déjà utilisés sur WhatsApp Business App — à condition que l'utilisateur accepte de migrer le numéro. La migration désactive l'application mobile mais active l'API.

Combien de temps dure l'implémentation de l'embedded signup dans un logiciel RH existant ?

Pour un développeur familier avec les flux OAuth, le frontend se code en une journée. La partie backend (échange de token, stockage, abonnement webhook) demande une à deux journées supplémentaires. Au total, comptez trois à cinq jours pour une intégration robuste.

Faut-il que chaque client RH ait un compte Meta Business Manager ?

Oui, chaque client doit disposer d'un Meta Business Manager vérifié. L'embedded signup guide l'utilisateur à travers cette vérification si elle n'est pas encore effectuée. Le processus est inclus dans le flux.

Les tokens d'accès expirent-ils ?

Les tokens utilisateurs expirent (60 jours par défaut). Il faut implémenter un mécanisme de rafraîchissement ou utiliser des tokens système longue durée générés via le Business Manager. Votre BSP peut vous guider sur la meilleure stratégie selon votre architecture.

---

L'embedded signup est le fondement technique de toute intégration WhatsApp sérieuse dans un logiciel RH. Plutôt que de construire et maintenir cette couche d'infrastructure vous-même, appuyez-vous sur un partenaire certifié. Accédez à l'API WhatsApp via Whakup et proposez WhatsApp à vos clients RH en quelques jours, pas en plusieurs mois.