Fluxos de conversação do RCS

Este guia orienta você na concepção e implementação de fluxos de conversação RCS usando a Messages API, com exemplos práticos e melhores práticas para a criação de jornadas conversacionais.

O que é um fluxo de conversação do RCS?

Um fluxo de conversação do RCS é uma sequência estruturada de mensagens e interações do usuário. Ele orienta os usuários ao longo de um processo, como realizar uma compra, obter suporte ou receber atualizações, por meio do uso de mídia rica, respostas sugeridas e lógica automatizada.

A sequence flow of a message from an agent and a response from a user.

Planejando seu fluxo de RCS

  1. Definir o caso de uso: Identifique o objetivo (por exemplo, suporte, vendas, notificações).
  2. Mapeie a jornada: Descreva cada etapa, cada opção do usuário e o resultado esperado.
  3. Preparar o conteúdo: Rascunhos de mensagens, arquivos de mídia e opções de resposta.
  4. Automate Logic: Use webhooks e lógica de back-end para processar as entradas do usuário e acionar respostas.

Siga estas etapas para implementar um fluxo de conversa preciso no estilo RBM usando terminais e cargas úteis da Vonage.

O agente envia uma solicitação de verificação de capacidade

Antes de enviar uma mensagem RCS, Verify se o dispositivo do usuário é compatível com RBM.

O agente envia:

POST /v1/channel-manager/rcs/agents/welcome-bot/devices/capabilities 
HTTP/1.1
Host: api-us.vonage.com
Authorization: Bearer {JWT}
Content-Type: application/json

O agente recebe a resposta da verificação de capacidade

A plataforma indica que o dispositivo pode receber mensagens RBM.

O agente recebe:

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

O agente envia “Hello, World!”

Envie uma mensagem de texto RCS por meio da Messages API.

O agente envia:

POST /v1/messages 
HTTP /1.1
Host: api-us.vonage.com
Authorization: Bearer {JWT}
Content-Type: application/json
{
   "message_type": "text",
   "text": "Hello, World!",
   "to": "12223334444",
   "from": "welcome-bot",
   "channel": "rcs"
}

A plataforma envia o evento DELIVERED

A mensagem é entregue ao usuário e um evento de entrega é enviado ao seu webhook de status.

O agente recebe:

{
  "messageuuid": "3ca4b881-3e11-46bd-b491-76740a62639a",
  "to": "12223334444",
  "from": "welcome-bot",
  "timestamp": "2026-02-02T12:00:04Z",
  "status": "delivered",
  "channel": "rcs"
}

A plataforma envia um evento READ

O usuário abre a mensagem. Um evento de leitura é enviado ao seu webhook de status.

O agente recebe:

{
  "messageuuid": "3ca4b881-3e11-46bd-b491-76740a62639a",
  "to": "12223334444",
  "from": "welcome-bot",
  "timestamp": "2026-02-02T12:01:10Z",
  "status": "read",
  "channel": "rcs"
}

O usuário envia uma resposta

O usuário envia uma mensagem. A Vonage a encaminha para o seu webhook de entrada.

O agente recebe:

{
  "to": "welcome-bot",
  "from": "12223334444",
  "channel": "rcs",
  "message_uuid": "aaaaaaaa-bbbb-cccc-dddd-0123456789ab",
  "timestamp": "2026-02-02T12:02:23Z",
  "message_type": "text",
  "text": "Hello to you!"
}

A plataforma confirma o recebimento da entrega

As mensagens recebidas são entregues ao seu webhook (confirmadas implicitamente por meio do recibo do webhook). Use a carga útil do webhook para direcionar a conversa e registrar o evento.

O agente envia uma confirmação de leitura

Confirme o recebimento da mensagem do usuário, marcando-a como lida.

O agente envia:

PATCH /v1/messages/aaaaaaaa-bbbb-cccc-dddd-0123456789ab 
HTTP/1.1
Host: api-us.vonage.com
Authorization: Bearer {JWT}
Content-Type: application/json
{
  "status": "read"
}

Mais informações