Comment fonctionne WhatsApp Embedded Signup ?

Embedded Signup est un flux Meta affiché dans l'expérience d'intégration d'un fournisseur. Il permet à votre entreprise d'autoriser la configuration du compte et du numéro sans communiquer vos identifiants Meta personnels au fournisseur.

Qui doit lancer Embedded Signup ?

Utilisez le compte Meta du propriétaire du portefeuille professionnel ou d'un administrateur autorisé à gérer ses actifs WhatsApp. La personne qui complète le flux approuve ce que le fournisseur peut connecter.

Gardez l'administrateur maître du compte Meta. Demander à un fournisseur d'usurper l'identité de cet administrateur risque de faire perdre le contrôle des actifs et des permissions. Le propriétaire de l'entreprise doit vérifier les actifs, les permissions et les conditions dans la boîte de dialogue Meta avant de confirmer.

Quels actifs le flux connecte-t-il ?

Le flux peut connecter un portefeuille professionnel Meta, un WhatsApp Business Account et un numéro de téléphone à l'intégration du fournisseur. Les choix proposés dépendent de la création d'un nouveau compte ou de la sélection d'un compte existant.

Le fournisseur peut exploiter les actifs connectés. Votre entreprise reste responsable des politiques du compte, du consentement des clients et du contenu des messages. Consultez la politique WhatsApp Business de Meta avant d'autoriser l'accès.

Que se passe-t-il pendant le flux ?

Le fournisseur ouvre la boîte de dialogue Embedded Signup de Meta dans son tableau de bord. Vous vous connectez, choisissez ou créez les actifs professionnels, fournissez les informations commerciales demandées et autorisez la connexion au fournisseur.

La vérification du numéro de téléphone peut être une étape distincte. Suivez les vérifications de numéro dans le guide de numéro WhatsApp de Bird avant de commencer si vous n'êtes pas sûr que le numéro candidat puisse être connecté.

Qu'est-ce qui reste incomplet après la fermeture de la boîte de dialogue ?

À la fermeture de la boîte de dialogue, la vérification, la connexion et l'envoi peuvent encore être incomplets. Le flux du navigateur est terminé, mais Meta peut encore traiter les actifs.

L'opération de finalisation de Bird fonctionne uniquement dans le tableau de bord. Une requête backend ne peut pas reproduire le consentement et la sélection d'actifs de l'administrateur : ne construisez donc pas d'intégration API publique autour de cette opération.

Dans Bird, consultez les champs status, next et finish_setup_url du numéro connecté. status est un enum ouvert. Il inclut awaiting_signup, banned, connected, deleted, disconnected, failed, flagged, migrated, pending, preparing, rate_limited et restricted ; acceptez toute valeur non reconnue. Le champ distinct error explique pourquoi la connexion a échoué la dernière fois. next indique la prochaine action tant que la connexion est incomplète. Lorsque l'inscription attend une étape dans le navigateur, finish_setup_url apparaît uniquement pour awaiting_signup ; l'ouvrir complète le flux du tableau de bord, car l'étape ne peut pas s'exécuter via le API. Interrogez la ressource après avoir complété le flux au lieu de considérer la redirection comme un test d'envoi réussi.

Les états signalé, restreint et banni peuvent affecter l'accès à l'envoi d'un numéro connecté.

Comment vérifier que tout est prêt pour l'inscription ?

Avant le flux, confirmez :

1. L'administrateur peut accéder au bon portefeuille professionnel Meta.
2. Les informations commerciales et la propriété du compte sont prêtes à être vérifiées.
3. Le numéro de téléphone est disponible pour ce chemin de connexion.
4. L'espace de travail du fournisseur est celui qui doit recevoir le compte.

Après le flux, confirmez le compte, le statut du numéro, le résultat de la vérification et un véritable envoi de test. Conservez les coordonnées du propriétaire du compte Meta et du contact support du fournisseur en cas de récupération.