Cette page a été traduite par l'API Cloud Translation.

S'inscrire à Business Messages

Lorsque vous vous inscrivez en tant que partenaire avec Business Messages, vous pouvez faciliter les conversations entre les utilisateurs et les marques en créant des agents, c'est-à-dire des entités conversationnelles qui représentent des fonctions métier telles que l'assistance pour les sites Web et les emplacements de marque.

Lorsqu'un utilisateur trouve une marque que vous gérez dans la recherche Google ou sur Google Maps, une option Chat s'affiche dans les résultats de recherche. Lorsque l'utilisateur clique sur Chat, il peut envoyer des messages à l'agent de la marque. L'agent vous permet de recevoir les messages de l'utilisateur et d'y répondre.

S'inscrire en tant que partenaire

En vous inscrivant en tant que partenaire avec Business Messages, en créant des agents pour les marques et en exploitant les API de votre agent, vous pouvez proposer des expériences de messagerie pour les services client, les ventes et d'autres applications métier.

Ouvrez la Console développeur de Business Communications.
Sous Business Messages, cliquez sur Créer un compte partenaire.

Saisissez les valeurs de vos informations de partenaire:

Champ	Value
Votre nom	Votre nom complet
Nom du partenaire	Nom de votre entreprise
Site Web du partenaire	Site Web de votre entreprise
Une région	Région dans laquelle vous souhaitez héberger le service Business Messages

Lisez et acceptez les Conditions d'utilisation de Business Messages.
Cliquez sur Créer.

Vous êtes maintenant enregistré en tant que partenaire Business Messages, et vous avez accès aux API Business Messages et Business Communications. L'API Business Messages envoie des messages aux utilisateurs, tandis que l'API Business Communications gère les agents.

Créer un compte de service

Pour authentifier de manière sécurisée les appels d'API aux API Business Messages et Business Communications, vous avez besoin d'une clé de compte de service et de l'outil de ligne de commande oauth2l.

Sur la page d'accueil de la console développeur de communications commerciales, cliquez sur Paramètres de compte partenaire.
Dans le volet de navigation de gauche, cliquez sur Compte de service.
Cliquez sur Créer une clé, puis sur Créer.

Votre navigateur télécharge la clé du compte de service. Stockez votre clé de compte de service dans un emplacement privé et sécurisé. Ne partagez pas votre clé publiquement. Vous en aurez besoin plus tard pour accéder aux API Business Messages et Business Communication.

Définir votre webook

Maintenant que l'API Business Messages et Business Communications est activée, vous devez spécifier l'URL du webhook pour commencer à recevoir des messages.

Ouvrez les Paramètres du compte dans la Business Console Developer Console.
Assurez-vous que le bon compte partenaire est sélectionné.
Dans le champ URL du webhook Business Messages, cliquez sur Configurer.
Pour le champ URL du point de terminaison du webhook, saisissez l'URL de votre webhook, commençant par "https://".
Notez la valeur clientToken. Vous en avez besoin pour vérifier que les messages que vous recevez proviennent de Google.
Configurez votre webhook pour qu'il accepte une requête POST avec le paramètre clientToken spécifié et envoyez une réponse 200 OK avec la valeur en texte brut du paramètre secret comme corps de la réponse.

Par exemple, si votre webhook reçoit une requête POST avec le contenu du corps suivant :
```
{
  "clientToken":"SJENCPGJESMGUFPY",
  "secret":"0123456789"
}
```
votre webhook doit confirmer la valeur clientToken et, si clientToken est correcte, renvoyer une réponse 200 OK avec 0123456789 comme corps de la réponse.
Dans la console, cliquez sur Valider.

Lorsque Business Messages valide votre webhook, la boîte de dialogue se ferme.

Consultez la section Exemple: mettre à jour l'URL de webhook pour savoir comment configurer votre webhook avec les API Business Communication.

Obtenir des informations sur les partenaires

Pour obtenir vos informations de partenaire actuelles, vous pouvez interroger l'API Business Communications avec votre ID de partenaire.

Exécutez la commande suivante : Remplacez PARTNER_ID par votre ID de partenaire.


# This code gets the partner.
# Read more: https://developers.google.com/business-communications/business-messages/reference/business-communications/rest/v1/partners/get

# Replace the __PARTNER_ID__
# Make sure a service account key file exists at ./service_account_key.json

curl -X GET \
"https://businesscommunications.googleapis.com/v1/partners/__PARTNER_ID__" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/business-communications" \
-H "$(oauth2l header --json ./service_account_key.json businesscommunications)"get-partner.sh

Mettre à jour les informations sur le partenaire

Pour mettre à jour vos informations de partenaire, vous pouvez accéder à la page Paramètres du compte dans la Business Console Developer Console ou exécuter les commandes suivantes.

Remplacez PARTNER_ID par votre ID de partenaire(l'ID de partenaire se trouve dans la Business Console Developer Console) et remplacez UPDATED_FIELDS par les noms de champ que vous mettez à jour.


# This code updates the partner entity.
# Read more: https://developers.google.com/business-communications/business-messages/reference/business-communications/rest/v1/partners/patch

# Replace the __PARTNER_ID__, __UPDATED_FIELDS__, __FIELD_NAME__, __FIELD_VALUE__
# Make sure a service account key file exists at ./service_account_key.json

curl -X PATCH \
"https://businesscommunications.googleapis.com/v1/partners/__PARTNER_ID__?updateMask=__UPDATED_FIELDS__" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/business-communications" \
-H "$(oauth2l header --json ./service_account_key.json businesscommunications)" \
-d '{
  "__FIELD_NAME__": "__FIELD_VALUE__"
}'update-partner.sh

Pour en savoir plus sur les options de mise en forme et de valeurs, consultez partners.patch.

Exemple: Mettre à jour le nom à afficher

curl -X PATCH \
"https://businesscommunications.googleapis.com/v1/brands/12345/partners/67890?updateMask=displayName" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/business-communications" \
-H "$(oauth2l header --json /path/to/service/account/key businesscommunications)" \
-d "{
    'displayName': 'XYZ Messaging',
}"

Exemple: Mettre à jour l'URL du webhook

curl -X PATCH \
"https://businesscommunications.googleapis.com/v1/partners/12345?updateMask=productCapabilities" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/business-communications" \
-H "$(oauth2l header --json /path/to/service/account/key businesscommunications)" \
-d "{
  'productCapabilities': [
    {
      'product': 'BUSINESS_MESSAGES',
      'businessMessagesCapability': {
        'webhookUrl': 'https://xyz.messaging.com/webhook',
      },
    },
  ],
}"

Étapes suivantes

Maintenant que vous êtes un partenaire enregistré et que vous avez activé les API, vous pouvez commencer à développer avec Business Messages. Pour commencer rapidement, consultez Créer votre premier agent.

Sinon, découvrez comment créer des agents pour représenter vos marques dans les conversations et configurer votre webhook pour recevoir des messages des utilisateurs.