Créer votre premier agent

Agent Entité programmatique qui envoie des messages aux utilisateurs au nom d'une marque. L'agent inclut toute interface avec laquelle les utilisateurs interagissent, ainsi que tout code ou infrastructure requis pour alimenter l'interaction. Les agents peuvent fournir une expérience simple à sens unique, comme l'envoi d'une notification, ou être conversationnels et réagir aux réponses des utilisateurs dans un échange.

Les utilisateurs interagissent avec les agents via une application de chat compatible avec le RCS, telle que Google Messages, sur leurs appareils. Dans ce guide de démarrage rapide, vous allez créer un agent RBM de base capable d'envoyer un message simple à un appareil de test et de recevoir une réponse.

Prérequis

Avant de commencer à utiliser votre agent, vous aurez besoin des éléments suivants:

• Nom de la marque que votre agent représentera
• Votre agent
  • Nom
  • Région dans laquelle l'agent fonctionnera
  • Catégorie de facturation
  • Cas d'utilisation
• Un appareil Android avec un numéro de téléphone actif
• Un ordinateur de développement pouvant exécuter un exemple de code

Configurer votre appareil de test

Pour communiquer avec un agent RBM non lancé, un appareil de test doit être compatible avec le RCS. Toutefois, tous les appareils Android ne peuvent pas recevoir de messages RCS par défaut. Vous pouvez vérifier l'état du RCS sur votre appareil et, si nécessaire, activer le RCS en configurant votre appareil avec des versions préliminaires des applications Messages et Carrier Services.

Vérifier l'état du RCS sur votre appareil

1. Dans l'application Messages, appuyez sur le bouton , puis sur Paramètres.

2. Appuyez sur Fonctionnalités de chat, puis recherchez la valeur État.

   Si l'état Status (État) indique Connected (Connecté), le RCS est actif sur votre appareil.

Étapes suivantes

Si le RCS est activé sur votre appareil, vous pouvez configurer votre agent. Si le RCS est inactif sur votre appareil, vous devez activer le RCS sur votre appareil avant de pouvoir tester votre agent RBM.

Configurer votre agent

Les agents RBM utilisent l'API RBM pour envoyer des messages, des événements et d'autres requêtes aux utilisateurs. Lorsque vous créez un agent, vous activez l'accès à l'API RBM et définissez les informations de base de votre agent.

Identifier la région de l'agent

Les agents RBM peuvent se trouver dans l'une des trois régions suivantes: Amérique du Nord, Europe et Asie-Pacifique. L'API RBM est compatible avec trois points de terminaison régionaux pour aider les entreprises à respecter les exigences régionales et commerciales.

Lorsque vous créez votre agent, choisissez la région de votre agent en fonction des réglementations et des exigences applicables, et de la proximité avec les utilisateurs finaux. Cette région détermine l'endroit depuis lequel votre agent opère et où il stocke ses données.

Si vous ou vos utilisateurs ne vous trouvez pas dans ces régions, choisissez la région la plus proche de vous pour réduire la latence. Exemple :

• Si vous résidez en Amérique latine, choisissez la région Amérique du Nord.
• Si vous vous trouvez en Afrique, choisissez la région Europe.
• Si vous vous trouvez en Australie, choisissez la région Asie-Pacifique.

Ne choisissez pas la région de votre agent en fonction de vos transporteurs cibles. Toutes les régions ont un accès égal aux transporteurs du monde entier.

Remarque :Une fois votre agent créé, vous ne pouvez plus modifier sa région.

Déterminer la catégorie de facturation de l'agent

Lorsque vous créez un agent RBM, vous devez spécifier sa catégorie de facturation en fonction de la façon dont l'agent interagira avec les utilisateurs. Choisissez la catégorie qui correspond le mieux au comportement prévu de votre agent:

• Conversationnel: pour les agents qui engagent des conversations multitours avec les utilisateurs.
• Message de base ou message unique: pour les agents qui envoient des messages sans s'attendre à des réponses fréquentes.

Remarque :Les deux catégories de facturation non conversationnelles, "Message de base" et "Message unique", fonctionnent exactement de la même manière. Il s'agit d'une particularité historique que nous essayons de simplifier. Pour le moment, n'hésitez pas à utiliser l'une ou l'autre de ces catégories pour vos messages non conversationnels, qu'ils soient en texte brut ou au format de carte enrichi. Vous serez facturé au tarif standard hors conversation. Pour en savoir plus, consultez Catégories de facturation des agents.

Vous ne pouvez modifier la catégorie de facturation de votre agent qu'avant de le lancer. Envoyez un e-mail à [e-mail] si vous devez modifier la catégorie de facturation après le lancement.

Pour en savoir plus sur le modèle de facturation RBM, consultez les questions fréquentes sur la facturation RBM.

Identifier le cas d'utilisation de l'agent

Chaque agent RBM doit disposer d'un cas d'utilisation prédéfini. Cela permet de catégoriser votre agent et d'appliquer les règles métier appropriées pour une bonne expérience utilisateur. RBM est compatible avec quatre cas d'utilisation:

• OTP: mot de passe à usage unique requis pour authentifier un compte ou confirmer une transaction de manière sécurisée.
• Transactionnel: notifications, mises à jour ou alertes qui partagent des informations directement pertinentes pour les services ou produits existants d'un client, telles que les alertes pour les activités suspectes sur un compte, les confirmations d'achat et les notifications de livraison.
• Promotional (promotionnel) : messages commerciaux, marketing et promotionnels destinés à de nouveaux clients ou à des clients existants, dans le but d'accroître la notoriété, l'engagement et les ventes.
• Multi-usage: conversations qui combinent des messages transactionnels et promotionnels, par exemple l'envoi d'une notification de compte suivie d'une offre de remise ou de l'achat d'un nouveau produit ou service.

Chaque cas d'utilisation est soumis à des règles différentes concernant les contenus que vous pouvez envoyer. Pour en savoir plus sur chaque cas d'utilisation et trouver celui qui convient le mieux à votre agent, consultez la section Choisir le bon cas d'utilisation pour votre agent.

Une fois que vous avez envoyé votre agent pour le lancement, vous ne pouvez plus modifier le cas d'utilisation. Vérifiez les cas d'utilisation et les règles commerciales de votre pays avant d'envoyer votre agent.

Créer l'agent

Suivez ces instructions pour créer votre agent dans la console des développeurs Business Communications.

Remarque :Pour créer un agent à l'aide de l'API RBM Management, consultez la documentation Gérer les agents.

Pour créer un agent, procédez comme suit :

1. Accédez à la console pour les développeurs Business Communications, puis connectez-vous avec votre compte Google de partenaire RBM.
2. Sur la page d'accueil, cliquez sur + Créer un agent.
3. Dans la fenêtre Nouvel agent RCS Business Messaging, indiquez les informations suivantes :
   • Marque que représente votre agent
   • Nom de l'agent
   • Région d'hébergement
   • Catégorie de facturation
   • Cas d'utilisation
4. Cliquez sur Create Agent (Créer un agent).

Une fois votre agent disponible, vous pourrez ajouter des informations sur votre établissement et votre branding. Consultez Créer votre agent.

Inviter votre appareil de test

Maintenant que vous avez un agent et que votre appareil de test est compatible avec le RCS, vous pouvez inviter votre appareil à tester votre agent.

1. Dans le panneau de navigation de gauche, cliquez sur Appareils.
2. Pour Ajouter des appareils de test, saisissez le numéro de téléphone de votre appareil, puis cliquez sur Ajouter.
3. Sur votre appareil de test, acceptez la demande du testeur pour votre agent.

Si vous ne recevez pas d'invitation sur votre appareil de test, vérifiez que le RCS est activé sur votre appareil.

Envoyer un message

Avec un appareil de test enregistré, votre agent peut désormais envoyer des messages.

Vous avez besoin d'une clé de compte de service pour authentifier de manière sécurisée les appels d'API. Si vous n'avez pas encore créé de clé de compte de service pour votre compte partenaire, c'est le moment de le faire.

Dans un terminal de votre ordinateur de développement, exécutez la commande suivante:

curl -X POST "https://REGION-rcsbusinessmessaging.googleapis.com/v1/phones/PHONE_NUMBER/agentMessages?messageId=MESSAGE_ID&agentId=AGENT_ID" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/rcs-business-messaging" \
-H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY rcsbusinessmessaging`" \
-d '{
  "contentMessage": {
    "text": "Hello, world!"
  }
}'

• Remplacez REGION par asia, europe ou us, en fonction de la région de votre agent.
• Remplacez PHONE_NUMBER par le numéro de téléphone de votre appareil de test. Incluez le code pays, l'indicatif régional et un + au début, mais n'incluez pas de séparateurs. Par exemple, [phone].
• Remplacez AGENT ID par votre ID d'agent, qui se trouve sur la page Informations sur l'agent de la console pour les développeurs Business Communications.
• Remplacez PATH_TO_SERVICE_ACCOUNT_KEY par le chemin d'accès à la clé que vous avez créée précédemment.

Vous devriez recevoir un message "Hello, world!" de la part de votre agent sur votre appareil de test. Si vous ne recevez pas de message sur votre appareil de test, vérifiez que vous avez correctement saisi et mis en forme le numéro de téléphone et le chemin d'accès à la clé de votre compte de service dans la commande.

Pour envoyer différents types de messages, tels que des réponses suggérées et des fiches enrichies, consultez Envoyer des messages.

Étapes suivantes

Maintenant que votre agent peut envoyer des messages à un appareil de test, il est temps de créer quelque chose qui répond à vos besoins métier. Obtenez un exemple d'agent dans la langue de votre choix et suivez les instructions du fichier README de l'exemple.

Une fois l'exemple d'agent configuré, consultez les bonnes pratiques de RBM et découvrez comment les agents envoient et reçoivent des messages.