API WhatsApp et l'embedded signup : guide pour les CRM

L'embedded signup WhatsApp est le mécanisme officiel de Meta qui permet à vos clients de connecter leur compte WhatsApp Business directement depuis votre interface CRM, sans quitter votre plateforme. Pour les éditeurs de CRM qui intègrent l'API WhatsApp Business, c'est le point d'entrée incontournable : sans lui, chaque nouveau client doit traverser le Business Manager de Meta seul, avec un taux d'abandon élevé.

Ce qu'est réellement l'embedded signup

L'embedded signup est un flux OAuth hébergé par Meta, déclenché depuis votre application via un SDK JavaScript. Il permet à un utilisateur de :

• Se connecter à son compte Facebook Business
• Vérifier ou créer son compte WhatsApp Business (WABA)
• Sélectionner ou enregistrer un numéro de téléphone
• Accepter les conditions Meta et déléguer l'accès à votre application

À l'issue du flux, vous récupérez un code d'autorisation que vous échangez côté serveur contre un token d'accès système. Ce token vous donne le contrôle programmatique sur le WABA du client — envoi de messages, gestion des templates, consultation des métriques.

Le flux dure en moyenne 3 à 5 minutes pour un utilisateur qui a déjà un compte Facebook Business vérifié.

Prérequis techniques pour les CRM

Avant d'implémenter l'embedded signup, votre application doit satisfaire plusieurs conditions côté Meta :

Prérequis	Détail
App Meta vérifiée	Votre app Facebook doit être approuvée pour l'usage whatsapp_business_management
Partenaire BSP ou Tech Provider	Vous devez opérer sous l'ombrelle d'un Meta Tech Provider certifié
HTTPS obligatoire	Le domaine appelant doit être en HTTPS et déclaré dans les origines autorisées
SDK JS Meta	Inclusion du SDK https://connect.facebook.net/fr_FR/sdk.js
Webhook configuré	Un endpoint de réception des événements doit être actif avant le premier signup

Passer par un Meta Tech Provider certifié comme Whakup simplifie considérablement ces prérequis : votre CRM hérite de la certification Meta, ce qui évite le processus de vérification d'app qui peut prendre plusieurs semaines.

Implémenter le flux dans votre CRM : étapes clés

1. Initialiser le SDK et déclencher le popup

FB.init({ appId: 'VOTRE_APP_ID', version: 'v20.0' });

FB.login(function(response) {
  if (response.authResponse?.code) {
    exchangeCodeForToken(response.authResponse.code);
  }
}, {
  config_id: 'VOTRE_CONFIG_ID',
  response_type: 'code',
  override_default_response_type: true,
  extras: { sessionInfoVersion: 3 }
});

2. Échanger le code contre un token système

Côté serveur, appelez l'endpoint Meta avec le code reçu et vos credentials d'app. Stockez le System User Token de façon sécurisée : il est lié au WABA du client et doit être chiffré au repos.

3. Associer le WABA à votre tenant CRM

Une fois le token obtenu, récupérez les informations du WABA via l'API Graph (GET /me/businesses) et créez l'association dans votre modèle de données multi-tenant. Chaque client CRM correspond à un WABA distinct avec ses propres numéros et templates.

4. Gérer les cas d'échec

• Token expiré : les tokens système liés à un embedded signup peuvent expirer. Implémentez un mécanisme de re-signup silencieux ou notifiez l'utilisateur.
• Numéro déjà enregistré ailleurs : Meta retourne une erreur spécifique (#2388). Prévoyez un message d'aide explicite dans votre UI.
• Vérification du numéro en attente : l'utilisateur doit recevoir un SMS ou un appel vocal pour valider son numéro. Informez-le depuis votre interface.

UX recommandée pour maximiser le taux de complétion

L'embedded signup est une étape critique de votre onboarding. Quelques règles pratiques :

• Contextualisez avant de déclencher : expliquez en 2 lignes ce qui va se passer. "Vous allez connecter votre compte WhatsApp Business en 3 minutes."
• Affichez la progression : le popup Meta est opaque pour l'utilisateur. Montrez un loader ou un message d'attente dans votre UI pendant que le flux est ouvert.
• Récapitulez après succès : affichez immédiatement le numéro connecté, le nom du WABA et l'état de vérification du compte.
• Prévenez les blockers courants : lien direct vers la documentation de vérification Meta si le compte Business n'est pas vérifié, message clair si l'utilisateur ne dispose pas des droits d'admin sur le Business Manager.

Les CRM qui intègrent ces éléments d'UX observent des taux de complétion de l'ordre de 70-80%, contre 30-40% pour un lien externe vers le Business Manager.

FAQ

L'embedded signup fonctionne-t-il pour tous les types de numéros WhatsApp ?

L'embedded signup supporte les numéros de téléphone fixe et mobile, à condition qu'ils ne soient pas déjà enregistrés sur un compte WhatsApp personnel actif. Les numéros déjà associés à un compte WhatsApp doivent d'abord être migrés ou libérés. Meta propose un processus de migration guidé, mais il ajoute une étape dans le flux.

Faut-il être Meta Tech Provider pour utiliser l'embedded signup ?

Techniquement, un partenaire BSP standard peut aussi utiliser l'embedded signup. Mais le statut de Meta Tech Provider certifié — comme Whakup — offre des avantages concrets : accès à des configurations avancées, meilleur support Meta, et possibilité de proposer cette intégration à vos propres clients en marque blanche sans que chacun d'eux passe sa propre vérification d'app.

Le token récupéré via embedded signup a-t-il une durée de vie ?

Les tokens système générés via embedded signup n'expirent pas par défaut, contrairement aux tokens utilisateur classiques. Cependant, ils peuvent être révoqués si l'utilisateur retire les permissions depuis son Business Manager Meta. Implémentez un webhook sur l'événement ACCOUNT_UPDATE pour détecter ces révocations.

Peut-on tester l'embedded signup sans compte Meta Business vérifié ?

Oui, Meta propose un environnement de test (sandbox) accessible depuis le tableau de bord développeur. Il simule le flux complet avec des comptes de test. En revanche, pour passer en production, le compte Business du client final doit être vérifié par Meta — ce qui peut prendre 1 à 5 jours ouvrés.

---

L'embedded signup est la première brique d'une intégration WhatsApp réussie dans votre CRM. Bien implémenté, il réduit le time-to-value pour vos clients à moins d'une heure. Mal implémenté, il devient le principal point de friction de votre onboarding.

Whakup, Meta Tech Provider certifié, fournit aux éditeurs de CRM une API WhatsApp Business clé en main avec embedded signup intégré, multi-tenant natif et support technique dédié. Consultez aussi notre guide complet de l'API WhatsApp Business et notre analyse build vs buy pour l'API WhatsApp pour cadrer votre décision d'architecture.