L’API Business Management vous permet de créer et de gérer les éléments professionnels liés à WhatsApp, tels que les comptes WhatsApp Business et les modèles de message. L’API s’appuie sur l’API Marketing et tire parti de certains de ses points de terminaison. Cette documentation peut donc contenir des liens vers la documentation de l’API Marketing.
La plateforme prend en charge les types de tokens d’accès suivants. Le type que vous utilisez varie selon la personne qui se servira de votre application et selon que vous êtes ou non un fournisseur de solutions.
Les tokens d’accès utilisateur·ice système vous représentent vous, votre entreprise ou votre organisation, ou les membres de ces dernières. Leur principal avantage est qu’ils n'expirent pas, et qu’ils peuvent représenter des services automatisés au sein de votre entreprise qui ne nécessitent aucune saisie de l’utilisateur·ice.
Les tokens d’accès utilisateur·ice système sont le seul type de token qui peut être utilisé par les fournisseurs de solutions partenaires pour partager des lignes de crédit avec la nouvelle clientèle.
Pour pouvoir générer un token d’accès utilisateur·ice système, vous devez créer un·e utilisateur·ice système. La plupart des points de terminaison vérifient si l'utilisateur·ice identifié·e par le token a accès à la ressource demandée. Si ce n’est pas le cas, la demande sera rejetée avec le code d’erreur 200
.
Les utilisateur·ices système peuvent être des employé·es ou des admins.
Les utilisateur·ices système employé·es doivent avoir accès aux comptes WhatsApp Business individuels appartenant à l'entreprise Meta ou partagés avec celle-ci. Si votre application ne doit accéder qu'à quelques comptes WhatsApp Business vous appartenant, un·e utilisateur·ice système employé·e devrait suffire.
Après sa création, vous devez accorder un accès total ou partiel à chaque compte WhatsApp Business auquel l’utilisateur·ice système doit accéder.
Par défaut, les utilisateur·ices système admins ont un accès total à tous les comptes WhatsApp Business et éléments vous appartenant ou appartenant à votre entreprise, ou partagés avec vous ou celle-ci.
Les utilisateur·ices système admins sont utiles si votre application doit accéder aux comptes WhatsApp Business qui viennent d’être partagés avec votre entreprise. Si vous utilisez un·e utilisateur·ice système employé·e, vous devez accorder manuellement l'accès à chaque compte WhatsApp Business qui a été partagé avec vous.
Notez que vous pouvez outrepasser l'accès par défaut d'un·e utilisateur·ice système admin en accordant un accès partiel sur la base d’un compte WhatsApp Business.
Pour créer un·e utilisateur·ice système :
Pour générer un token d’accès utilisateur·ice système après avoir créé un·e utilisateur·ice système :
Les tokens d’accès utilisateur·ice du système d’intégration professionnelle concernent la nouvelle clientèle et doivent être utilisés par les fournisseurs de technologies et les fournisseurs de solutions partenaires lorsqu’ils accèdent aux données de cette clientèle.
Ils sont utiles pour les applications qui exécutent des actions de programmation automatisées sur les comptes WhatsApp Business des client·es, qui ne nécessitent pas de saisie manuelle ou de ré-authentification future.
Pour générer ce type de token d’accès, vous devez procéder à une inscription intégrée configurée avec Facebook Login for Business, et utiliser le code qui vous est renvoyé lorsqu’un·e client·e termine le processus.
Consultez les documents Inscription intégrée et Tokens d’accès utilisateur·ice du système d’intégration professionnelle pour en savoir plus sur ces tokens et la manière de les générer.
Bien que les tokens d’accès utilisateur·ice soient pris en charge et puissent être utilisés par tous les développeurs et toutes les développeuses d’application, il est probable que vous n’y recouriez que lors de votre première utilisation de l’Espace App pour envoyer votre premier message de test. Pendant le développement de votre application, vous opterez plus probablement pour un token d’accès utilisateur·ice système (et finirez peut-être avec un token d’accès utilisateur·ice de système d’intégration professionnelle si vous êtes un fournisseur de technologies ou de solutions). La raison en est que les tokens d’accès utilisateur·ice expirent rapidement, ce qui vous oblige à en générer un nouveau toutes les quelques heures.
Il existe plusieurs façons de générer un token d'accès utilisateur·ice :
Lors de vos requêtes d’API, incluez votre token dans un en-tête de demande d’autorisation, précédé de Bearer
. Par exemple :
curl 'https://graph.facebook.com/v18.0/102290129340398/message_templates' \ -H 'Authorization: Bearer EAAJB...' \
De nombreux points de terminaison exigent que l'utilisateur·ice dont le token est inclus dans les requêtes d'API dispose également d’un accès partiel ou total au compte WhatsApp Business interrogé (ou à ses éléments). Si l’utilisateur·ice n’a pas accès au compte, l’API renverra le code d’erreur 200.
Il est possible de définir un accès granulaire pour tout type d’utilisateur·ice, y compris les utilisateur·ices système. L'accès granulaire pour les utilisateur·ices système peut être utile si vous souhaitez restreindre l'accès à certains éléments pour des groupes de personnes. Par exemple, si vous avez une grande entreprise et si vous souhaitez qu'un service donné n'ait qu'un accès en lecture au modèle de compte WhatsApp Business et aux données de numéros de téléphone professionnels, vous pouvez créer un·e utilisateur·ice système pour ce service et définir un accès granulaire pour consultation uniquement.
Pour un accès utilisateur·ice désigné·e sur un compte WhatsApp Business ou ses éléments :
Si vous souhaitez tester des points de terminaison, nous vous recommandons d’utiliser notre collection Postman ou cURL. Bien que vous puissiez utiliser l’outil Explorateur de l’API Graph, celui-ci interprète les tokens comme des paramètres de chaîne de requête, ce que nous déconseillons. Nous vous recommandons plutôt de passer les tokens dans les en-têtes de requête.
Pour obtenir des informations sur une entreprise, envoyez une requête GET
au point de terminaison WhatsAppBusinessAccount
, où <WHATSAPP_BUSINESS_ACCOUNT_ID>
est votre ID de compte WhatsApp Business.
curl -i -X GET 'https://graph.facebook.com/v19.0
/<WHATSAPP_BUSINESS_ACCOUNT_ID>' \
-H 'Authorization: Bearer <ACCESS_TOKEN>'
{ "id": "<WHATSAPP_BUSINESS_ACCOUNT_ID>", "name": "Your WhatsApp Business Account Name", "timezone_id": "1", "message_template_namespace": "05155c78_261e_4b2f_82b3_d7958d4cf75f" }
Pour obtenir des informations spécifiques sur une entreprise (par exemple, son nom, ses modèles de message et ses numéros de téléphone), envoyez une requête GET
au point de terminaison WhatsAppBusinessAccount
, où <WHATSAPP_BUSINESS_ACCOUNT_ID>
est votre ID de compte WhatsApp Business, puis définissez le paramètre fields
sur une liste d’éléments dont vous demandez l’envoi.
curl -i -X GET 'https://graph.facebook.com/v19.0
/<WHATSAPP_BUSINESS_ACCOUNT_ID>?fields=id,name,message_templates,phone_numbers' \
-H 'Authorization: Bearer <ACCESS_TOKEN>'
{ "id": "<WHATSAPP_BUSINESS_ACCOUNT_ID>", "name": "Your WhatsApp Business Account Name", "message_templates": { "data": [ { "name": "hello_world", "components": [ { "type": "HEADER", "format": "TEXT", "text": "Hello World" }, { "type": "BODY", "text": "Welcome and congratulations!! This message demonstrates your ability to send a message notification from WhatsApp Business Platform. Thank you for taking the time to test with us." }, { "type": "FOOTER", "text": "WhatsApp Business Team" } ], "language": "en_US", "status": "APPROVED", "category": "ACCOUNT_UPDATE", "id": "307191531401674" }, { "name": "sample_flight_confirmation", "components": [ { "type": "HEADER", "format": "DOCUMENT" }, { "type": "BODY", "text": "Confirmamos tu vuelo a {{1}}-{{2}} para el {{3}}." }, { "type": "FOOTER", "text": "Este mensaje proviene de un negocio no verificado." } ], "language": "es", "status": "APPROVED", "category": "TICKET_UPDATE", }, ...
Type d’appel | Point de terminaison |
---|---|
|
|
|
|
|
|
|
|
|
|
|
|
Type d’appel | Point de terminaison |
---|---|
|
|
|
|
|
|
|
|