Premiers pas
Ce document décrit les étapes et les conditions requises pour intégrer le flux d’inscription intégrée dans votre site web ou votre portail client·e.
Avant de commencer
Pour commencer l’intégration du flux d’inscription intégrée, vous devez avant tout disposer d’un compte Business Manager et d’une application Meta configurés.
Business Manager
Vous aurez besoin d’un compte Business Manager pour gérer votre ligne de crédit et les comptes WhatsApp Business des client·es intégré·es. Pour plus d’informations sur la création d’un compte business, consultez la page Créer un compte Business Manager. Une fois que votre compte Business Manager est créé, vérifiez votre entreprise.
Application Meta
À partir de votre compte de développeur ou développeuse Meta, créez une application de type Entreprise. Dans le Panneau d’applications, vous avez accès à toutes vos applications Meta et pouvez contrôler leurs paramètres et demander des autorisations.
Les applications Entreprise sont automatiquement approuvées pour l’Accès standard à toutes les autorisations et fonctionnalités disponibles pour ce type d’application. Par conséquent, vous pouvez développer et tester votre application avec ce niveau d’accès.
L’accès standard restreint efficacement l’accès des applications Business aux seules données détenues par les utilisateurs et utilisatrices de l’application qui disposent d’un rôle dans celle-ci ou dans l’entreprise. Pour pouvoir être publiée, votre application Meta doit passer le Contrôle app et demander l’accès Avancé à l’autorisation whatsapp_business_management. Nous vous recommandons de lancer ce processus le plus tôt possible. Vous pouvez lancer ce processus avant d’avoir entièrement implémenté l’inscription intégrée.
Vous devrez aussi demander l’autorisation whatsapp_business_messaging pour l’API WhatsApp Cloud, car elle est requise pour les appels d’API.
Nous vous recommandons vivement de ne pas demander d’autres autorisations que celles-ci, car cela pourrait ralentir inutilement le processus d’inscription.
Tokens d’accès
Vous pouvez accéder aux données des client·es intégré·es avec les tokens d’accès utilisateur·ice système d’intégration professionnelle ou avec des tokens d’accès utilisateur·ice système. Le type de token à utiliser diffère selon que vous configurez l’inscription intégrée avec Facebook Login ou avec Facebook Login for Business, et selon que vous êtes un fournisseur de technologies ou un fournisseur de solutions.
Fournisseurs de technologies
Les fournisseurs de technologies préfèrent utiliser un token d’accès utilisateur·ice système d’intégration professionnelle, car ces tokens sont spécifiques aux client·es individuel·les. Vous pouvez obtenir l’un de ces tokens en échangeant le code qui vous est renvoyé chaque fois qu’un client ou une cliente valide l’inscription intégrée configurée avec Facebook Login for Business. Si vous utilisez l’inscription intégrée configurée avec Facebook Login (non recommandé), vous devez utiliser un token d’accès utilisateur·ice système à la place.
Si vous utilisez un token d’accès utilisateur·ice système, l’utilisateur·ice système doit accorder à votre application l’autorisation whatsapp_business_management.
Partenaires de solutions
Vous devez utiliser un token d’accès utilisateur·ice système pour partager votre ligne de crédit avec les client·es intégré·es. Pour toutes les autres requêtes, la solution privilégiée est d’utiliser un jeton d’accès utilisateur·ice système d’intégration professionnelle.
Vous pouvez obtenir un token d’accès utilisateur·ice système d’intégration professionnelle en échangeant le code renvoyé lorsqu’un client ou une cliente valide l’inscription intégrée configurée avec Facebook Login for Business. Si vous utilisez l’inscription intégrée configurée avec Facebook Login (non recommandé), vous devez utiliser un token d’accès utilisateur·ice système à la place.
Notez que pour les tokens d’accès utilisateur·ice système, votre utilisateur·ice système doit avoir accordé à votre application l’autorisation whatsapp_business_management (que vous pouvez accorder lors de la génération du token), et l’utilisateur·ice système doit disposer du rôle Éditeur financier afin de pouvoir partager votre ligne de crédit avec les client·es intégré·es.
Pour attribuer à votre utilisateur·ice système le rôle Éditeur financier :
- Connectez-vous à Meta Business Suite.
- Repérez votre compte business dans le menu déroulant en haut à gauche et cliquez sur son icône Paramètres (engrenage).
- Cliquez sur Paramètres de l’entreprise.
- Sélectionnez Utilisateur·ices > Utilisateur·ice système.
- Modifiez l’utilisateur·ice et accordez-lui le rôle Éditeur financier.
Ligne de crédit
Vous devez établir une ligne de crédit pour envoyer des messages avec la plateforme WhatsApp Business. Il s’agit de la ligne de crédit que vous partagerez avec vos clients et clientes, alors assurez-vous d’accepter les conditions générales de l’API Credit Allocation sous Paramètres de l’entreprise > Paiements dans Business Manager.
Pour plus d’informations sur le partage de votre ligne de crédit via Business Manager, plutôt que via l’API, consultez la page Partager l’accès à la facturation mensuelle.
Client de l’API WhatsApp Business On-Premises
Si vous utilisez l’API On-Premises, vérifiez que vous exécutez une version non expirée du client de l’API WhatsApp Business.
Processus d’intégration
Dans le cadre du processus d’intégration, votre application Meta doit passer le Contrôle app et demander l’accès Avancé à l’autorisation whatsapp_business_management. Nous vous recommandons de lancer ce processus le plus tôt possible. Vous pouvez lancer ce processus avant d’avoir entièrement implémenté l’inscription intégrée.
1. Intégrer le flux d’inscription
Configurez le SDK JavaScript de Facebook et Facebook Login de manière à intégrer le flux d’inscription dans votre site web ou votre portail client·e. N’hésitez pas à intégrer le flux sur plusieurs pages web ou portails vous appartenant.
2. Intégrer les points de terminaison requis
Une fois que le flux d’inscription est intégré, intégrez également les points de terminaison de l’API nécessaires pour terminer le processus d’intégration. Avant de passer à l’étape suivante, vous devez être en mesure d’effectuer les actions suivantes :
Une fois l’enregistrement terminé, utilisez le point de terminaison message_templates pour obtenir les modèles de messages pré-approuvés et les espaces de noms qui permettront aux entreprises d’envoyer des messages.
Vous devez utiliser un point de terminaison sécurisé (HTTPS). Pour plus d’informations, consultez la page Sécurité de la connexion.
3. S’abonner aux comptes WhatsApp Business pour recevoir les webhooks
Une fois que les entreprises ont terminé l’enregistrement, vous pouvez vous abonner à chaque compte WhatsApp Business dont vous souhaitez recevoir les webhooks. Vous pouvez configurer les webhooks de manière à être averti dans les cas suivants :
- Le nom associé à un numéro de téléphone est modifié.
- Le statut de qualité d’un numéro de téléphone est modifié.
- Un compte a été examiné, mis à niveau ou banni.
Facultatif
Vous pouvez effectuer les actions suivantes, si vous le souhaitez :