Cómo Enviar Carruseles RCS con Node.js

Introducción Rich Communication Services RCS ofrece herramientas para crear experiencias de marca modernas e interactivas directamente dentro de la aplicación de mensajería predeterminada del usuario. Una de sus funcionalidades más potentes es el carrusel de tarjetas enriquecidas un conjunto horizontal de tarjetas desplazables que pueden incluir vídeo imagen texto y acciones táctiles. En este artículo aprenderás cómo enviar un carrusel RCS con Node.js y la Vonage Messages API combinando tarjetas con vídeo e imagen y acciones para aumentar la interacción.

Caso práctico Anuncio popup de moda imagina que tu marca lanza una tienda popup de edición limitada y quieres generar expectación y mostrar piezas clave. Con un carrusel RCS puedes empaquetar todo en un mensaje interactivo limpio. Ejemplo de carrusel: tarjeta 1 tráiler en vídeo con acciones guardar fecha y ver ubicación tarjeta 2 imagen de camisetas acción ver todas las camisetas tarjeta 3 imagen de gorras acción ver todas las gorras.

Qué es un carrusel RCS Un carrusel RCS es un conjunto de tarjetas enriquecidas que se deslizan horizontalmente y cada tarjeta puede tener título (máx 200 caracteres) descripción (máx 2000 caracteres) media imagen o vídeo y hasta cuatro respuestas o acciones sugeridas. Notas importantes todas las tarjetas del carrusel deben usar el mismo tipo de sugerencia los archivos multimedia deben ser accesibles públicamente vía HTTPS y pesar menos de 100MB y puedes enviar entre 2 y 10 tarjetas por carrusel.

Requisitos previos antes de comenzar necesitarás Node.js instalado ngrok para exponer tu servidor local una cuenta Vonage un agente RBM registrado (Cuentas gestionadas) y un teléfono con capacidades RCS para pruebas.

Cuenta Vonage y modos de prueba necesitas una cuenta Vonage para obtener tu API Key API Secret Application ID y la private key. RCS mediante Vonage está disponible actualmente solo para cuentas gestionadas contacta a tu gestor de cuenta para solicitar activación de Developer Mode en tu agente RBM y poder probar en números allow list antes de la verificación del agente y el lanzamiento en producción.

Cómo configurar tu proyecto Node.js crea un directorio inicializa npm e instala dependencias esenciales express para el servidor dotenv para variables de entorno y @vonage/server-sdk para enviar mensajes vía Vonage. Crea los archivos principales como index.js y un archivo .env con tus credenciales VONAGE_APPLICATION_ID VONAGE_API_SIGNATURE_SECRET VONAGE_PRIVATE_KEY RCS_SENDER_ID y PORT además coloca el fichero private.key en la raíz del proyecto.

Enviar un carrusel RCS con Node.js monta un servidor Express que importe express dotenv y @vonage/server-sdk carga las variables de entorno e inicializa el cliente Vonage. Construye un endpoint que envíe un mensaje RCS con una estructura de carrusel que incluya tres tarjetas cada una con media título descripción y botones de acción postbackData openUrlAction o createCalendarEventAction. Recuerda mantener cada archivo multimedia en HTTPS accesible públicamente y por debajo de 100MB y preferiblemente servido desde un CDN o almacenamiento cloud para producción.

Recepción de interacciones mediante webhooks para saber qué acción escogió el usuario implementa un endpoint entrante que valide la firma JWT de Vonage procese la propiedad button del payload y almacene el postbackData para tu lógica empresarial. Esto te permitirá registrar selecciones de usuarios y disparar procesos como abrir ubicaciones crear eventos en calendario o iniciar flujos personalizados en tu backend.

Exponer el servidor con ngrok para recibir webhooks ejecuta ngrok http en el puerto del servidor y toma la URL HTTPS que proporciona ngrok por ejemplo https://subdominio.ngrok.io. Usa esa URL como Inbound URL en la configuración de la aplicación Vonage para que los eventos lleguen a tu servidor local.

Crear y configurar la aplicación Vonage en el Dashboard crea una nueva aplicación activa la capacidad Messages genera la clave pública y privada establece la Inbound URL apuntando a https://TU_NGROK_URL/inbound_rcs y configura la Status URL para estados de mensaje guarda la private.key en tu proyecto y enlaza tu agente RBM en la pestaña de cuentas externas.

Probar tu aplicación usa curl o Postman para llamar al endpoint que dispara el carrusel reemplazando los placeholders con los valores reales. En el teléfono receptor aparecerá el carrusel RCS y el usuario podrá seleccionar acciones que llegarán a tu webhook para su procesamiento.

Buenas prácticas y ampliaciones mantén los medios en un hosting rápido usa nombres de postback concisos de menos de 50 caracteres gestiona los permisos y el proceso de verificación del agente RBM y responde a los taps para ofrecer experiencias conversacionales dinámicas. Puedes cargar tarjetas dinámicamente desde una API añadir filtros por ubicación o categoría y combinar con mapas eventos prellenados o flujos avanzados de IA.

Sobre Q2BSTUDIO En Q2BSTUDIO somos una empresa de desarrollo de software especializada en aplicaciones a medida y software a medida además de ofrecer soluciones avanzadas de inteligencia artificial y servicios de ciberseguridad. Desarrollamos integraciones RCS y soluciones conversacionales que combinan agentes IA y herramientas de analítica como power bi para mejorar la toma de decisiones. Si buscas crear una aplicación o producto a medida visita nuestra página de desarrollo de aplicaciones y software multiplataforma aplicaciones a medida y si necesitas implementar IA para empresas o agentes IA consulta nuestros servicios en inteligencia artificial para empresas. También ofrecemos servicios cloud aws y azure servicios inteligencia de negocio servicios en IA para empresas y auditorías de ciberseguridad y pentesting para proteger tus soluciones.

Palabras clave aplicadas aplicaciones a medida software a medida inteligencia artificial ciberseguridad servicios cloud aws y azure servicios inteligencia de negocio ia para empresas agentes IA power bi.

Conclusión has aprendido los pasos esenciales para crear un carrusel RCS con Node.js y Vonage desde la creación del proyecto hasta la recepción de interacciones en webhooks. Este tipo de mensaje mejora la experiencia del usuario y permite convertir una conversación en una miniaplicación interactiva. Si necesitas apoyo en la implementación o quieres que integremos RCS en tu estrategia conversacional ponte en contacto con Q2BSTUDIO y conversemos sobre cómo llevar tu proyecto al siguiente nivel.