Configurer votre compte partenaire

Suivez les instructions de cette page si vous souhaitez gérer vos enregistrements à l'aide du modèle RBM basé sur les partenaires. Ces instructions ne s'appliquent pas aux partenaires qui utilisent l'ancien modèle RBM.

Pour déterminer le modèle que vous utilisez, ouvrez la Console pour les développeurs Business Communications. Si les paramètres du compte partenaire s'affiche sur la page d'accueil, cela signifie que vous utilisez le modèle RBM basé sur les partenaires. Si vous n'avez pas accès aux paramètres de votre compte partenaire, vous utilisez l'ancienne version modèle RBM.

Une fois que vous vous êtes inscrit en tant que partenaire RBM, vous disposez d'un compte partenaire. Pour y accéder les paramètres de votre compte partenaire, ouvrez le Console pour les développeurs Business Communications puis cliquez sur Paramètres du compte partenaire. Vous pouvez alors effectuer les opérations suivantes:

• Mettre à jour les informations de votre compte partenaire
• Ajouter, modifier et supprimer des marques associées à votre compte
• Gérer les utilisateurs du compte
• Créer un compte de service et une clé pour authentifier les appels d'API

Mettre à jour les informations du compte partenaire

Sur la page Paramètres, vous pouvez voir votre identifiant de partenaire et mettre à jour le les informations suivantes:

Champ	Description
Nom du partenaire	Nom de votre compte partenaire
Nom à afficher	Le nom apparaîtra dans la Rapports de facturation RBM que reçoivent les opérateurs (en tant que owner_name ). Les opérateurs l'utiliseront pour vous identifier en tant que partenaire de confiance et pour : assurez-vous qu'ils génèrent les bonnes informations de facturation pour votre utilisation de RBM pour toucher leurs abonnés. Le nom que vous indiquez ici doit correspondre au utilisé dans vos contrats de messagerie avec l'opérateur.
Contact en cas de problème technique	La personne que Google contactera en cas de problème technique concernant vos agents. Vous pouvez mettre à jour Nom Adresse e-mail professionnelle Numéro de téléphone
Webhook	Il s'agit de l'URL du point de terminaison de votre webhook. Cliquez sur Configurer pour le mettre à jour. Lorsque vous configurer votre partenaire , il s'applique à tous vos agents. Si vous souhaitez utiliser un un webhook différent pour un agent individuel, vous pouvez configurer un agent webhook qui ne s'appliquent qu'à cet agent.

Gérer les marques

En tant que partenaire RBM, vous pouvez créer des agents au nom de marques.

Marque Organisation ou groupe représenté par un ou plusieurs agents. Par exemple, l'entreprise de services financiers Growing Tree pourrait créer une marque appelée Growing Tree et un agent appelé Growing Tree Bank pour parler des services bancaires services.

Utilisez la page Marques dans les paramètres du compte. pour ajouter, modifier ou supprimer les marques associées à votre compte partenaire.

Ajouter une marque

Pour ajouter une marque, saisissez son nom dans le champ de saisie, puis cliquez sur Ajouter.

Modifier une marque

Pour modifier une marque:

1. Cochez la case à côté du nom de la marque.
2. Cliquez sur le bouton , puis sur Modifier le nom.
3. Apportez les modifications nécessaires, puis cliquez sur OK.

Supprimer une marque

Une marque ne peut pas être supprimée si elle est associée à un agent, même si celui-ci n'est pas lancé.

Pour supprimer une marque, cochez la case à côté de son nom, puis cliquez sur Supprimer :

Gérer les utilisateurs

la page Utilisateurs dans les paramètres du compte ; vous permet de gérer les utilisateurs de votre compte partenaire. L'utilisateur qui a créé le a le rôle de propriétaire. Les nouveaux utilisateurs peuvent avoir le rôle de gestionnaire Lecteur.

• Les administrateurs ont accès à toutes les fonctionnalités de la console développeur, afin de gérer tous les agents appartenant au compte partenaire.
• Les lecteurs disposent d'un accès en lecture seule à la console développeur, ce qui leur permet d'afficher tous les agents appartenant au compte du partenaire.

Ajouter un utilisateur

Pour ajouter un utilisateur, saisissez son adresse e-mail dans le champ de saisie et sélectionnez son Rôle.

Lorsque vous ajoutez un utilisateur, il reçoit un e-mail l'informant qu'il a l'accès au compte partenaire.

Supprimer un utilisateur

Pour supprimer un utilisateur :

1. Recherchez l'utilisateur que vous souhaitez supprimer, puis cliquez sur le dans sa ligne du tableau.
2. Sélectionnez Supprimer un utilisateur.
3. Confirmez la suppression.

L'utilisateur que vous avez supprimé reçoit un e-mail l'informant qu'il n'a plus l'accès au compte partenaire.

Vous ne pouvez pas supprimer un utilisateur disposant du rôle de propriétaire. Pour modifier ou supprimer le propriétaire, vous devez contactez l'assistance.

Modifier le rôle d'un utilisateur

Pour mettre à jour le rôle d'un utilisateur:

1. Recherchez l'utilisateur que vous souhaitez mettre à jour, puis cliquez sur l'icône dans sa ligne du tableau.
2. Sélectionnez Modifier le rôle.
3. Choisissez un nouveau rôle dans la liste déroulante.
4. Cliquez sur Enregistrer.

Configurer le compte de service pour authentifier les appels d'API

Lorsque vous appelez l'API RBM, vous authentifiez les appels avec une clé de compte de service. Cette clé vous permet de créer gérer des marques et des agents, envoyer des messages et des demandes en tant qu'agent.

Remarque :Pour authentifier les appels d'API de manière sécurisée, vous devez également disposer du Outil de ligne de commande oauth2l.

Pour générer une clé de compte de service, procédez comme suit:

1. Dans Paramètres du compte : accédez à la page Compte de service.
2. Cliquez sur Créer une clé, puis sur Créer. Votre navigateur télécharge le clé de compte de service.

Stockez la clé de votre compte de service dans un emplacement privé et sécurisé. Ne partagez pas votre publiquement. Vous en aurez besoin ultérieurement pour accéder aux API RBM.

Configurer le webhook de partenaire

Un webhook est un rappel HTTPS créé par un partenaire qui spécifie la manière dont votre agent doit répondre aux messages et aux événements. Après avoir configuré votre webhook, vous pouvez commencer à recevoir des messages ; et les événements.

Remarque :Si vous souhaitez utiliser un webhook différent pour l'un de vos agents, vous pouvez définir et configurer un webhook au niveau de l'agent qui remplacera celui du partenaire. Voir Configurer un webhook d'agent pour en savoir plus.

Pour configurer le webhook de votre partenaire, procédez comme suit:

1. Ouvrez la console développeur Business Communications. et connectez-vous avec votre compte Google partenaire RBM.

2. Ouvrez la page Paramètres du compte.

3. Dans le champ URL du webhook RCS Business Messaging, 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 recevez proviennent de 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 la valeur en 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":"1234567890"
   }
   

   votre webhook doit confirmer la valeur clientToken et, si clientToken est la bonne réponse. Renvoyez une réponse 200 OK avec 1234567890 sous la forme le corps de la réponse:

   // clientToken from Configure
   const myClientToken = "SJENCPGJESMGUFPY";
   
   // Example endpoint
   app.post("/rbm-webhook", (req, res) => {
     const msg = req.body;
     if (msg.clientToken === myClientToken) {
         res.status(200).send(msg.secret);
         return;
     }
     res.send(400);
   });
   

7. Dans la console développeur, cliquez sur Valider. Quand RBM valide votre webhook, la boîte de dialogue se ferme.

Vérifier les messages entrants

Étant donné que les webhooks peuvent recevoir des messages de n'importe quel expéditeur, vous devez vérifier que Google a envoyé des messages entrants avant de traiter leur contenu.

Pour vérifier que Google a envoyé un message que vous avez reçu, procédez comme suit:

1. Extrayez l'en-tête X-Goog-Signature du message. Il s'agit d'une valeur hachée, de la charge utile du corps du message, encodée en base64.
2. Décodez la charge utile RBM en base64 dans l'élément message.body de la requête.
3. À l'aide du jeton client du webhook (que vous avez spécifié lors de la configuration webhook) comme clé, créez un code HMAC SHA512 des octets du code décodé en base64. et encodez le résultat en base64.
4. Comparez le hachage X-Goog-Signature à celui que vous avez créé.
   • Si les hachages correspondent, vous avez confirmé que Google a envoyé le message.

   • Si les valeurs de hachage ne correspondent pas, vérifiez votre processus de hachage sur une propriété connue .

     Si votre processus de hachage fonctionne correctement et que vous recevez une qui vous a été envoyé de manière frauduleuse, nous contacter.

Node.js

  if ((requestBody.hasOwnProperty('message')) && (requestBody.message.hasOwnProperty('data'))) {
    // Validate the received hash to ensure the message came from Google RBM
    let userEventString = Buffer.from(requestBody.message.data, 'base64');
    let hmac = crypto.createHmac('sha512', CLIENT_TOKEN);
    let data = hmac.update(userEventString);
    let genHash = data.digest('base64');
    let headerHash = req.header('X-Goog-Signature');

    if (headerHash === genHash) {
      let userEvent = JSON.parse(userEventString);

      console.log('userEventString: ' + userEventString);
      handleMessage(userEvent);
    } else {
      console.log('hash mismatch - ignoring message');
    }
  }

  res.sendStatus(200);
  

Étapes suivantes

Maintenant que votre compte de partenaire est configuré, vous pouvez créer votre premier agent.