Questions/réponses sur l’inscription intégrée

Une entreprise est propriétaire de son propre compte WhatsApp Business (WABA) et y accède via le Business Manager. L’accès à ce compte WABA est automatiquement partagé avec le fournisseur de solutions d’entreprise (BSP), depuis le site web sur lequel il ou elle s’est inscrit·e, après avoir terminé le processus d’inscription intégrée. L’entreprise ne doit effectuer aucune opération pour ajouter le BSP au WABA.

Voir Les entreprises sont propriétaires de leur WABA.

Lorsqu’une entreprise partage un compte WhatsApp Business avec un fournisseur de solutions d’entreprise (BSP), ce dernier ou cette dernière reçoit une notification de Business Manager et un e-mail. Voir Gérer les comptes, Notification de partage.

Pour le moment, une entreprise peut uniquement partager l’accès à son compte WhatsApp Business avec une seule personne : le fournisseur de solutions d’entreprise. Nous reviendrons sur les options de partage d’accès avec d’autres groupes ultérieurement.

Les utilisateurs système administrateurs n’ont pas besoin d’être ajoutés explicitement à un WABA car ils ont automatiquement accès à tous les éléments.

L’approche recommandée est d’utiliser des utilisateurs système avec accès employé et ce sont ces utilisateurs qui doivent être ajoutés à chaque WABA créé car ils n’ont aucun accès par défaut. Cette recommandation se base uniquement sur les risques potentiels en matière de sécurité. Dans la mesure où les tokens d’accès des utilisateurs système sont valables pendant une très longue période, la compromission d’un token génère un risque de sécurité, notamment si ce compte est associé à des autorisations d’administrateur à l’échelle du compte business. Aussi, si vous choisissez de conserver un utilisateur système administrateur, vous n’avez pas à l’ajouter au WABA.

Non. Pour le moment, les entreprises ne peuvent pas restreindre l’accès, car elles sont propriétaires du compte WhatsApp Business et peuvent l’afficher dans leur Gestionnaire WhatsApp.

Once the Embedded Signup flow is complete and all the business profile information is captured, the certificate will be available for download.

Beginning May 2, 2022, after signup, a compliance check with the WhatsApp platform policies is auto-triggered and performed in the background. If this check fails, we notify businesses via email and the account is disabled. Businesses have the ability to appeal.

Les entreprises doivent démarrer la vérification de l’entreprise lorsqu’elles sont prêtes à envoyer des conversations lancées à leur initiative, à ajouter des numéros de téléphone supplémentaires ou à faire la demande d’un compte business officiel (OBA).

Lorsqu’une entreprise atteint ses limites, elle est dirigée vers une assistance interne au produit sur la mise à niveau par le lancement d’une vérification de l’entreprise. Aucun changement n’a été apporté aux processus actuels de vérification de l’entreprise ou d’OBA. Après l’approbation, les entreprises peuvent envoyer des conversations lancées à leur initiative à 1 000 clients uniques et procéder à une augmentation basée sur nos conditions de mise à niveau des limites de messages.

Beginning May 2, 2022, the display name review is initiated after Business Verification (BV) is completed. The display name can be updated at any time. Any updates to the display name post BV have to go through a review again. For more details, visit Display name documentation.

Pour le moment, aucune modification n’est apportée aux autres vérifications.

Les fournisseurs de solutions d’entreprise (BSP) peuvent télécharger des certificats dès l’inscription d’une entreprise. À ce stade, vous devez aussi démarrer le client de l’API WhatsApp Business pour permettre à l’entreprise d’envoyer des messages à l’état non vérifié.

Des certificats peuvent être téléchargés pour les numéros de téléphone dans l’environnement de test et pour les numéros de téléphone ayant terminé tous les processus de vérification (vérification de l’entreprise, vérifications WhatsApp, vérification du nom à l’écran). Pour télécharger un certificat, utilisez le point de terminaison phone_numbers ou le Gestionnaire WhatsApp. Seuls les BSP peuvent télécharger des certificats. Les entreprises ne sont pas autorisées à le faire.

Si une entreprise échoue à nos vérifications, nous déconnectons son numéro. Nous informons le fournisseur de solutions d’entreprise (BSP) et l’entreprise via des notifications par e-mail et Business Manager. À ce stade, WhatsApp désactive le numéro de téléphone, et le BSP doit arrêter l’instance du client de l’API WhatsApp Business pour cette entreprise.

Certains comptes Business Manager ont déjà été vérifiés pour d’autres raisons. Dans ce cas, ils doivent quand même être soumis à nos autres vérifications (nom d’usage, règlement commercial, etc.) pour pouvoir envoyer un grand nombre de messages. En attendant la fin du processus de vérification, ils ont accès à l’environnement de test non vérifié.

Si une entreprise souhaite utiliser un compte Business Manager déjà vérifié, mais ne dispose pas du rôle d’administrateur sur ce compte, elle peut essayer la procédure suivante :

• Demander à être ajoutée comme administrateur du compte Business Manager.
• Demander à l’administrateur du compte Business Manager de procéder à l’inscription intégrée.
• Sinon, créer un nouveau compte Business Manager et procéder à la vérification de l’entreprise pour ce compte.

Pour plus d’informations sur comment demander et obtenir une autorisation, consultez Contrôle app.

Contrôle app se compose de deux parties :

1. Vérification app : vérifier si l’application fonctionne, si elle respecte le cas d’usage décrit et si elle atteint le niveau de qualité requis pour l’expérience d’utilisation
2. Vérification des autorisations : vérifier si le développeur dispose uniquement des autorisations demandées dont il a besoin

L’autorisation business_management est nécessaire aux fournisseurs de solutions d’entreprise (BSP) pour gérer les comptes business de leurs clients et partager leur ligne de crédit avec l’entreprise cliente.

Les fournisseurs de solutions d’entreprise doivent obtenir l’autorisation whatsapp_business_management pour gérer les numéros de téléphone et les modèles de message, envoyer des messages et affecter des utilisateur·trices au compte WhatsApp Business.

Vous devez démontrer clairement comment votre application utilise les autorisations business_management et whatsapp_business_management. Pour ce faire, envoyez-nous une démonstration vidéo de l’intégration du flux d’inscription intégrée, ainsi que des notes détaillées du développeur pour expliquer le cas d’utilisation.

Suivez les règles relatives aux enregistrements d’écran pour importer des vidéos et des captures d’écran illustrant votre intégration, ce qui se passe une fois l’intégration terminée et comment les utilisateurs peuvent envoyer des messages en mode sandbox.

Les applications d’entreprise obtiennent automatiquement un accès Standard pour toutes les autorisations et fonctionnalités disponibles pour ce type d’application. Ainsi, vous pouvez effectuer une capture vidéo de chaque cas d’utilisation légitime pour lequel vous demandez une autorisation. Pour en savoir plus, consultez la documentation sur les niveaux d’accès.

Les entreprises qui utilisent le processus d’inscription intégrée demandent l’accès à la ligne de crédit du fournisseur de solutions d’entreprise (BSP) afin de payer l’accès à la plateforme WhatsApp Business. Autrement dit, les entreprises paient le BSP, et ce dernier reçoit une facture cumulative pour régler Meta.

Pour accorder l’accès aux entreprises, les BSP doivent partager leur ligne de crédit.

Pour l’instant, les entreprises ne peuvent pas payer directement l’accès à WhatsApp.

Un fournisseur de solutions d’entreprise peut révoquer l’accès d’une entreprise à sa ligne de crédit dans Meta Business Manager ou avec une série d’appels d’API.

En tant que propriétaire de la ligne de crédit, le fournisseur de solutions d’entreprise (BSP) est le débiteur de toutes les entreprises avec lesquelles il partage sa ligne de crédit. Le BSP est responsable juridiquement et s’engage à régler à Meta toutes les dépenses relatives à l’API WhatsApp Business engagées par ces entreprises.

Le flux d’inscription intégrée fonctionne uniquement dans les navigateurs web et ne fonctionne pas sur les appareils ou navigateurs mobiles. Veillez à ce que vos clients s’inscrivent sur le web.

Le code d’intégration de Facebook Login est écrit en Vanilla JavaScript, n’est dépendant d’aucune bibliothèque frontale et fonctionne avec n’importe quel framework JavaScript.

Seuls les fournisseurs de solutions d’entreprise (BSP) partenaires peuvent utiliser le flux d’inscription intégrée sur leur site web. Nous n’autorisons aucune tierce partie à utiliser le flux sur leurs propriétés. Nous vous tiendrons informé si cette condition venait à changer.

Lors de l’inscription, l’entreprise doit fournir le numéro de téléphone et le nom à l’écran qu’elle souhaite utiliser dans la plateforme WhatsApp Business. Nous déconseillons vivement l’utilisation d’un nom à l’écran factice ou d’un numéro de téléphone personnel/factice, car l’entreprise aura du mal à les modifier par la suite.

Une entreprise ne peut pas s’inscrire avec un numéro de téléphone ayant déjà servi pour WhatsApp Messenger ou l’application WhatsApp Business.

Actuellement, les entreprises ne peuvent pas s’inscrire via ce flux avec le numéro d’un serveur vocal interactif, car elles ne pourront pas vérifier ce numéro de téléphone.

Un numéro de téléphone devient actif dès son inscription par le fournisseur de services professionnels. Si l’inscription aboutit, le numéro est activé en quelques minutes.

Après examen du nom d’usage initial, les entreprises peuvent modifier leur nom d’usage dans Business Manager. Elles doivent alors recommencer la procédure d’examen du nom d’usage.

Le fournisseur de solutions d’entreprise (BSP) reçoit un e-mail de notification, ainsi qu’une notification de Business Manager, lorsque le nouveau nom est approuvé. Il doit ensuite télécharger à nouveau le certificat et reprovisionner le client de l’API WhatsApp Business. Les BSP peuvent également suivre ces changements de nom en configurant des webhooks.

Actuellement, les entreprises ne peuvent pas accéder à l’assistance directe. Nous étudions actuellement des forfaits d’assistance directe de longue durée et vous tiendrons informé en temps voulu.

Quand une entreprise termine le flux d’inscription intégrée, le système envoie un rappel Facebook Login. Le fournisseur de solutions d’entreprise (BSP) peut alors envoyer une requête afin d’obtenir les comptes WhatsApp Business ainsi partagés et télécharger le certificat.

Pour les fournisseurs de solutions d’entreprise

Quand une entreprise termine le processus d’inscription intégrée, le système envoie un rappel Facebook Login. Le fournisseur de solutions d’entreprise (BSP) peut envoyer une requête afin d’obtenir les comptes WhatsApp Business partagés et ainsi télécharger le certificat. Le compte WhatsApp Business de l’entreprise est également partagé avec le BSP.

Les BSP devraient aussi guider les entreprises dans le processus de vérification de l’entreprise en s’assurant qu’elles comprennent le processus et qu’elles sont en mesure de fournir la documentation adéquate.

Pour les entreprises

Une fois l’inscription terminée et toutes les informations sur le profil professionnel enregistrées, vous pourrez télécharger le certificat. Les entreprises peuvent répondre à un nombre illimité de conversations lancées par le client (fenêtres d’envoi des messages de 24 heures) et envoyer des conversations lancées à leur initiative à 50 clients uniques sur une période continue de 24 heures.

Les entreprises devraient démarrer la vérification de l’entreprise dès qu’elles sont prêtes à lancer des conversations à leur initiative, à ajouter des numéros de téléphone ou à faire la demande d’un compte business officiel.

Vérifiez qu’un moyen de paiement valide est associé au compte WhatsApp Business. Si ce n’est pas le cas, les envois de modèles de messages échoueront.

Vérifiez que votre application Facebook dispose des autorisations business_management et whatsapp_business_management. Si le problème persiste, ouvrez un ticket d’assistance directe dans lequel vous devez fournir les informations sur votre application, ainsi que les étapes que notre équipe doit suivre pour reproduire le problème.

Pendant le processus d’inscription intégrée, l’utilisateur·trice ne peut sélectionner ou créer qu’un seul compte WhatsApp Business à la fois. Cependant, il ou elle peut répéter le processus pour créer ou sélectionner un autre compte WhatsApp Business.

N’oubliez pas que le principal changement apporté par le processus d’inscription intégrée est que le client ou la cliente détiendra à la fois les comptes Business Manager et WhatsApp Business, et les partagera avec le fournisseur de solutions d’entreprise.

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 final pour utiliser Facebook. Pour en savoir plus, consultez Vue d’ensemble, Traductions.

Non, le flux est le même pour tous les BSP afin que toutes les entreprises suivent la même procédure lors de leur inscription. En revanche, les BSP contrôlent l’expérience des utilisateurs et utilisatrices avant et après le flux d’inscription intégrée, y compris les étapes suivantes, où rediriger les entreprises, etc.

Lorsque l’entreprise termine l’enregistrement du flux OAuth de l’inscription intégrée, le rappel JavaScript obtient l’accessToken qui peut être utilisé avec le point de terminaison Debug-Token pour récupérer les comptes WhatsApp Business partagés.

Le point de terminaison client_whatsapp_business_accounts permet également d’obtenir une liste de tous les comptes WhatsApp Business partagés.

Quand vous utilisez le point de terminaison Debug-Token, vous obtenez la liste exacte de tous les comptes WhatsApp Business que l’entreprise a partagés avec vous. Vous pouvez comparer les ID de ces comptes avec les ID dont vous disposez pour vérifier l’absence de doublons.

Les valeurs du champ target_ids renvoyées par le point de terminaison Debug-Token correspondent aux ID des comptes WhatsApp Business que l’entreprise a partagés avec vous par le biais du flux d’inscription intégrée.

The client_whatsapp_business_accounts endpoint returns all client-owned WhatsApp Business Accounts that are shared with the Solution Partner.

If two WhatsApp business accounts were created at the same time through the embedded signup flow, the API response captures both WhatsApp Business Accounts.

In order to detect new phone numbers added to a WhatsApp Business Account, we'd recommend using the phone_numbers endpoint. It returns all client-owned WhatsApp Business Accounts that have been assigned to the Solution Partner, regardless of whether it is new or has a phone number set up yet.

Clients can create multiple WhatsApp Business Accounts under the same business ID. Client’s business information can be fetched with the WhatsApp Business Account endpoint.

Example request

curl -i -X GET "https://graph.facebook.com/v21.0/{business-id}/
  owned_whatsapp_business_accounts?
  access_token=system-user-access-token"

Example response

{ 
    "data": [
        {
            "id": 1906385232711451, 
            "name": "My WhatsApp Business Account", 
            "currency": "USD", 
            "timezone_id": "1", 
            "message_template_namespace": "abcdefghijk_12lmnop" 
        },
       {
            "id": 1972385232711141, 
            "name": "My Regional Account", 
            "currency": "INR", 
            "timezone_id": "5", 
            "message_template_namespace": "12abcdefghijk_34lmnop" 
        },

    ],
    "paging": {
	"cursors": {
		"before": "abcdefghij"
		"after": "klmnopqr"
	}
   }
}

Le client peut recommencer le flux d’inscription intégrée, sélectionner un compte WhatsApp Business existant et ajouter un nouveau numéro de téléphone. Pour détecter cette modification, vous pouvez envoyer une requête au point de terminaison phone_numbers pour tous les comptes WhatsApp Business afin de détecter tout ajout d’un nouveau numéro de téléphone.

Vous pouvez filtrer les comptes WhatsApp Business par date de création ou trier les comptes WhatsApp Business par date de création.

Vous pouvez filtrer et trier les comptes WhatsApp Business par heure de création.

Actuellement, le partage de comptes WhatsApp Business est désactivé en dehors du flux d’inscription intégrée.

Les entreprises qui utilisent un numéro de téléphone déjà enregistré dans WhatsApp Messenger ou l’application WhatsApp Business ne peuvent pas utiliser ce numéro pour l’inscription intégrée. Si le numéro est utilisé pour l’application WhatsApp Business, il doit être supprimé.

Consultez Migrer le numéro de téléphone pour savoir comment supprimer le numéro et demander le numéro pour l’inscription intégrée WhatsApp.

Si le compte n’a pas encore été vérifié, le numéro peut être utilisé à des fins de test pendant 30 jours. Pendant cette période, le numéro peut être enregistré et servir à contacter un nombre limité d’utilisateurs. Une fois le numéro de téléphone et le nom d’usage du compte vérifiés, le numéro de téléphone peut être utilisé normalement.

Si le compte n’est pas vérifié dans les 30 jours d’essai, la période de test prend fin et le numéro est déconnecté. Pour réenregistrer le numéro, l’entreprise doit faire vérifier le compte.

Pour ajouter d’autres numéros de téléphone à leur compte WhatsApp Business, les entreprises doivent accéder à leur compte Facebook Business.

Actuellement, le nœud du numéro de téléphone ne peut pas être récupéré avec l’inscription intégrée. Pour récupérer les informations concernant le numéro de téléphone et le certificat, vous pouvez appeler l’arête phone_numbers sur un nœud du compte WhatsApp Business en saisissant le code :

https://graph.facebook.com/v21.0/{{WABA-ID}}/phone_numbers?fields=display_phone_number,name_status,certificate,new_certificate,new_name_status

Pour en savoir plus, veuillez consulter Gérer les comptes WhatsApp Business, sous Inscription intégrée.

• Les limitations de débit standard de l’API Graph et les limitations de débit des cas d’utilisation d’entreprise s’appliquent.
• Plusieurs utilisateurs système sont comptabilisés comme un seul utilisateur.
• En utilisant le token d’accès utilisateur renvoyé par le flux OAuth, vous obtiendrez un nombre d’utilisateurs plus élevé, et augmenterez ainsi vos limitations de débit.

• Token d’accès utilisateur : token de courte durée renvoyé par le flux OAuth, qui peut être utilisé pour récupérer la liste des comptes WhatsApp Business partagés avec vous. Consultez la documentation sur les tokens d’accès pour en savoir plus.
• Token d’utilisateur système : les utilisateurs ou utilisatrices système sont les serveurs ou logiciels qui effectuent des appels d’API vers les ressources détenues ou gérées pas votre compte Business Manager. Les tokens d’utilisateur système sont des tokens de longue durée qui n’ont pas d’heure d’expiration. Ces tokens peuvent toutefois faire l’objet d’une invalidation pour d’autres raisons, mais ils n’expireront pas pour des raisons de durée uniquement. Si vous générez un nouveau token d’utilisateur système, les tokens existants resteront valides et auront les mêmes autorisations que ce nouveau token, sauf si vous les révoquez. Une fois l’utilisateur ou utilisatrice système associé·e au compte WhatsApp Business, vous pourrez effectuer des appels d’API pour gérer ce compte par la suite.

L’utilisateur·trice système spécifié·e n’a pas l’autorisation de modifier le compte WhatsApp Business (WABA). Vérifiez que l’utilisateur·trice système spécifié·e peut accéder au WABA. Si ce n’est pas le cas, vous devez ajouter l’utilisateur système spécifié au WABA.