API WhatsApp et l'embedded signup : guide pour les plateformes SMS

L'embedded signup WhatsApp est le mécanisme officiel par lequel un éditeur tiers — une plateforme SMS, par exemple — peut connecter les comptes WhatsApp Business de ses clients directement dans son interface. Sans redirection vers Meta Business Manager, sans formation préalable, sans friction. C'est la brique d'onboarding qui conditionne le time-to-value de votre canal WhatsApp.

Pourquoi l'embedded signup change tout pour les plateformes SMS

Avant l'embedded signup, ajouter WhatsApp à une plateforme SMS nécessitait que chaque client crée son propre compte Meta Business, configure manuellement son numéro de téléphone et accepte les CGU WhatsApp — le tout hors de votre interface.

Résultat : taux d'abandon élevé, support surchargé, délai d'activation de plusieurs jours.

L'embedded signup résout ce problème en intégrant le flux d'autorisation Meta directement dans votre produit sous forme d'une popup ou d'un iframe. Votre client :

• Se connecte à son compte Facebook/Meta
• Crée ou sélectionne son compte WhatsApp Business
• Associe son numéro de téléphone
• Accepte les CGU Meta

Le tout en moins de 5 minutes, sans jamais quitter votre plateforme.

Ce qu'il faut pour accéder à l'embedded signup

L'embedded signup n'est pas accessible à n'importe quelle application Meta. Pour l'implémenter, vous avez besoin :

1. D'une application Meta approuvée avec les permissions whatsapp_business_management et whatsapp_business_messaging
2. Du statut de Tech Provider auprès de Meta (ou d'un partenariat avec un Meta Tech Provider certifié)
3. D'une intégration OAuth capable de récupérer le token d'accès retourné par le flux d'autorisation

C'est là que le chemin se divise. Obtenir le statut Tech Provider directement implique un processus de vérification Meta qui prend plusieurs semaines et nécessite de démontrer une base clients existante. La plupart des plateformes SMS choisissent plutôt de passer par un Meta Tech Provider certifié comme Whakup, qui met à disposition l'embedded signup sans que vous ayez à passer la certification vous-même.

Approche	Délai d'activation	Maintenance Meta	Flexibilité
Certification Meta directe	4 à 8 semaines	À votre charge	Totale
Via Meta Tech Provider	24 à 72 h	Prise en charge	Très large

Intégration technique : les étapes clés

Une fois l'accès obtenu, l'intégration suit un schéma précis. Voici les étapes pour une plateforme SMS :

1. Initialisation du SDK Meta

Chargez le SDK JavaScript Meta et configurez votre appId. C'est le point d'entrée du flux.

2. Déclenchement du popup

Un bouton "Connecter WhatsApp" sur votre interface ouvre le flux embedded signup. Meta gère l'authentification et la sélection du compte Business.

3. Récupération du code d'échange

À la fin du flux, Meta retourne un code via le callback onMessage. Échangez ce code contre un token d'accès système via un appel serveur à l'API Graph.

4. Provisioning du numéro

Avec le token d'accès, récupérez le waba_id (WhatsApp Business Account ID) et enregistrez le numéro de téléphone via l'endpoint /phone_numbers/register.

5. Webhook et mise en production

Configurez les webhooks entrants pour recevoir les accusés de lecture, les réponses et les statuts de livraison. Le numéro est prêt à envoyer ses premiers messages.

Chez Whakup, l'embedded signup est fourni clé en main avec documentation d'intégration, sandbox de test et support technique dédié — ce qui réduit le délai d'intégration à quelques jours pour une équipe dev standard.

Multi-tenant : gérer plusieurs clients depuis une seule intégration

Le cas d'usage natif des plateformes SMS est le multi-tenant : des dizaines ou centaines de clients, chacun avec son propre numéro WhatsApp Business, géré depuis votre infrastructure.

L'architecture recommandée :

• Un seul appId Meta pour toute votre plateforme
• Un waba_id distinct par client récupéré lors de l'embedded signup
• Des tokens d'accès système par client stockés côté plateforme
• Une gestion centralisée des webhooks avec routage par waba_id

Cette approche vous permet de gérer l'ensemble du parc clients depuis une seule intégration API, tout en maintenant une isolation stricte des données et des droits d'accès. Whakup supporte nativement cette architecture multi-numéros/multi-tenant, avec une gestion marque blanche pour que vos clients ne voient jamais l'infrastructure sous-jacente.

Pour aller plus loin sur la tarification associée à chaque compte activé, consultez notre guide sur le prix de l'API WhatsApp Business en 2026.

FAQ

L'embedded signup WhatsApp fonctionne-t-il pour les numéros déjà utilisés sur WhatsApp personnel ?

Non. Un numéro de téléphone ne peut pas être simultanément associé à un compte WhatsApp personnel et à l'API WhatsApp Business. Si votre client utilise déjà ce numéro sur WhatsApp, il devra le migrer ou choisir un numéro dédié.

Peut-on personnaliser l'apparence du flux embedded signup ?

Partiellement. La popup Meta est standardisée et ne peut pas être reskinée. En revanche, le bouton déclencheur et les écrans avant/après le flux sont entièrement dans votre main et peuvent respecter votre charte graphique.

Combien de temps prend la vérification du compte Business lors de l'embedded signup ?

Dans la majorité des cas, la vérification s'effectue en quelques minutes. Pour certains comptes Business Meta nécessitant une vérification manuelle (entreprises non vérifiées), le délai peut s'étendre à 24-48 h.

Faut-il renouveler les tokens d'accès récupérés via l'embedded signup ?

Les tokens système générés ne s'expirent pas automatiquement, mais ils peuvent être révoqués si le client déconnecte votre application de son compte Meta. Il est recommandé d'implémenter une gestion d'erreur 190 (token invalide) pour déclencher un re-consentement.

---

L'embedded signup est la porte d'entrée de votre offre WhatsApp. Bien intégré, il transforme un onboarding complexe en une expérience de quelques clics pour vos clients. Whakup, en tant que Meta Tech Provider certifié, vous donne accès à cette brique sans les délais de la certification directe. Découvrez l'offre complète sur notre page API WhatsApp Business et consultez notre guide complet de l'API WhatsApp Business pour approfondir chaque aspect de l'intégration.