Fluxos de conversa

O envio e o recebimento de mensagens e eventos são os principais aspectos da comunicação entre um agente e um usuário. Os agentes enviam mensagens, eventos e solicitações para usuários por meio de solicitações HTTP POST para a API RBM, mas recebem mensagens e eventos criados pelo usuário como JSON do Cloud Pub/Sub.

Veja abaixo um exemplo de fluxo de conversa que usa dados de amostra para ilustrar como mensagens, eventos e solicitações podem criar interações úteis e significativas.

Olá, mundo!

Neste exemplo, o agente envia Hello, World! como uma mensagem ao usuário, e o usuário responde com Hello to you!.

1. O agente envia uma solicitação de verificação de capacidade para verificar se o dispositivo do usuário é compatível com RBM.

   O agente envia o seguinte:

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

2. A plataforma RBM envia ao agente uma resposta de verificação de capacidade indicando que o dispositivo do usuário pode receber mensagens RBM.

   O agente recebe:

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

3. O agente envia a mensagem Hello, World! para a API RBM, que a transmite para o dispositivo do usuário.

   O agente envia o seguinte:

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

4. A plataforma RBM envia a mensagem para o dispositivo do usuário e um evento DELIVERED para o agente.

   O agente recebe:

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

5. O usuário abre a mensagem no dispositivo, que envia um evento READ para o agente.

   O agente recebe:

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

6. O usuário escreve e envia uma resposta ao agente.

   O agente recebe:

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

7. A plataforma RBM envia automaticamente um evento DELIVERED ao dispositivo do usuário quando ele recebe a mensagem.

8. O agente envia um evento READ em resposta à mensagem do usuário para informar que ele foi recebido e confirmado.

   O agente envia o seguinte:

   {
     "eventType": "READ",
     "messageId": "msg000999888777a"
   }