S'inscrire à Business Messages

Lorsque vous vous inscrivez en tant que partenaire avec Business Messages, vous pouvez activer les conversations entre les utilisateurs et les marques en créant des agents, Entités représentant des fonctions commerciales, telles que l'assistance de site Web et la marque emplacements.

Agent: représentation conversationnelle d'une marque, gérée par un partenaire. Inclut l'un des éléments suivants : avec lesquelles les utilisateurs interagissent, ainsi que tout code ou infrastructure requis pour alimenter l'interaction.

Lorsqu'un utilisateur trouve une marque que vous gérez dans la recherche Google ou sur Google Maps, la les résultats de la recherche affichent une option Chat. Lorsque l'utilisateur clique sur Chat, peuvent envoyer des messages à l'agent de la marque. L'agent vous permet de recevoir aux messages de l'utilisateur.

S'inscrire en tant que partenaire

En vous inscrivant en tant que partenaire à Business Messages, en créant des agents pour des marques, et en exploitant les API qui alimentent votre agent, vous pouvez activer la messagerie pour le service client, la vente et les autres applications d'entreprise.

1. Ouvrez la console pour les développeurs Business Communications.
2. Sous Business Messages, cliquez sur Créer un compte partenaire.

3. Saisissez des valeurs pour vos informations de partenaire:

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

Remarque :Pour lancer un agent de production avec Business Messages, vous devez vous inscrire avec une adresse e-mail professionnelle, et non personnelle.

1. Lisez et acceptez les Conditions d'utilisation de Business Messages

2. Cliquez sur Créer.

Vous êtes désormais inscrit en tant que partenaire Business Messages, et 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 aux API Business Messages et Business Communications, vous devez disposer d'une clé de compte de service et du l'outil de ligne de commande oauth2l.

1. Sur la page d'accueil de la console pour développeur Business Communications, cliquez sur Paramètres du compte partenaire.
2. Dans le panneau de navigation de gauche, cliquez sur Compte de service :

3. Cliquez sur Créer une clé, puis sur Créer.

   Votre navigateur télécharge la clé du compte de service. Stockez la clé de votre compte de service dans un emplacement privé et sécurisé. À ne pas faire partager votre clé publiquement. Vous en aurez besoin ultérieurement pour accéder aux API Business Message et Business Communication.

Remarque :Si vous êtes un partenaire Business Messages disposant de votre propre compte GCP, vous pouvez accéder à vos clés de compte de service dans la console Google Cloud.

Configurer votre webook

Maintenant que l'API Business Messages et Business Communications est activée, vous Vous devez spécifier l'URL de votre webhook pour démarrer la réception de messages.

1. Ouvrez les paramètres du compte dans la console pour les développeurs Business Communications.
2. Assurez-vous que le bon compte partenaire est sélectionné.
3. Pour URL du webhook Business Messages, cliquez sur Configurer.
4. Dans le champ URL du point de terminaison du webhook, saisissez l'URL de votre webhook, commençant par "https://".
5. Notez la valeur clientToken. Vous en avez besoin pour vérifier que les messages que vous reçoivent proviennent Google.

6. Configurez votre webhook pour qu'il accepte une requête POST avec les le paramètre clientToken et envoyer une réponse 200 OK avec le texte brut ; du paramètre secret en tant que corps de la réponse.

   Par exemple, si votre webhook reçoit une requête POST avec les éléments suivants : corps du contenu

   {
     "clientToken":"SJENCPGJESMGUFPY",
     "secret":"0123456789"
   }
   

   le webhook doit confirmer la valeur clientToken et, si clientToken est correctement, renvoyez une réponse 200 OK avec 0123456789 comme corps de réponse.

7. Dans la console, cliquez sur Valider.

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

Voir Exemple: Mettre à jour l'URL du webhook pour découvrir comment configurer votre webhook avec les API Business Communication.

Obtenir des informations sur les partenaires

Pour obtenir les informations actuelles sur votre partenaire, vous pouvez envoyer une requête à l'établissement API 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 les informations de votre partenaire, vous pouvez utiliser la page Paramètres du compte dans la console pour les développeurs Business Communications ou exécuter les commandes suivantes.

Remplacer PARTNER_ID par votre ID de partenaire(vous le trouverez dans la console pour les développeurs Business Communications), puis remplacez UPDATED_FIELDS par les noms de champs 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 connaître les options de mise en forme et de valeur, 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 avec Business Messages. Pour commencer rapidement, consultez Créez votre premier agent.

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