Mensajes RCS a través de Twilio

Los mensajes RCS (Rich Communication Services) llegan a la aplicación de mensajería integrada del teléfono como un chat de su marca, con su logotipo y una tarjeta, un carrusel, contenido multimedia o botones en lugar de texto plano. Pushwoosh los envía a través de Twilio como parte del canal de SMS.

Nota

La configuración lleva tiempo: según Twilio, los operadores aprueban un remitente RCS en 4–6 semanas o más por país, así que comience el registro con antelación.

Cómo funciona

Un mensaje RCS va de una plantilla de Twilio al teléfono en tres pasos:

1. Usted crea el mensaje como una plantilla de contenido en Twilio.
2. Usted elige la plantilla en una plantilla de SMS. Cada idioma de la plantilla de SMS puede llevar su propia plantilla de Twilio.
3. Cuando se envía la plantilla de SMS, Twilio intenta entregar la plantilla por RCS. Los teléfonos que no pueden recibir RCS reciben un SMS en su lugar, como se describe en SMS de respaldo.

Si elige una plantilla solo para algunos idiomas de la plantilla de SMS, los demás idiomas no se envían por RCS. Salen como un SMS normal con el texto de su campo Mensaje.

SMS de respaldo

El SMS de respaldo es lo que reciben los teléfonos sin RCS en lugar del mensaje RCS. Si el teléfono o el operador del destinatario no admite RCS, Twilio envía un SMS creado a partir del tipo Text de la plantilla.

El SMS de respaldo proviene de la plantilla de Twilio, no del campo Mensaje de la plantilla de SMS. Si la plantilla no tiene el tipo Text, los teléfonos sin RCS no reciben el mensaje en absoluto.

Qué necesita para enviar RCS

RCS funciona solo a través de su propia cuenta de Twilio con un Messaging Service y un remitente RCS aprobado por los operadores.

• Twilio como proveedor de SMS. Conéctelo con su propio Account SID y Auth token de Twilio. Si Pushwoosh proporciona el número de Twilio y las credenciales para su proyecto, RCS no está disponible y esos envíos se rechazan.
• Un Messaging Service de Twilio. Su grupo de remitentes contiene un remitente RCS y un número de SMS. Su SID se introduce en Messaging Service SID en la configuración de la plataforma de SMS. Sin él, el envío de un mensaje con plantilla falla.
• Un número de remitente (From). En la configuración de la plataforma de SMS, indique el número de SMS del grupo del Messaging Service. Sin él, Pushwoosh no envía SMS de Twilio, aunque haya un Messaging Service configurado.
• Un remitente RCS aprobado por los operadores en los países a los que envía. Twilio se encarga del registro. Según Twilio, tarda 4–6 semanas o más por país.

Configurar RCS en Twilio

Estos pasos se realizan en la Twilio Console. Los nombres de los menús siguen la guía de incorporación a RCS de Twilio y pueden diferir ligeramente en su consola.

Crear un remitente RCS

El remitente RCS es el perfil de marca que los destinatarios ven en el chat: su nombre, logotipo y colores.

1. Vaya a Communications → Numbers & senders → Overview → RCS.

2. Haga clic en Create RCS Sender.

3. Introduzca un Sender display name.

4. Acepte los términos y haga clic en Continue.

5. En Public details, complete todos los campos:

   • Display name y Description.
   • Logo image (224×224 px, hasta 50 KB) y Banner image (1440×448 px, hasta 200 KB), como URL públicas de JPG o PNG.
   • Accent color con una relación de contraste de al menos 4,5:1 respecto al blanco, por ejemplo #1A73E8.
   • Un número de teléfono o correo electrónico de contacto, una Privacy policy URL y una Terms of service URL.

6. Haga clic en Next.

Añadir un teléfono de prueba

Hasta que los operadores aprueben el remitente, este solo entrega a teléfonos de prueba.

1. En Try it out, haga clic en Add device to test this sender.
2. Introduzca un número de teléfono Android en formato internacional y haga clic en Invite.
3. En el teléfono, abra la invitación en Google Messages y toque Make me a tester.
4. En la consola, confirme que el propietario aceptó la invitación.
5. Envíe un mensaje desde Your message. Debe llegar como un chat de su marca con el logotipo, no como un SMS.

Registrar el remitente con los operadores

Twilio añade un remitente RCS a un Messaging Service solo después de que al menos un operador lo haya aprobado, así que comience el registro antes de crear el Messaging Service.

1. En el remitente RCS, abra Compliance registration.
2. Haga clic en Add countries.
3. Seleccione los países a los que envía y haga clic en Save countries.
4. Haga clic en Start.
5. Complete el formulario y haga clic en Submit registration. Para EE. UU., Twilio tiene un formulario aparte, US registration.

El estado del registro aparece como Pending Review hasta que los operadores lo aprueben.

Crear un Messaging Service

El Messaging Service agrupa el remitente RCS y un número de SMS, para que Twilio pueda elegir RCS o SMS para cada teléfono.

1. Vaya a Messaging → Services.
2. Cree un servicio.
3. En Sender Pool, añada un número de Twilio con capacidad de SMS. Sin él, los teléfonos sin RCS no reciben nada.
4. En cuanto al menos un país muestre Approved en Compliance registration, añada el remitente RCS a Sender Pool.
5. Copie el SID del servicio. Empieza por MG.

Crear una plantilla de contenido

La plantilla de contenido define el mensaje RCS y su SMS de respaldo.

1. Vaya a Messaging → Content Template Builder.
2. Haga clic en Create new.
3. Elija un tipo compatible con RCS: Card, Carousel, Quick reply, Call to action o Media.
4. Complete el contenido. Para un valor que cambia según el destinatario, use una variable numerada, por ejemplo {{1}} para el nombre en el título de la tarjeta.
5. Para ramificar un journey según la respuesta, añada botones de respuesta rápida y asigne un ID a cada uno. No use default ni un ID que empiece por output: ese botón no obtiene rama en el journey.
6. Añada el tipo Text a la misma plantilla. Twilio crea el SMS de respaldo a partir de él.
7. Guarde la plantilla.

Conectar Twilio en Pushwoosh

Pushwoosh envía RCS con las credenciales de Twilio y el Messaging Service que usted introduce en la configuración de la plataforma de SMS.

1. Vaya a Configuración → Configurar plataformas.

2. Abra SMS.

3. Establezca Twilio como proveedor de SMS.

4. Complete los campos:

   • From number: el número de SMS del grupo del Messaging Service.
   • Account SID y Auth token: las credenciales de la cuenta de Twilio propietaria del remitente RCS y de las plantillas.
   • Messaging Service SID (optional): el SID MG del Messaging Service. El campo es opcional para SMS, pero RCS lo necesita.

5. Haga clic en Aplicar.

Para el resto de la configuración de SMS, consulte Configuración de la plataforma de SMS. Los estados de entrega de los mensajes RCS no requieren configurar un webhook, porque Pushwoosh envía a Twilio la URL de devolución de llamada de estado con cada mensaje.

Recibir respuestas

Las respuestas a los mensajes RCS llegan a Pushwoosh solo a través de un webhook que usted configura en el remitente RCS.

1. En la Twilio Console, abra el remitente RCS y vaya a Configuration.
2. Establezca Webhook URL for incoming messages con la URL de SMS entrantes de Webhooks de proveedores de SMS, con el método POST.
3. Haga clic en Save configuration.

Pushwoosh gestiona una respuesta RCS del mismo modo que una respuesta SMS. Activa el evento PW_SMSReceived para el número de teléfono del remitente, y una respuesta STOP establece en false la etiqueta de consentimiento de marketing del suscriptor. Consulte Consentimiento de marketing para SMS y Viber.

Enviar un mensaje RCS

Un mensaje RCS se envía dondequiera que envíe una plantilla de SMS que tenga una plantilla de Twilio.

1. Abra o cree una plantilla de SMS.
2. Elija una plantilla de Twilio para cada idioma en el bloque RCS, como se describe en Enviar por RCS.
3. Envíe la plantilla de SMS en una campaña de SMS o en un Customer Journey.

En un journey, un elemento SMS con una plantilla de respuesta rápida obtiene una rama para cada botón y espera hasta 24 horas a que se toque. Consulte Ramificar según los botones de respuesta RCS.

Consultar las estadísticas de RCS

Para ver cuántas entregas se confirmaron por RCS, cuántas llegaron como SMS y qué proporción de los destinatarios de RCS leyó el mensaje, abra las estadísticas del mensaje del envío.