Configurer votre compte partenaire

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

Mettre à jour les informations du compte partenaire

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

Champ Description
Nom du partenaire Nom de votre compte partenaire
Nom à afficher Le nom apparaîtra dans les rapports de facturation RBM que les opérateurs reçoivent (en tant que champ owner_name). Les opérateurs l'utiliseront pour vous identifier en tant que partenaire de confiance et pour s'assurer qu'ils génèrent les informations de facturation appropriées pour votre utilisation de la RBM afin de toucher leurs abonnés. Le nom que vous indiquez ici doit correspondre à celui utilisé dans vos contrats de messagerie avec votre opérateur.
Contact en cas de problème technique

Personne que Google contactera en cas de problème technique avec vos agents. Vous pouvez mettre à jour les informations suivantes :

  • Nom
  • Adresse e-mail professionnelle
  • Numéro de téléphone
Webhook Il s'agit de l'URL de votre point de terminaison de webhook. Cliquez sur Configurer pour le mettre à jour. Lorsque vous configurez le webhook de votre partenaire, il s'applique à tous vos agents. Si vous souhaitez utiliser un webhook différent pour un agent spécifique, vous pouvez configurer un webhook d'agent qui ne s'appliquera qu'à cet agent.

Gérer les marques

En tant que partenaire RBM, vous pouvez créer des agents pour le compte de marques.

Utilisez la page Marques dans les paramètres du compte pour ajouter, modifier et 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

Vous ne pouvez pas supprimer une marque si elle est associée à un agent, même si l'agent 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 des paramètres du compte vous permet de gérer les utilisateurs de votre compte partenaire. L'utilisateur qui a créé le compte partenaire en est le propriétaire. Les nouveaux utilisateurs peuvent avoir le rôle de gestionnaire ou de lecteur.

  • Les administrateurs peuvent accéder à toutes les fonctionnalités de la console de développement pour gérer tous les agents appartenant au compte partenaire.
  • Les lecteurs ont un accès en lecture seule à la console pour les développeurs, ce qui leur permet de consulter tous les agents appartenant au compte partenaire.

Ajouter un utilisateur

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

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

Supprimer un utilisateur

Pour supprimer un utilisateur :

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

L'utilisateur que vous avez supprimé reçoit un e-mail l'informant qu'il n'a plus 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 contacter l'assistance.

Modifier le rôle d'un utilisateur

Pour modifier le rôle d'un utilisateur:

  1. Recherchez l'utilisateur que vous souhaitez modifier, puis cliquez sur le bouton  sur sa ligne de tableau.
  2. Sélectionnez Modifier le rôle.
  3. Choisissez un nouveau rôle dans le menu déroulant.
  4. Cliquez sur Enregistrer.

Configurer un 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 et de gérer des marques et des agents, et d'envoyer des messages et des demandes en tant qu'agent. Un compte de service peut compter jusqu'à 10 clés.

Pour authentifier de manière sécurisée les appels d'API, vous avez également besoin de l'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 la clé du compte de service.

Stockez la clé de votre compte de service dans un emplacement sécurisé et privé. Ne partagez pas votre clé en mode public. Vous aurez besoin de cette clé plus tard pour accéder aux API RBM.

Configurer le webhook de votre partenaire

Un webhook est un rappel HTTPS créé par un partenaire qui spécifie comment votre agent doit répondre aux messages et aux événements. Une fois votre webhook configuré, vous pouvez commencer à recevoir des messages et des événements.

Si vous souhaitez utiliser un webhook différent pour l'un de vos agents, vous pouvez configurer un webhook au niveau de l'agent qui remplacera le webhook du partenaire. Pour en savoir plus, consultez la section Configurer un webhook d'agent.

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

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

  2. Ouvrez les paramètres du compte.

  3. Pour URL du webhook RCS Business Messaging, cliquez sur Configurer.

  4. Dans 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 le paramètre clientToken spécifié et qu'il renvoie 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":"1234567890"
    }
    

    Votre webhook doit alors confirmer la valeur clientToken et, si clientToken est correct, renvoyer une réponse 200 OK avec 1234567890 comme 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 pour les développeurs, cliquez sur Valider. Lorsque RBM valide votre webhook, la boîte de dialogue se ferme.

Pour gérer les échecs d'envoi des webhooks et assurer un traitement fiable des messages, consultez la section Gestion des messages.

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é les messages entrants avant de traiter leur contenu.

Pour vérifier que Google a bien 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 copie hachée et encodée en base64 de la charge utile du corps du message.
  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 de votre webhook (que vous avez spécifié lors de la configuration de votre webhook) comme clé, créez un HMAC SHA512 des octets de la charge utile du message décodée en base64 et encodez le résultat en base64.
  4. Comparez le hachage X-Goog-Signature au hachage que vous avez créé.
    • Si les hachages correspondent, vous confirmez que Google a bien envoyé le message.
    • Si les hachages ne correspondent pas, vérifiez votre processus de hachage sur un message connu.

      Si votre processus de hachage fonctionne correctement et que vous recevez un message qui, selon vous, vous a été envoyé de manière frauduleuse, contactez-nous.

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 partenaire est configuré, il est temps de créer votre premier agent.