L’inscription intégrée v2 sera obsolète à compter du 15 octobre 2026. Utilisez uniquement les configurations v4.
Architecture
Les assistants SMS de la plateforme sont SMS/MMS uniquement — pas WhatsApp. La voix par Trunk SIP sur un numéro marketplace est indépendante de l’API Cloud WhatsApp et des webhooks SMS.
Prérequis (plateforme)
- Portefeuille Meta Business avec vérification d’entreprise et 2FA
- Nouvelle application Meta de type Business (ne réutilisez pas une ancienne application)
- Produits : WhatsApp, Connexion Facebook pour les entreprises, Webhooks
- Accès avancé App Review :
whatsapp_business_management,whatsapp_business_messaging - Fournisseur technologique / Vérification d’accès (fait passer la limite hebdomadaire d’intégration de 10 à 200)
Liste de contrôle du tableau de bord de l’application Meta
1. Créer l’application
- Allez sur developers.facebook.com → Créer une application → sélectionnez le type Business
- Ne mettez pas « WhatsApp » dans le nom de l’application (règles de marque de Meta)
- Associez votre portefeuille Business vérifié
2. Connexion Facebook pour les entreprises
- Ouvrez Connexion Facebook pour les entreprises → Paramètres → Paramètres OAuth du client
- Activez : connexion OAuth du client, connexion OAuth Web, HTTPS obligatoire, connexion OAuth via navigateur intégré, mode strict, connexion avec le SDK JavaScript
- Domaines autorisés et URI de redirection OAuth valides : votre domaine de production et vos domaines de prévisualisation (HTTPS uniquement), par exemple
https://app.famulor.io
3. Configuration de l’inscription intégrée
- Connexion Facebook pour les entreprises → Configurations → Créer à partir d’un modèle
- Choisissez WhatsApp Embedded Signup Configuration With 60 Expiration Token
- Copiez l’ID de configuration →
META_EMBEDDED_SIGNUP_CONFIG_ID/NEXT_PUBLIC_META_EMBEDDED_SIGNUP_CONFIG_ID
4. Webhooks de l’application (callback de la plateforme)
- WhatsApp → Configuration → Webhook
- URL de callback :
https://app.famulor.io/api/webhooks/meta/whatsapp-platform - Jeton de vérification : même valeur que
META_WEBHOOK_VERIFY_TOKEN - Abonnez-vous au minimum à :
account_update,messages,calls,message_template_status_update
/api/webhooks/messaging/whatsapp/{connectorId} afin que le routage multi-tenant corresponde au reste des canaux de messagerie. Les champs qui ne prennent pas en charge ce remplacement (par exemple certains événements de compte ou de modèle) restent sur le callback de la plateforme.
5. Variables d’environnement
6. App Review et mode Live
- Tant que l’application est en mode Development, seuls les admins, développeurs et testeurs peuvent finaliser l’inscription intégrée
- Soumettez l’App Review pour les permissions WhatsApp, puis passez en mode Live
- Abonnez-vous à
account_updateavant d’intégrer de vrais clients
UX produit (espace de travail)
Paramètres → Canaux → WhatsApp- Choisissez un assistant
- Sélectionnez éventuellement un numéro marketplace (de préférence compatible SMS pour l’OTP Meta)
- Si un numéro marketplace est sélectionné, nous redirigeons temporairement son webhook SMS vers notre endpoint de capture OTP (la voix téléphone/SIP reste inchangée) et affichons l’OTP de Meta dans l’interface
- Cliquez sur Connect with Meta → complétez la fenêtre contextuelle
- Côté serveur : échange du code → jeton business → abonnement WABA → remplacement du webhook → enregistrement du numéro → création du connecteur (
onboarding_source=embedded_signup) - Demandez au client d’ajouter un moyen de paiement dans WhatsApp Manager avant tout envoi de messages à fort volume
Numéros marketplace + OTP
Acheter un numéro dans Paramètres → Numéros n’active jamais WhatsApp automatiquement.
API publique
GET /api/whatsapp/embedded-signup/config— IDs publics d’application/configuration + indicateur d’activationPOST /api/whatsapp/embedded-signup— finalise l’intégration (code,waba_id,phone_number_id,assistant_id, …)POST/GET/DELETE /api/whatsapp/otp-session— cycle de vie de la capture OTP marketplace- MCP :
complete_whatsapp_embedded_signup