Configurer votre compte partenaire

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

Mettre à jour les informations du compte partenaire

Sur la page Paramètres, vous pouvez afficher votre ID partenaire et modifier les informations suivantes :

Champ Description
Nom du partenaire Nom de votre compte partenaire
Nom à afficher Le nom s'affichera dans les rapports de facturation que les opérateurs reçoivent (dans le champ owner_name ). Les opérateurs l'utiliseront pour vous identifier en tant que partenaire de confiance et générer les informations de facturation correctes pour votre utilisation de RCS for Business afin de contacter leurs abonnés. Le nom que vous fournissez ici doit correspondre à celui utilisé dans vos contrats de messagerie avec les opérateurs.
Contact en cas de problème technique

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

  • 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 la modifier. Lorsque vous configurez votre partenaire webhook, il s'applique à tous vos agents. Si vous souhaitez utiliser un webhook différent pour un agent individuel, vous pouvez configurer un webhook d'agent qui ne s'appliquera qu'à cet agent.

Gérer les marques

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

Utilisez la page Marques des 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 vos modifications, 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 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 dispose du rôle de propriétaire. Les nouveaux utilisateurs peuvent disposer du rôle de responsable ou de lecteur.

  • Les responsables peuvent accéder à toutes les fonctionnalités de la console pour les développeurs afin de gérer tous les agents appartenant au compte partenaire.
  • Les lecteurs disposent d'un accès en lecture seule à la console pour les développeurs afin d'afficher 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 dans 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 dans 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 effectuez des appels à l'API RBM, vous les authentifiez à l'aide d'une clé de compte de service. Cette clé vous permet de créer et de gérer des marques et des agents, ainsi que d'envoyer des messages et des requêtes en tant qu'agent. Un compte de service peut compter jusqu'à 10 clés.

Pour authentifier les appels d'API de manière sécurisée, 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 les 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 votre clé de compte de service dans un emplacement privé et sécurisé. Ne partagez pas votre clé publiquement. Vous en aurez besoin ultérieurement pour accéder aux API RBM.

Configurer votre webhook partenaire

Pour savoir comment configurer votre webhook partenaire, consultez le guide Webhooks.

Pour obtenir des conseils sur le traitement asynchrone des webhooks afin d'éviter les échecs de distribution, consultez la section Traitement 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 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 en base64 la charge utile RBM 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 sa configuration) comme clé, créez un HMAC SHA512 des octets de la charge utile du message décodé en base64, puis encodez le résultat en base64.
  4. Comparez le hachage X-Goog-Signature avec celui que vous avez créé.
    • Si les hachages correspondent, vous avez confirmé que Google a envoyé le message.

    • Si les hachages ne correspondent pas, vérifiez votre processus de hachage sur un message dont vous savez qu'il est valide.

      Si votre processus de hachage fonctionne correctement et que vous recevez un message que vous pensez avoir é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
    const headerHash = req.header('X-Goog-Signature');
    const userEventString = Buffer.from(requestBody.message.data, 'base64');
    const hmac = crypto.createHmac('sha512', myClientToken);
    const genHash = hmac.update(userEventString).digest('base64');

    if (headerHash === genHash) {
      const userEvent = JSON.parse(userEventString);
      const webhookType = req.header('X-Goog-Webhook-Type');

      // Route based on the header type
      if (webhookType === 'message_callback') {
        handleMessage(userEvent);
      } else if (webhookType === 'agent_callback') {
        handleAgentEvent(userEvent);
      }
    } else {
      console.log('Hash mismatch - ignoring message');
      res.sendStatus(401);
      return;
    }
  }

  res.sendStatus(200);

Étapes suivantes

Maintenant que votre compte partenaire est configuré, il est temps de créer votre premier agent.

Précédent
S'inscrire en tant que partenaire
Suivant
Créer votre premier agent