API WhatsApp et l'embedded signup : guide pour les agences de communication

L'embedded signup WhatsApp est un flux d'authentification OAuth intégré directement dans l'interface d'un BSP ou d'une plateforme tierce. Il permet à un client final de connecter son compte Meta Business et de provisionner un numéro WhatsApp Business sans jamais quitter votre outil. Pour une agence de communication qui gère plusieurs annonceurs, c'est la différence entre un onboarding de 3 jours et un onboarding de 15 minutes.

Comment fonctionne l'embedded signup techniquement

Le flux repose sur le SDK JavaScript de Meta (@meta/business-sdk) chargé côté client. Quand le contact clique sur votre bouton d'activation, une fenêtre popup Meta s'ouvre. L'utilisateur :

1. Se connecte à son compte Meta Business.
2. Sélectionne ou crée son WhatsApp Business Account (WABA).
3. Vérifie ou ajoute un numéro de téléphone.
4. Accepte les conditions d'utilisation WhatsApp Business.

À la fermeture de la popup, votre backend reçoit un code d'autorisation via un message window.addEventListener('message', ...). Vous échangez ce code contre un token système longue durée via l'API Graph de Meta. Ce token est ensuite utilisé pour envoyer des messages au nom du client.

Ce que le BSP doit avoir configuré en amont

• Une app Meta vérifiée avec les permissions whatsapp_business_management et whatsapp_business_messaging.
• Un config_id d'embedded signup généré dans le Meta Business Manager.
• Un webhook configuré pour recevoir les événements de statut (messages, qualité, templates).

Whakup, en tant que Meta Tech Provider certifié, expose un endpoint dédié qui gère cet échange de token et le provisioning du numéro de votre côté — vous n'avez qu'à intégrer le bouton et écouter les callbacks.

Pourquoi c'est critique pour une agence de communication

Sans embedded signup, chaque nouveau client annonceur doit :

• Créer ou accéder à son Meta Business Manager.
• Demander l'accès à l'API WhatsApp Business manuellement.
• Passer une vérification d'entreprise Meta qui peut durer plusieurs semaines.
• Vous transmettre des tokens ou des accès, ce qui pose des problèmes de sécurité et de RGPD.

Avec l'embedded signup, vous restez maître du flux. Le client s'authentifie, vous récupérez les droits nécessaires, et la ligne est opérationnelle. Aucun accès à des identifiants Meta ne transite par email ou Slack.

Pour une agence qui active 10 clients par mois, le gain est immédiat. Pour une agence en croissance, c'est un avantage concurrentiel direct : vous pouvez proposer une activation WhatsApp comme feature native de votre offre, sans dépendre d'un prestataire externe à chaque nouveau compte.

Bonnes pratiques d'intégration pour les agences

Gérez l'état de la popup proprement. La fenêtre Meta peut être fermée par l'utilisateur à mi-parcours. Détectez l'événement LaunchWhatsAppSignup avec errorCode et guidez l'utilisateur pour reprendre.

Stockez le WABA ID et le Phone Number ID côté serveur. Vous en aurez besoin pour chaque appel API (envoi de message, création de template, gestion des webhooks).

Prévoyez un mécanisme de re-authentification. Les tokens Meta peuvent expirer ou être révoqués. Proposez à l'utilisateur de relancer le flux depuis votre dashboard.

Activez les webhooks dès le provisioning. Ne laissez pas le client envoyer des messages sans que vous receviez les accusés de livraison et les réponses. Un webhook mal configuré crée des angles morts opérationnels dès le premier envoi.

Étape	Responsabilité agence	Responsabilité client
Intégration SDK Meta JS	Agence	—
Clic sur le bouton signup	—	Client
Vérification Meta Business	—	Client
Échange de token	Agence (backend)	—
Configuration webhooks	Agence	—
Création des templates	Agence + Client	Validation contenu

Embedded signup et architecture multi-tenant

Si votre agence gère une plateforme multi-annonceurs (outil de gestion de campagnes, CRM propre, etc.), l'embedded signup s'inscrit naturellement dans une architecture multi-tenant. Chaque client obtient son propre WABA et son propre numéro. Vos messages sont envoyés via l'API Graph avec l'identifiant de numéro spécifique à chaque compte.

Whakup propose une couche d'abstraction multi-tenant clé en main : vous gérez N comptes depuis une seule intégration API, avec des webhooks centralisés et des logs par client. Cela évite de multiplier les intégrations Meta pour chaque annonceur. Consultez notre guide complet de l'API WhatsApp Business pour comprendre l'architecture globale avant d'attaquer l'embedded signup.

Sur la question du choix entre construire cette couche soi-même ou passer par un provider, notre article build vs buy sur l'API WhatsApp détaille les critères de décision pour les agences.

FAQ

L'embedded signup fonctionne-t-il avec des numéros de téléphone déjà utilisés sur WhatsApp ?

Oui, à condition de les migrer au préalable. Un numéro actif sur l'application WhatsApp classique doit d'abord être dissocié avant d'être enregistré sur l'API Business. Meta fournit un flux de migration dans l'embedded signup, mais prévoyez un temps de basculement pendant lequel le numéro est temporairement indisponible.

Faut-il que le client ait un compte Meta Business Manager vérifié ?

La vérification d'entreprise Meta est obligatoire pour débloquer les limites d'envoi au-delà du niveau 1 (250 conversations/24h). Pour les premières activations, un compte non vérifié peut suffire pour démarrer. Mais dès que le volume monte, la vérification devient bloquante. Accompagnez vos clients dans cette démarche dès le départ.

L'agence peut-elle gérer plusieurs numéros par client annonceur ?

Oui. Un WABA peut contenir plusieurs numéros de téléphone. Vous pouvez donc provisionner un numéro par marque, par ligne de service ou par pays pour un même annonceur. Chaque numéro est identifié par un Phone Number ID distinct dans l'API.

Que se passe-t-il si le client révoque l'accès depuis son Meta Business Manager ?

Vous recevez un webhook security de Meta indiquant la révocation. Votre système doit détecter cet événement et bloquer les envois correspondants, puis notifier l'agence ou le client pour relancer le flux d'authentification.

---

L'embedded signup est le socle de toute offre WhatsApp revendable par une agence. Sans lui, chaque activation est une opération manuelle. Avec lui, vous pouvez industrialiser l'onboarding et l'intégrer comme brique native de votre service. Whakup fournit l'embedded signup, le multi-tenant, les webhooks et l'hébergement EU/RGPD dans une seule API. Découvrez l'API WhatsApp Whakup et commencez à construire votre offre agence.