API WhatsApp et l'embedded signup : guide pour les plateformes de chatbot IA

L'embedded signup WhatsApp permet à vos clients d'activer leur numéro WhatsApp Business directement dans votre interface, sans redirection vers Meta. Pour les plateformes de chatbot IA, c'est le chaînon manquant entre la création du bot et son déploiement en production.

Ce qu'est réellement l'embedded signup WhatsApp

L'embedded signup est un flux OAuth fourni par Meta qui s'intègre dans votre application via un SDK JavaScript. Votre client :

1. Clique sur un bouton dans votre dashboard
2. S'authentifie avec son compte Facebook Business dans une popup
3. Crée ou connecte son compte WhatsApp Business Account (WABA)
4. Accepte les conditions Meta
5. Retourne sur votre plateforme — numéro activé, prêt à envoyer

Le tout prend 8 à 12 minutes en moyenne. Aucun allez-retour par email, aucun ticket support pour vérifier l'avancement.

Ce que vous récupérez à la fin : un waba_id et un phone_number_id que vous stockez côté client dans votre base multi-tenant. Votre chatbot IA peut immédiatement commencer à envoyer via l'API.

Prérequis techniques pour intégrer l'embedded signup dans une plateforme chatbot

Avant de toucher au code, vous devez être partenaire d'un Meta Tech Provider certifié. C'est lui qui détient la Meta App avec les permissions whatsapp_business_management et whatsapp_business_messaging. Sans ce statut, Meta n'autorise pas le flux d'embedded signup en marque blanche.

Ce que votre plateforme doit exposer :

• Un frontend capable de charger le SDK Facebook JS et d'ouvrir la popup OAuth
• Un backend pour recevoir le code d'autorisation renvoyé par Meta, l'échanger contre un token, puis appeler l'API Graph pour récupérer le WABA
• Un webhook pour écouter les événements account_update et détecter si un client révoque son accès

Structure minimale du flux backend :

Étape	Appel API	Ce que vous récupérez
Échange du code	POST /oauth/access_token	user access token
Liste des WABAs	GET /me/businesses	business_id
Numéros associés	GET /{waba_id}/phone_numbers	phone_number_id
Abonnement webhook	POST /{waba_id}/subscribed_apps	confirmation

Si vous passez par Whakup, ces étapes sont encapsulées dans leur API REST — vous n'avez pas à gérer directement les appels Graph Meta.

Intégrer l'embedded signup dans un flow chatbot IA : points de vigilance

L'embedded signup ne s'arrête pas au moment de l'activation. Pour une plateforme chatbot, plusieurs éléments conditionnent la fiabilité en production.

Gestion du multi-tenant. Chaque client de votre SaaS a son propre WABA. Stockez le couple (waba_id, phone_number_id) dans votre modèle de données client, jamais de manière globale. Un bug de résolution de numéro peut faire envoyer les messages d'un client A via le numéro d'un client B.

Renouvellement des tokens. Le token système que vous obtenez après l'embedded signup peut expirer. Implémentez un mécanisme de refresh ou utilisez un token système permanent généré côté BSP.

Vérification de l'état du numéro. Avant qu'un chatbot envoie le premier message, vérifiez que le numéro est au statut CONNECTED et non FLAGGED ou RESTRICTED. L'embedded signup ne garantit pas que le numéro est sain — un numéro récupéré d'une ancienne installation WhatsApp personnel peut nécessiter une migration.

Templates requis pour l'outbound. Votre chatbot IA ne peut initier une conversation qu'avec un template approuvé. L'embedded signup active le canal, il ne crée pas les templates. Prévoyez un second écran dans votre onboarding pour soumettre les premiers templates.

FAQ

L'embedded signup fonctionne-t-il avec tous les fournisseurs d'accès à l'API WhatsApp ?

Non. Seuls les Meta Tech Providers certifiés peuvent proposer l'embedded signup en marque blanche dans leur application. Les BSP qui ne sont pas Tech Providers vous redirigeront vers leur propre interface d'onboarding. Si vous construisez une plateforme SaaS chatbot, choisissez un partenaire qui vous donne accès à ce flux — c'est le cas de Whakup.

Mon client peut-il utiliser un numéro déjà enregistré sur WhatsApp personnel ?

Oui, mais Meta demande une validation par SMS ou appel vocal pour transférer le numéro. Le numéro perd son historique de conversations personnelles. C'est un point à communiquer clairement à vos clients avant qu'ils commencent l'embedded signup.

Combien de temps dure l'activation après l'embedded signup ?

Le numéro est généralement activé en moins d'une minute après la fin du flux. Dans de rares cas, la vérification du display name peut prendre 24 à 48 heures si Meta demande une revue manuelle.

Est-ce que l'embedded signup respecte le RGPD ?

L'embedded signup implique que votre client s'authentifie sur Facebook dans une popup. Vous ne récupérez que les identifiants WABA, pas de données personnelles supplémentaires. Les données de messagerie restent sur l'infrastructure de votre BSP — si celui-ci est hébergé en Europe, vous êtes couverts pour le RGPD.

---

L'embedded signup est la fondation de toute plateforme chatbot WhatsApp sérieuse. Sans lui, l'onboarding de chaque client devient un projet en soi. Avec lui, vous passez de la démo à la production en quelques minutes par client. Explorez comment l'API WhatsApp de Whakup expose ce flux nativement avec hébergement EU, multi-tenant et marque blanche intégrés. Pour aller plus loin, consultez notre guide complet de l'API WhatsApp Business et notre article sur l'onboarding simplifié par embedded signup.