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: Borrador de mensajes, medios 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 de estilo RBM utilizando puntos finales y cargas útiles de Vonage.
El agente envía una solicitud de comprobación de capacidades
Antes de enviar RCS, Verifique que el dispositivo del usuario es 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 API Messages.
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"
}