Flux de conversation

L'envoi et la réception de messages et d'événements sont les aspects essentiels de la communication entre un agent et un utilisateur. Les agents envoient des messages, des événements et des requêtes aux utilisateurs via des requêtes HTTP POST à l'API RBM, mais reçoivent les messages et les événements créés par l'utilisateur au niveau du webhook configuré.

Vous trouverez ci-dessous un exemple de flux de conversation qui utilise des exemples de données pour illustrer comment les messages, les événements et les requêtes peuvent créer des interactions utiles et significatives.

Bonjour !

Dans cet exemple, l'agent envoie Hello, World! en tant que message à l'utilisateur, lequel répond avec Hello to you!.

1. L'agent envoie une requête de vérification des fonctionnalités pour vérifier que l'appareil de l'utilisateur est compatible avec RBM.

   L'agent envoie:

   GET
   /v1/phones/[phone]/capabilities?requestId=147547143069602483572&agentId=welcome-bot
   HTTP/1.1
   Host: us-rcsbusinessmessaging.googleapis.com
   Content-Type: application/json

2. La plate-forme RBM envoie à l'agent une réponse de vérification des fonctionnalités indiquant que l'appareil de l'utilisateur peut recevoir des messages RBM.

   L'agent reçoit les éléments suivants :

   {
     "rbmEnabled": true,
     "features": [
       "REVOCATION",
       "RICHCARD_STANDALONE",
       "RICHCARD_CAROUSEL",
       "ACTION_CREATE_CALENDAR_EVENT",
       "ACTION_DIAL",
       "ACTION_OPEN_URL",
       "ACTION_SHARE_LOCATION",
       "ACTION_VIEW_LOCATION"
      ]
   }

3. L'agent envoie le message Hello, World! à l'API RBM, qui le transmet à l'appareil de l'utilisateur.

   L'agent envoie les éléments suivants :

   POST
   /v1/phones/[phone]/agentMessages?messageId=123&agentId=welcome-bot
   HTTP/1.1
   Host: us-rcsbusinessmessaging.googleapis.com
   Content-Type: application/json
   {
     "contentMessage": {
       "text": "Hello, World!",
     }
   }

4. La plate-forme RBM envoie le message à l'appareil de l'utilisateur et envoie un événement DELIVERED à l'agent.

   L'agent reçoit les éléments suivants :

   {
     "senderPhoneNumber": "[phone]",
     "agentId": "[e-mail]",
     "eventType": "DELIVERED",
     "eventId": "Ms6oOiEli6QS-fe8QFrmhfIg",
     "messageId": "123"
   }

5. L'utilisateur ouvre le message sur son appareil, ce qui envoie un événement READ à l'agent.

   L'agent reçoit:

   {
     "senderPhoneNumber": "[phone]",
     "agentId": "[e-mail]",
     "eventType": "READ",
     "eventId": "Ms6oOiEli6QS-ge9ZFsmgTj",
     "messageId": "123"
   }

6. L'utilisateur rédige et envoie une réponse à l'agent.

   L'agent reçoit les éléments suivants :

   {
     "senderPhoneNumber": "[phone]",
     "agentId": "[e-mail]",
     "messageId": "msg000999888777a",
     "sendTime": "2018-12-31T15:01:23.045123456Z",
     "text": "Hello to you!",
   }

7. La plate-forme RBM envoie automatiquement un événement DELIVERED à l'appareil de l'utilisateur lorsqu'elle reçoit son message.

8. L'agent envoie un événement READ en réponse au message de l'utilisateur pour l'informer qu'il a été reçu et confirmé.

   L'agent envoie les éléments suivants :

   POST
     /v1/phones/[phone]/agentEvents?eventId=1234&agentId=welcome-bot
     HTTP/1.1
     Host: us-rcsbusinessmessaging.googleapis.com
     Content-Type: application/json
     {
       "eventType": "READ",
       "messageId": "msg000999888777a"
   }