Créer votre premier agent

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.

Flux d'un message dans une conversation compatible avec la RBM

Prérequis

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

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 l'activer 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

L'API RBM est compatible avec trois points de terminaison régionaux pour aider les entreprises à respecter les exigences régionales et commerciales. Les agents RBM peuvent exister dans l'une des trois régions suivantes:

  • Amérique du Nord
  • Europe
  • Asie-Pacifique

Lorsque vous créez votre agent, choisissez sa région en fonction des réglementations et des exigences applicables, et de la proximité avec les utilisateurs finaux. Notez que la région n'est pas spécifique au pays. Il identifie la zone dans laquelle votre agent opère. Google utilise ces informations pour déterminer où stocker les données des messages et comment acheminer le trafic des messages de manière appropriée.

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

Les opérateurs qui approuvent le contenu RBM sur leurs réseaux facturent également la diffusion de messages RBM à leurs abonnés à l'aide de ce framework de facturation:

  • Conversational (Conversationnel) : frais facturés pour une conversation composée de plusieurs messages A2P et P2A sur une période donnée.
  • Message unique : frais facturés pour un seul message contenant du contenu RBM enrichi (par exemple, un message contenant une carte ou un carrousel enrichis).
  • Message de base : tarif appliqué pour un message en texte brut de 160 caractères maximum.

Lorsque vous créez votre agent, choisissez la catégorie de facturation qui correspond le mieux au comportement de votre logique d'agent:

  • Conversationnel : cet agent engage des interactions utilisateur complexes où des messages sont échangés dans les deux sens.

Les deux catégories suivantes ne créent jamais d'événements de facturation par conversation. Les opérateurs facturent un prix de message de base ou un prix de message unique pour chaque message, en fonction du contenu diffusé.

  • Message unique : cet agent envoie généralement des messages riches et ne s'attend que rarement à recevoir des réponses.
  • Message de base : cet agent implémente la migration des SMS vers RBM et ne s'attend que rarement à recevoir des réponses. En règle générale, l'agent doit envoyer des messages de texte bruts de 160 caractères maximum. Toutefois, l'agent n'est pas limité. Il peut envoyer du contenu plus riche s'il est programmé pour le faire et sera facturé en conséquence.

Vous pouvez modifier la catégorie de facturation de votre agent avant de le lancer. Contactez-nous pour discuter du changement de catégorie de facturation.

Identifier le cas d'utilisation de l'agent

Chaque agent RBM doit disposer d'un cas d'utilisation prédéfini qui reflète la nature des conversations qu'il doit avoir avec les utilisateurs finaux et qui aide les entreprises à respecter les règles métier. 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
  • Transactionnelles: notifications, mises à jour ou alertes permettant de partager des informations directement pertinentes pour les services ou produits existants d'un client, telles que des alertes pour des activités suspectes sur un compte, des confirmations d'achat et des 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: flux conversationnels qui combinent des cas d'utilisation transactionnels et promotionnels, par exemple envoyer une notification de compte, puis proposer une remise ou une mise à niveau pour un nouveau produit et service.

Consultez Choisir le bon cas d'utilisation pour obtenir une description plus détaillée des cas d'utilisation à utiliser.

Une fois votre agent envoyé pour être lancé, vous ne pouvez plus modifier le cas d'utilisation. Veillez à consulter les cas d'utilisation et les règles métier 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.

  1. Ouvrez la console de développement Business Communications et connectez-vous avec votre compte Google de partenaire RBM.
  2. Cliquez sur Create Agent (Créer un agent).
  3. Pour Type d'agent, sélectionnez RCS Business Messaging.
  4. Pour Marque, sélectionnez la marque que votre agent représentera ou cliquez sur Ajouter une marque et saisissez son nom.
  5. Saisissez le nom de votre agent, puis sélectionnez sa région, sa catégorie de facturation et son cas d'utilisation. Cliquez ensuite sur Créer un agent.
  6. Lorsque votre agent est disponible, cliquez sur son nom.

Une fois votre agent disponible, vous pourrez ajouter des informations sur votre établissement et votre branding. Consultez la section Agents.

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, +14155555555.
  • 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.

Précédent
Configurer votre compte partenaire