Une fois 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 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 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 sur la facturation RBM 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 s'assurer qu'ils génèrent les informations de facturation correctes pour vous permettre d'utiliser RBM afin de toucher leurs abonnés. Le nom que vous indiquez ici doit correspondre à celui utilisé dans vos contrats avec les services de messagerie par 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
|
Webhook | Il s'agit de l'URL du point de terminaison du webhook. Cliquez sur **Configurer** pour le mettre à jour. Lorsque vous configurez votre webhook partenaire, il s'applique à tous vos agents. Si vous souhaitez utiliser un autre webhook 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 RBM, vous pouvez créer des agents au nom de marques.
Accédez à la page Marques des Paramètres du compte pour ajouter, modifier ou supprimer des 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:
- Cochez la case à côté du nom de la marque.
- Cliquez sur le bouton , puis sur Modifier le nom.
- 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 des paramètres du compte vous permet de gérer les utilisateurs de votre compte partenaire. L'utilisateur qui a créé le compte partenaire a le rôle de 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 développeur pour gérer tous les agents appartenant au compte partenaire.
- Les lecteurs disposent d'un accès en lecture seule à la Developer Console pour 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 et sélectionnez son rôle.
Lorsque vous ajoutez un utilisateur, celui-ci reçoit un e-mail l'informant qu'il a accès au compte partenaire.
Supprimer un utilisateur
Pour supprimer un utilisateur :
- Recherchez l'utilisateur que vous souhaitez supprimer, puis cliquez sur le bouton dans la ligne de sa table.
- Sélectionnez Supprimer l'utilisateur.
- 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 doté d'un 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 mettre à jour le rôle d'un utilisateur:
- Recherchez l'utilisateur que vous souhaitez mettre à jour, puis cliquez sur le bouton dans la ligne de sa table.
- Sélectionnez Modifier le rôle.
- Choisissez un nouveau rôle dans la liste déroulante.
- Cliquez sur Enregistrer.
Configurez 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 requêtes en tant qu'agent.
Pour générer une clé de compte de service, procédez comme suit:
- Dans Paramètres du compte, accédez à la page 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 la clé de votre compte de service dans un emplacement privé et sécurisé. Ne la partagez pas publiquement. Vous en aurez besoin ultérieurement pour accéder aux API RBM.
Configurer le webhook 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. Une fois le webhook configuré, vous pouvez commencer à recevoir des messages et des événements.
Pour configurer le webhook partenaire, procédez comme suit:
Ouvrez la console pour les développeurs Business Communications et connectez-vous avec votre compte Google partenaire RBM.
Ouvrez Paramètres du compte.
Dans le champ URL du webhook RCS Business Messaging, cliquez sur Configurer.
Dans le champ URL du point de terminaison du webhook, saisissez l'URL du webhook commençant par "https://".
Notez la valeur
clientToken
. Vous en aurez besoin pour vérifier que les messages que vous recevez proviennent bien de Google.Configurez votre webhook pour qu'il accepte une requête
POST
avec le paramètreclientToken
spécifié et envoie une réponse200 OK
avec la valeur en texte brut du paramètresecret
dans le corps de la réponse.Par exemple, si votre webhook reçoit une requête
POST
avec le corps de contenu suivant :{ "clientToken":"SJENCPGJESMGUFPY", "secret":"1234567890" }
Votre webhook doit alors confirmer la valeur
clientToken
et, siclientToken
est correct, renvoyer une réponse200 OK
avec1234567890
dans 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); });
Dans la console développeur, cliquez sur Valider. Lorsque RBM vérifie 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 le contenu des messages.
Pour vérifier que Google a envoyé un message que vous avez reçu, procédez comme suit:
- 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. - Décodez en base64 la charge utile RBM dans l'élément
message.body
de la requête. - À l'aide du jeton client du webhook (que vous avez spécifié lors de la configuration du webhook) en tant que clé, créez un HMAC SHA512 des octets de la charge utile du message décodé en base64 et encodez le résultat en base64.
- Comparez le hachage
X-Goog-Signature
à celui que vous avez créé.- Si les hachages correspondent, vous confirmez que Google a envoyé le message.
Si les hachages ne correspondent pas, vérifiez votre processus de hachage sur un message connu comme correct.
Si le 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é, vous pouvez créer votre premier agent.