Flujos de conversación RCS
Esta guía le guía a través del diseño y la implementación de flujos de conversación RCS utilizando la Messages API, con ejemplos prácticos y las mejores prácticas para la construcción de viajes conversacionales.
¿Qué es un flujo de conversación RCS?
Un flujo de conversación RCS es una secuencia estructurada de mensajes e interacciones de usuario. Guía a los usuarios a través de un proceso, como realizar una compra, obtener asistencia o recibir actualizaciones, mediante el uso de medios enriquecidos, respuestas sugeridas y lógica automatizada.
Diseñar su flujo RCS
- Definir el caso de uso: Identifique el objetivo (por ejemplo, asistencia, ventas, notificaciones).
- Trazar el viaje: Resuma cada paso, la elección del usuario y el resultado esperado.
- Prepare el contenido: Borradores de mensajes, archivos multimedia y opciones de respuesta.
- Automatizar la lógica: Utilice webhooks y lógica de backend para gestionar las entradas de los usuarios y desencadenar respuestas.
Sigue estos pasos para implementar un flujo de conversación preciso al estilo RBM utilizando los terminales y las cargas útiles de Vonage.
El agente envía una solicitud de comprobación de capacidades
Antes de enviar un mensaje RCS, Verify que el dispositivo del usuario sea compatible con RBM.
El agente envía:
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
Agente recibe respuesta de comprobación de capacidad
La plataforma indica que el dispositivo puede recibir mensajes RBM.
El agente recibe:
{
"rcs_supported": true,
"features": [
"RICHCARD_STANDALONE",
"ACTION_CREATE_CALENDAR_EVENT",
"ACTION_DIAL",
"ACTION_OPEN_URL",
"ACTION_SHARE_LOCATION",
"ACTION_VIEW_LOCATION",
"RICHCARD_CAROUSEL"
]
}
El agente envía «¡Hola, mundo!»
Envía un mensaje de texto RCS a través de la Messages API.
El agente envía:
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"
}
La plataforma envía el evento ENTREGADO
El mensaje se entrega al usuario y se envía un evento de entrega a su webhook de estado.
El agente recibe:
{
"messageuuid": "3ca4b881-3e11-46bd-b491-76740a62639a",
"to": "12223334444",
"from": "welcome-bot",
"timestamp": "2026-02-02T12:00:04Z",
"status": "delivered",
"channel": "rcs"
}
La plataforma envía el evento READ
El usuario abre el mensaje. Se envía un evento de lectura a su webhook de estado.
El agente recibe:
{
"messageuuid": "3ca4b881-3e11-46bd-b491-76740a62639a",
"to": "12223334444",
"from": "welcome-bot",
"timestamp": "2026-02-02T12:01:10Z",
"status": "read",
"channel": "rcs"
}
El usuario envía una respuesta
El usuario envía un mensaje. Vonage lo entrega a tu webhook de entrada.
El agente recibe:
{
"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!"
}
La plataforma reconoce la entrega entrante
Los mensajes entrantes se envían a su webhook (con acuse de recibo implícito a través del webhook). Utilice la carga útil del webhook para enrutar la conversación y registrar el evento.
El agente envía un acuse de recibo de lectura
Acuse recibo del mensaje del usuario marcándolo como leído.
El agente envía:
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"
}