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

L'embedded signup WhatsApp est le mécanisme officiel de Meta qui permet à un utilisateur de connecter son compte WhatsApp Business à une plateforme tierce directement depuis l'interface de cette plateforme, sans jamais quitter l'environnement du fournisseur. Pour une plateforme emailing qui veut ajouter WhatsApp à son portefeuille de canaux, c'est le point d'entrée incontournable.

Ce que fait concrètement l'embedded signup

L'embedded signup ouvre une fenêtre popup Meta (via un SDK JavaScript ou un lien OAuth) dans laquelle le client de la plateforme :

1. Se connecte à son compte Meta Business.
2. Crée ou sélectionne un compte WhatsApp Business Account (WABA).
3. Ajoute et vérifie son numéro de téléphone dédié.
4. Accepte les conditions d'utilisation de l'API WhatsApp Business.

À l'issue du flux, la plateforme reçoit un code d'autorisation OAuth qu'elle échange contre un token d'accès. Ce token lui permet d'appeler l'API Cloud de Meta au nom du client, sans que ce dernier ait eu besoin de créer un compte développeur Meta ou de passer une quelconque certification.

Ce que cela signifie pour une plateforme emailing : l'activation WhatsApp d'un nouveau client peut descendre à moins de cinq minutes, contre plusieurs semaines lorsque le processus était entièrement manuel.

Les prérequis techniques côté plateforme

Avant d'implémenter l'embedded signup, plusieurs conditions doivent être remplies :

• Être partenaire d'un BSP ou Meta Tech Provider certifié. C'est lui qui détient les droits d'implémentation de l'embedded signup et qui porte la relation contractuelle avec Meta. En passant par Whakup, votre plateforme hérite directement de ce statut sans démarche Meta supplémentaire.
• Disposer d'une app Meta Business vérifiée. L'app doit avoir les permissions whatsapp_business_management et whatsapp_business_messaging approuvées.
• Implémenter le SDK JavaScript de Meta (ou l'URL OAuth) dans votre frontend pour déclencher la popup.
• Exposer un endpoint backend pour recevoir et stocker le token d'accès retourné par Meta.

Étape	Responsabilité	Complexité
App Meta vérifiée	BSP / Tech Provider	Déjà faite si via Whakup
Intégration SDK JS	Plateforme emailing	Faible (quelques heures)
Échange code OAuth	Plateforme emailing	Faible (appel API)
Stockage token	Plateforme emailing	Standard
Gestion multi-tenant	Plateforme emailing	Moyenne

Gestion multi-tenant : un token par client

C'est le point architectural le plus critique pour une plateforme emailing. Chaque client dispose de son propre WABA et de son propre token d'accès. Votre plateforme doit donc :

• Stocker les tokens de manière isolée par tenant, avec chiffrement au repos.
• Rafraîchir les tokens avant expiration (les tokens système n'expirent pas, mais les tokens utilisateurs ont une durée de vie limitée).
• Gérer les révocations : si un client déconnecte son compte Meta, le token devient invalide et vous devez déclencher un re-signup.
• Propager les webhooks Meta vers le bon tenant, en utilisant le waba_id ou le phone_number_id comme clé de routage.

Une architecture propre sépare la couche d'authentification OAuth (tokens Meta) de la couche métier (envoi de messages). Cela facilite les rotations de tokens sans impacter les campagnes en cours.

Embedded signup et expérience utilisateur dans l'interface emailing

L'intégration doit être invisible pour le client final. Quelques bonnes pratiques :

• Placez le bouton d'activation WhatsApp dans les paramètres de compte ou dans l'assistant d'ajout de canal, pas dans un menu technique.
• Guidez l'utilisateur avant la popup : expliquez en deux phrases ce qu'il va devoir faire (connecter son compte Meta, vérifier un numéro). La popup Meta est en anglais par défaut ; prévenir évite les abandons.
• Confirmez l'activation avec un écran de succès affichant le numéro connecté et le statut du display name.
• Gérez les erreurs gracieusement : si l'utilisateur ferme la popup sans terminer, proposez une reprise directe sans forcer un nouveau parcours complet.

La fluidité du signup influe directement sur le taux d'activation du canal WhatsApp dans votre base. Un flow mal conçu coûte des clients actifs.

FAQ

L'embedded signup fonctionne-t-il si mon client a déjà un compte WhatsApp Business App ?

Oui, mais avec une contrainte : un numéro de téléphone ne peut être enregistré que sur un seul type de compte à la fois (App ou API). Si le client utilise déjà l'application WhatsApp Business sur ce numéro, il doit d'abord supprimer ce compte ou utiliser un numéro différent pour l'API. Le flux embedded signup gère cette vérification automatiquement.

Doit-on passer par un Meta Tech Provider pour implémenter l'embedded signup ?

Oui. L'accès à l'embedded signup nécessite d'être un Solution Partner ou Tech Provider Meta reconnu, ou de passer par l'un d'eux. Whakup, en tant que Meta Tech Provider certifié, met ce mécanisme à disposition de ses partenaires plateformes directement via son API REST, sans que la plateforme ait à négocier son propre accord avec Meta.

Combien de temps prend la vérification du numéro dans le flux embedded signup ?

La vérification se fait par SMS ou appel vocal. Elle prend en général moins de deux minutes. Le code à six chiffres a une durée de validité limitée (dix minutes), ce qui implique que l'utilisateur doit être disponible au moment du signup.

Peut-on automatiser l'embedded signup pour des onboardings en masse ?

Non. L'embedded signup est un flux interactif qui nécessite une action humaine : connexion au compte Meta et vérification du numéro. Il n'est pas automatisable. En revanche, une fois le token récupéré, toutes les opérations suivantes (envoi de messages, gestion de templates, configuration de webhooks) sont entièrement automatisables via l'API.

---

Intégrer l'embedded signup WhatsApp dans votre plateforme emailing est la première étape pour offrir WhatsApp comme canal natif à vos clients. Whakup fournit l'infrastructure BSP, la documentation d'intégration et le support technique pour accélérer ce déploiement. Consultez notre page dédiée à l'API WhatsApp Business pour démarrer, ou approfondissez les aspects techniques dans notre guide complet de l'API WhatsApp Business et notre article sur l'embedded signup et l'onboarding simplifié.