Nous déployons une modification qui permettra d’autoriser l’accès partagé à l’API dans le processus d’inscription intégrée lors de l’enregistrement du token. En cas de problèmes ou de conséquences inattendues dans le processus d’inscription intégrée, contactez l’assistance.

Inscription intégrée

L’inscription intégrée est une interface d’authentification et d’autorisation compatible avec les ordinateurs de bureau et les mobiles. Elle permet à vos clients professionnels de générer facilement les éléments dont vous aurez besoin pour les intégrer sur la plateforme WhatsApp Business.

Une erreur s’est produite
Nous rencontrons des difficultés pour lire cette vidéo.

Le processus d’inscription intégrée rassemble des informations de vos clients, génère automatiquement tous les éléments WhatsApp dont a besoin la plateforme et donne à votre application l’accès à ces derniers, afin que vous puissiez rapidement mettre les services de messagerie WhatsApp à la disposition de votre clientèle.

La clientèle intégrée via l’inscription intégrée possède tous ses éléments WhatsApp et peut les utiliser avec d’autres solutions Meta telles que des publicités clic vers WhatsApp.

Fonctionnement

L’inscription intégrée tire parti du produit Facebook Login for Business et de notre SDK JavaScript. Une fois qu’elle a été configurée, vous pouvez ajouter un lien ou un bouton à votre site Web ou votre portail qui lance le flux.

Lorsque les clients cliquent sur le lien ou le bouton, une nouvelle fenêtre s’affiche. Cette dernière leur permet :

  • de s’authentifier à l’aide de leurs identifiants d’entreprise Meta ou Facebook
  • d’accorder à votre application un accès à leurs éléments WhatsApp
  • de sélectionner un portefeuille business existant ou d’en créer un
  • de sélectionner un compte WhatsApp Business ou d’en créer un
  • de saisir et de vérifier leur numéro de téléphone professionnel (le leur ou celui que vous leur avez fourni)
  • de saisir un nom à l’écran qui peut apparaître à la place de leur numéro dans le client WhatsApp

Une fois effectuée avec succès, l’inscription intégrée retourne l’ID du compte WhatsApp Business du client, l’ID du numéro de téléphone professionnel et un code token échangeable dans la fenêtre qui a engendré le flux. Vous devez envoyer ces données à votre serveur et les utiliser dans un appel serveur à serveur pour :

  • remplacer le code par un token d’entreprise client
  • enregistrer le numéro de téléphone professionnel du client pour l’utilisation de l’API Cloud
  • abonner votre application aux webhooks sur le compte WhatsApp Business du client
  • partager votre ligne de crédit avec le client (partenaires de solutions uniquement)

Lorsque ces étapes sont terminées, si vous êtes un partenaire de solutions ou en partenariat avec l’un d’entre eux, le client peut tout de suite commencer à utiliser votre application ou celle de votre partenaire pour envoyer des messages. Si vous n’êtes pas un partenaire de solutions, ou si vous n’êtes pas associé avec l’un d’eux, le client doit d’abord joindre un moyen de paiement à son compte WhatsApp Business avant de pouvoir commencer à envoyer des messages.

Limites

Limites d’intégration

Par défaut, vous pouvez intégrer jusqu’à 10 nouveaux clients professionnels par période de 7 jours. Seuls les nouveaux clients sont pris en compte dans cette limite. Pour vérifier vos limites d’intégration actuelles, accédez à Gestionnaire WhatsApp > panneau Vue d’ensemble des partenaires. Vous recevrez une notification par e-mail si vous approchez de cette limite.

Si vous effectuez la vérification de l’entreprise, le Contrôle app et la vérification de l’accès, nous augmentons automatiquement votre limite à 200 nouveaux clients professionnels dans une fenêtre de 7 jours. S’il vous faut intégrer plus de 200 clients chaque semaine, demandez à faire partie de nos partenaires Meta Business.

Limites de messages des clients professionnels

Les clients professionnels intégrés via l’inscription intégrée commencent avec des limites de messages standard, susceptibles d’être augmentées s’ils utilisent l’API.

Limites appliquées aux numéros de téléphone professionnels

  • Les numéros de téléphone professionnels ne peuvent être enregistrés qu’à des fins d’utilisation avec l’API Cloud.
  • Les numéros de téléphone professionnels déjà enregistrés pour être utilisés avec l’API On-Premises, ou utilisés avec WhatsApp ou WhatsApp Business, ne sont pas pris en charge.
  • Des limites de numéros de téléphone professionnels par défaut sont appliquées aux clients intégrés via l’inscription intégrée.

Flux par défaut

Voir Flux par défaut pour découvrir les descriptions de chaque écran que votre clientèle professionnelle rencontrera lors de l’implémentation par défaut de l’inscription intégrée.

Il est à noter que si vous connaissez des informations sur l’activité de votre clientèle, vous pouvez injecter ces données, ce qui peut réduire considérablement le nombre d’écrans que votre clientèle aura à gérer.

Tokens d’accès

L’inscription intégrée génère des tokens d’accès utilisateur·ice du système d’intégration professionnelle (« tokens d’entreprise »). À la fin du processus d’inscription intégrée, un code token échangeable est retourné sous forme d’évènement de message et capturé par le SDK JavaScript. Vous devez ensuite échanger ce code contre un token d’entreprise en effectuant un appel de serveur à serveur.

Si vous êtes un fournisseur de technologies, vous utiliserez exclusivement des tokens d’entreprise.

Si vous êtes un partenaire de solutions, utilisez votre token d’accès utilisateur·ice système (« token système ») pour partager votre ligne de crédit avec la clientèle intégrée, et des tokens d’entreprise pour tous les autres cas de figure. Notez que l’utilisateur·ice système associé·e au token doit avoir accordé l’autorisation business_management à votre application, et doit disposer d’un rôle Admin ou Éditeur financier sur votre portefeuille business, afin de pouvoir partager votre ligne de crédit.

Autorisations

Bien qu’il soit possible de configurer l’inscription intégrée de manière à demander le maximum d’autorisations à vos clients professionnels, il est probable que vous n’aurez besoin que des autorisations suivantes :

  • whatsapp_business_management : indispensable si votre application doit accéder aux paramètres et aux modèles de message du compte WhatsApp Business de la clientèle intégrée.
  • whatsapp_business_messaging : indispensable si votre application doit accéder aux paramètres de numéros de téléphone professionnels de la clientèle intégrée, ou si elle sera utilisée pour envoyer et recevoir des messages.

Vous pouvez spécifier les autorisations dont aura besoin votre application durant le processus d’implémentation.

Notez que pendant que votre application est en mode développement, ces autorisations sont disponibles sur l’écran d’autorisation de l’inscription intégrée pour toutes les personnes dotées d’un rôle admin, développeur ou testeur sur votre application. Toutefois, une fois que votre application passe en mode Live, seules les autorisations approuvées dans le cadre d’un accès Avancé via le processus Contrôle app apparaissent dans le flux.

Facturation

Partenaires de solutions

Si vous êtes un partenaire de solutions, vous devez déjà disposer d’une ligne de crédit et avoir accepté les conditions générales de l’API Credit Allocation dans le panneau Paramètres de l’entreprise > Paiements de Meta Business Suite. En outre, vous devez partager votre ligne de crédit avec votre clientèle dans le cadre du processus d’intégration.

Fournisseurs et partenaires de technologies

Si vous êtes un fournisseur ou un partenaire de technologies, vos clients intégrés doivent ajouter un moyen de paiement à leur compte WhatsApp Business. Ils peuvent le faire en suivant les instructions décrites dans l’article Ajouter une carte de crédit à votre compte sur la plateforme WhatsApp Business de nos Pages d’aide.

Numéros de téléphone professionnels 555

Les clients dont l’entreprise a été vérifiée, ou les entreprises dont les limites de messages ont été augmentées pour l’API Cloud peuvent prétendre à deux numéros de téléphone professionnels 555.

Ces numéros fonctionnent comme les numéros de téléphone professionnels standard (notamment, leurs noms à l’écran doivent être examinés et approuvés, ils sont soumis aux règles de tarification basées sur la conversation et sont impactés par les évaluations de la qualité), avec les principales différences suivantes :

  • Ils disposent d’un indicatif américain (+1)
  • Ils sont associés à un indicatif régional 555
  • Ils sont automatiquement vérifiés
  • Ils ne peuvent pas être migrés vers un autre compte WhatsApp Business ni utilisés en dehors de la plateforme WhatsApp Business

Si votre clientèle commerciale est éligible à des numéros 555 et souhaite en enregistrer un en tant que numéro supplémentaire, demandez-lui de procéder à nouveau à l’inscription intégrée. Lorsqu’elle sera invitée à sélectionner un numéro de téléphone professionnel, la sélection d’un numéro 555 lui sera proposée d’office :

Contrôle app

Votre application doit au préalable avoir reçu l’autorisation accès Avancé pour chacune des autorisations dont elle a besoin pour que vous puissiez intégrer une clientèle professionnelle.

Consultez Contrôle app pour en savoir plus sur ce processus, et sur les éléments à fournir pour le mener à bien.

Assistant d’intégration

L’assistant d’intégration de l’inscription intégrée est un outil de configuration et de test disponible dans l’Espace App. Avec cet outil, vous pouvez :

  • Lancer l’inscription intégrée dans différentes configurations de flux
  • Voir les données qui sont renvoyées lorsqu’une entreprise cliente termine le flux
  • Générer le code de mise en œuvre et des requêtes d’intégration, que vous pouvez copier-coller sur votre site Web, sur le portail destiné à vos entreprises clientes et sur votre serveur
  • Envoyer des requêtes d’API aux points de terminaison dont vous aurez besoin pour intégrer les clients qui terminent le flux

Pour accéder à l’assistant d’intégration, sélectionnez Espace App > WhatsApp > Intégration ES (Embedded Signup, inscription intégrée).

Webhooks

Dans le cadre du processus d’intégration, vous devez abonner votre application à des webhooks sur le compte WhatsApp Business de chaque client professionnel qui effectue le processus d’inscription intégrée.

Les webhooks seront déclenchés et envoyés à l’URL de rappel configurée sur votre application, selon les champs webhook auxquels vous êtes abonné·e. En d’autres termes, tous les webhooks pour l’ensemble de vos clients professionnels intégrés seront envoyés à l’URL de rappel de votre application. Vous avez toutefois la possibilité d’annuler l’URL de rappel pour un compte WhatsApp Business ou un numéro de téléphone professionnel individuel. Consultez Redirection des webhooks pour connaître la marche à suivre.

Localisation

Le flux d’inscription intégrée est disponible en 30 langues. Le flux traduit s’affiche automatiquement en fonction de la langue choisie par le client professionnel pour utiliser Facebook.

Arabe, tchèque, danois, grec, anglais (Royaume-Uni), espagnol (Espagne), espagnol, finnois, français (France), hébreu, hindi, hongrois, indonésien, italien, japonais, coréen, norvégien (bokmal), néerlandais, polonais, portugais (Brésil), portugais (Portugal), roumain, russe, suédois, thaï, turc, vietnamien, chinois simplifié (Chine), chinois traditionnel (Hong Kong), chinois traditionnel (Taïwan).

Étapes suivantes

Découvrez comment implémenter l’inscription intégrée sur votre site Web ou votre portail.