API WhatsApp et l'embedded signup : guide pour les plateformes de fidélité

L'embedded signup WhatsApp est le mécanisme qui permet à une plateforme de fidélité d'intégrer directement le flux de connexion Meta dans son interface — sans rediriger le marchand vers le Business Manager. Résultat : le marchand crée ou relie son compte WhatsApp Business en quelques minutes, depuis votre tableau de bord. Pour les éditeurs de plateformes de fidélité, c'est la différence entre un taux d'activation élevé et un onboarding qui traîne.

Pourquoi l'embedded signup est critique pour une plateforme de fidélité

Une plateforme de fidélité repose sur la récurrence : des points, des offres, des rappels d'anniversaire. WhatsApp est le canal idéal pour délivrer ces messages, mais il faut d'abord que chaque enseigne connecte son numéro. Si ce processus est long ou technique, le taux d'activation s'effondre avant même le premier envoi.

L'embedded signup résout ce problème :

• Le marchand reste dans votre interface. Il ne quitte pas votre plateforme pour aller dans Meta.
• Vous collectez les permissions au bon endroit. Le marchand accorde les droits d'accès au compte WhatsApp Business directement dans votre tunnel.
• Le token d'accès est immédiatement disponible. Votre backend reçoit un code OAuth que vous échangez contre un token long-durée pour envoyer des messages.

Sans embedded signup, la séquence ressemble à : redirection externe, création de compte Meta, configuration du numéro, retour dans votre outil, saisie manuelle d'un token. Chaque étape est un point de sortie.

Les prérequis techniques côté API WhatsApp

Pour implémenter l'embedded signup, votre plateforme doit être adossée à un partenaire Meta reconnu. Whakup est Meta Tech Provider certifié : vos clients marchands bénéficient de l'embedded signup sans que vous ayez à passer votre propre certification Meta.

Concrètement, voici ce que cela implique côté code :

• Initialisation du SDK Facebook dans votre frontend (JavaScript).
• Scopes OAuth requis : whatsapp_business_management, whatsapp_business_messaging, business_management.
• Un endpoint backend pour recevoir le code et l'échanger contre un token via l'API Graph.
• Association du numéro au WABA (WhatsApp Business Account) créé pendant le flux.

La partie la plus sensible est la gestion du state anti-CSRF et le stockage sécurisé du token. Ces tokens donnent accès aux envois de messages : ils ne doivent pas être exposés côté client.

Pour aller plus loin sur la structure de l'API sous-jacente, consultez le guide complet de l'API WhatsApp Business.

Gérer le multi-tenant dans une plateforme de fidélité

Une plateforme de fidélité opère pour des dizaines ou des centaines d'enseignes. Chaque enseigne a son propre numéro WhatsApp, ses propres templates validés, son propre quality rating. L'architecture doit refléter cela.

Points clés à architecturer :

Élément	Par plateforme	Par enseigne (tenant)
App ID Meta	1	-
WABA	-	1 par enseigne
Numéro de téléphone	-	1 à N par enseigne
Templates HSM	-	Propre catalogue
Webhooks	Centralisé avec routing	-

Le routing de webhooks mérite une attention particulière : Meta envoie tous les événements (statuts de livraison, messages entrants, changements de qualité) vers une seule URL de callback déclarée au niveau de l'app. C'est votre plateforme qui doit router chaque événement vers le bon tenant.

Pour comprendre comment configurer ce routing, consultez notre article sur l'onboarding simplifié via embedded signup.

Ce que Whakup fournit pour simplifier l'intégration

Whakup expose une API REST et des webhooks qui abstraient la complexité de l'API Graph de Meta. Vous n'implémentez pas le flux OAuth depuis zéro : Whakup fournit les endpoints d'initialisation du flux et de récupération du token.

Ce que cela change pour votre équipe technique :

• Pas de gestion directe des tokens Meta. Whakup stocke et rafraîchit les tokens pour vous.
• Multi-numéros natif. Chaque enseigne peut avoir plusieurs numéros associés, gérable via l'API Whakup.
• Marque blanche. Le flux embedded signup peut être habillé aux couleurs de votre plateforme.
• Hébergement EU. Les données restent en Europe, ce qui simplifie la conformité RGPD pour vos clients marchands français.

Sur la tarification : Whakup facture 0,0088 €/message auquel s'ajoutent les frais Meta. Pour un message marketing envoyé à un numéro français, le coût total est d'environ 0,08 €/message (0,0088 € + 0,0712 € de frais Meta). Pour les messages de type utility (rappel de points, confirmation de récompense), le coût descend à environ 0,0336 €/message.

Découvrez comment intégrer l'API WhatsApp dans votre plateforme pour commencer à construire votre flux d'onboarding embedded signup.

FAQ

Le marchand doit-il avoir un compte Meta Business Manager avant de commencer ?

Non, le flux embedded signup peut créer un compte Meta Business à la volée pendant l'onboarding. Si le marchand en possède déjà un, le flux l'y relie automatiquement. C'est l'un des avantages du mécanisme : il s'adapte aux deux situations.

Peut-on personnaliser les étapes du flux embedded signup ?

Partiellement. Meta impose certaines étapes (vérification du numéro, acceptation des CGU) que vous ne pouvez pas supprimer. En revanche, vous pouvez personnaliser l'apparence du bouton d'entrée dans le flux, pré-remplir certains champs et encapsuler le tout dans une modale dans votre interface.

Que se passe-t-il si le marchand abandonne le flux à mi-parcours ?

Le WABA est créé de façon incrémentale. Si le marchand abandonne après la création du compte Business mais avant la vérification du numéro, vous aurez un WABA sans numéro actif. Votre plateforme doit détecter cet état via l'API et relancer le marchand pour finaliser la configuration.

L'embedded signup fonctionne-t-il pour migrer un numéro existant déjà utilisé sur WhatsApp personnel ?

Oui, à condition que le marchand accepte de dissocier le numéro de son compte WhatsApp personnel. Meta le guide dans cette étape pendant le flux. Notez que la migration supprime l'historique des conversations existantes.