Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
Envío de mensajes RCS enriquecidos
Con la acción de la SendRcsMessage API en la mensajería para el usuario AWS final, puede enviar contenido enriquecido e interactivo a los destinatarios a través de RCS (Rich Communication Services). Los mensajes RCS enriquecidos van más allá del texto simple e incluyen tarjetas enriquecidas, carruseles, archivos multimedia y sugerencias para que los destinatarios decidan realizar alguna acción. Estos elementos interactivos convierten las notificaciones unidireccionales en experiencias de conversación bidireccionales, como permitir que el destinatario confirme una cita, explore un catálogo de productos o comparta su ubicación sin abandonar la conversación.
Úsalos SendRcsMessage cuando necesites ofrecer contenido interactivo y de gran riqueza visual, como tarjetas de productos con imágenes y botones de acción, confirmaciones de citas con una sugerencia de calendario, archivos adjuntos o carruseles con varios elementos por los que los destinatarios puedan ir desplazándose. Cada SendRcsMessage solicitud incluye un cuerpo de texto independiente para cada contenido de texto y puede incluir un SMS o MMS opcional para los destinatarios cuyos dispositivos no sean compatibles con RCS.
Para los mensajes de texto sin formato que no requieren un formato enriquecido, usa la acción de la API en su lugar. SendTextMessage SendTextMessagesolo acepta contenido de texto, lo que simplifica la solicitud, y funciona con grupos de mensajes que seleccionan automáticamente entre RCS y SMS en función de la capacidad del destinatario. Para obtener más información, consulte Envío de mensajes de RCS.
importante
Puede utilizar la mensajería RCS SendRcsMessage en todos los países en los que se admite RCS. Para ver la lista actual, consulte. Países compatibles con RCS
Temas
Requisitos previos
Antes de enviar mensajes RCS enriquecidos, complete los pasos de configuración del RCS que se indican en. Introducción a RCS Además de un agente RCS de AWS registrado en estado activo, confirme lo siguiente:
-
Para validar el contenido enriquecido antes de enviarlo a los destinatarios de producción, añada un dispositivo de prueba registrado a su agente de pruebas y envíele mensajes de prueba. Para obtener más información, consulte Prueba de mensajes RCS.
-
Configura un destino de evento (un tema de Amazon SNS o una transmisión de entrega de Amazon Data Firehose) para recibir los eventos del estado de la entrega. Si sus mensajes incluyen elementos interactivos, como sugerencias, necesitará un destino para el evento, ya que las selecciones de destinatarios se envían a su aplicación como eventos de devolución de mensajes. Para obtener más información, consulte Destinos de eventos en los SMS de mensajería para usuarios AWS finales.
-
Si configuras un SMS o un MMS alternativo y los envías a destinos con riesgo de transferencia de SMS, asocia una configuración de protección para aplicar al mensaje alternativo las normas nacionales y de exclusión. Para obtener más información, consulte Protección contra el fraude en AWS SMS de mensajería para el usuario final.
Elegir entre y SendTextMessage SendRcsMessage
Ambas acciones de la API pueden entregar mensajes a través de RCS, pero tienen diferentes propósitos. SendTextMessagesupone que todos los mensajes se pueden entregar en forma de SMS y también se pueden entregar a través de RCS, lo que simplifica el contrato de solicitud. SendRcsMessagese basa en un contenido RCS enriquecido y añade funciones que SendTextMessage no tiene, como los tipos de contenido multimedia y estructurado, la caducidad de los mensajes con el tiempo de vida (TTL) y la posibilidad de utilizar SMS o MMS por mensaje como alternativa.
| Funcionalidad | SendTextMessage | SendRcsMessage |
|---|---|---|
| Contenido de los mensajes | Solo texto plano | Texto, archivos, tarjetas enriquecidas y carruseles, cada uno con sugerencias opcionales |
| Canales de entrega | RCS o SMS | RCS, con respaldo opcional para SMS o MMS |
| Selección de canales | Pool selecciona RCS o SMS automáticamente según la capacidad del destinatario | Primero el RCS y, después, el sistema alternativo de SMS o MMS configurado |
| Fallback (Alternativa) | Automático, basado en grupos | Explícito, por mensaje |
| Identidad de origen | Grupo, número de teléfono, ID de remitente o agente de AWS RCS | Grupo o agente de AWS RCS |
| Expiración del mensaje (TTL) | No | Sí |
| Solicita un contrato | Más sencillo. La misma API que el envío de SMS y MMS | API de RCS dedicada con un cuerpo de texto y tipos de contenido separados |
Elija notificaciones SendTextMessage de texto sin formato, cuando desee una selección automática de canales basada en un grupo o cuando vaya a migrar los flujos de trabajo de SMS existentes con cambios de código mínimos. Elige SendRcsMessage cuándo necesitas tarjetas enriquecidas, carruseles, archivos multimedia o sugerencias, si quieres una alternativa definida por mensaje o si necesitas que caduque un contenido urgente. TTL-based
Tipos de contenido
El RcsMessageContent parámetro contiene un Content objeto con exactamente un tipo de contenido y una lista opcional a nivel de mensajesSuggestions. No puede combinar varios tipos de contenido en una sola solicitud.
| Tipo de contenido | Description (Descripción) | Más información |
|---|---|---|
| TextMessage | Cuerpo del texto de hasta 3.072 caracteres, con sugerencias opcionales. A diferencia de un mensaje SMS, un mensaje de texto RCS puede incluir sugerencias y se entrega como un mensaje único en lugar de dividirse en segmentos. | Envío de mensajes de texto RCS |
| FileMessage | Un único archivo multimedia (imagen, vídeo, audio o PDF) al que se hace referencia mediante una URL de HTTPS o Amazon S3. | Envío de mensajes de archivos RCS |
| RichCard | Una tarjeta estructurada con contenido multimedia opcional, un título, una descripción y hasta 4 sugerencias. | Envío de tarjetas RCS Rich |
| Carrusel | Un conjunto desplazable de 2 a 10 tarjetas, cada una con su propio contenido multimedia, texto y sugerencias. | Envío de carruseles RCS |
Sugerencias
Las sugerencias son fichas interactivas que los destinatarios eligen para realizar una acción. Puedes añadir sugerencias a cualquier tipo de contenido: las sugerencias a nivel de mensaje se aplican a todo el mensaje (hasta 11) y las sugerencias a nivel de tarjeta se aplican a una tarjeta enriquecida o carrusel individual (hasta 4). AWSLa mensajería para el usuario final admite seis tipos de sugerencias, que incluyen respuestas, enlaces y acciones, como marcar un número de teléfono o compartir una ubicación. Para ver una lista completa de los tipos de sugerencias, sus parámetros y cómo recibir las sugerencias, consulte. Configuración de sugerencias de RCS
SendRcsMessage descripción general de la solicitud
La SendRcsMessage solicitud utiliza los siguientes parámetros clave.
| Parámetro | Obligatorio | Descripción |
|---|---|---|
DestinationPhoneNumber |
Sí | El número de teléfono del destinatario en E.164 formato, por ejemplo+12065550100. |
OriginationIdentity |
Sí | El ID o el ARN de un grupo o de un agente RCS de AWS desde el que realizar el envío. El agente debe estar en estado activo. |
RcsMessageContent |
No | El contenido del mensaje. Contiene un Content objeto con exactamente uno de los siguientes TextMessage valores: FileMessageRichCard,Carousel, o y una Suggestions lista opcional de nivel superior. |
FallbackConfiguration |
No | El mensaje SMS o MMS que se va a enviar si la entrega por RCS no se realiza correctamente. Incluye un número de teléfono SMS o un identificador de MessageBody remitente, uno obligatorio Channel (oMMS), un OriginationIdentity opcional MediaUrls para los MMS. |
TimeToLive |
No | El tiempo en segundos que falta para que el mensaje caduque si no se entrega. El mínimo es de 1 segundo y el máximo de 172.800 segundos (48 horas). Se recomienda un valor de 10 segundos o más. |
MessageFeedbackEnabled |
No | Configúrelo en true para habilitar la retroalimentación de los mensajes para el mensaje. Cuando el destinatario reciba el mensaje, actualice el estado del mensaje mediante una llamada a la PutMessageFeedback operación. |
Una respuesta correcta devuelve un valor MessageId que se utiliza para correlacionar los eventos del estado de la entrega.
nota
La opción de respaldo SendRcsMessage se configura por mensaje hasta el final. FallbackConfiguration Para ver el comportamiento alternativo completo, consulte. Configuración del respaldo de SMS o MMS por mensaje
Límites de tamaño y recuento de mensajes
| Límite | Valor |
|---|---|
| Cuerpo del mensaje de texto | 3.072 caracteres |
| Título rico de la carta | 200 caracteres |
| Descripción de la carta rica | 2000 caracteres |
| Tamaño del archivo multimedia | 100 MB |
| Longitud de la URL multimedia | 2000 caracteres |
| Sugerencias por mensaje | 11 |
| Sugerencias por tarjeta | 4 |
| Texto de visualización de sugerencias | 25 caracteres |
| Datos de devolución | 2,048 caracteres |
| Tarjetas de carrusel | De 2 a 10 cartas |
| Time-to-live | De 1 segundo a 172.800 segundos (48 horas) |
Para conocer los límites y restricciones de RCS en todos los tipos de contenido, consulte. Límites y restricciones de mensajería
Eventos de entrega y acciones de los destinatarios
AWSLa mensajería del usuario final genera eventos que informan sobre el estado de entrega del mensaje y las acciones del destinatario, incluidos los eventos de entrega, lectura, error, caducado y devolución de mensajes. Se genera un evento de devolución de datos cuando un destinatario elige una sugerencia e incluye el PostbackData valor. Dirija estos eventos a un tema de Amazon SNS, a una transmisión de entrega de Amazon Data Firehose o a Amazon Logs. CloudWatch Para obtener más información, consulte eventos de mensajes RCS.
Prácticas recomendadas
Diseñe mensajes RCS sofisticados como experiencias conversacionales e interactivas. Establece una TimeToLive opción para el contenido urgente, como contraseñas de un solo uso, configura un SMS o MMS alternativo para los mensajes que deban llegar al destinatario incluso cuando su dispositivo no sea compatible con el RCS, haz que las etiquetas de sugerencias sean breves (el límite es de 25 caracteres) e incluye identificadores estructurados para que la aplicación PostbackData pueda redirigir las respuestas sin necesidad de realizar búsquedas adicionales. Mejores prácticas de RCSPara obtener una guía detallada, consulte.
