View a markdown version of this page

Envío de mensajes de texto RCS - AWS SMS de mensajería para el usuario final
En qué se diferencian los mensajes de texto RCS de los SMSRcsMessageContent estructura de los mensajes de textoEnviar un mensaje de textoRecurso alternativo por SMS o MMSLímites de mensajes de textoCuándo usar los mensajes de texto

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 de texto RCS

A TextMessage es el tipo de contenido más simple que puedes enviar con la SendRcsMessage API. Consta de un cuerpo de texto simple (hasta 3.072 caracteres) con chips de sugerencias opcionales que aparecen como botones interactivos debajo del mensaje.

En qué se diferencian los mensajes de texto RCS de los SMS

Los mensajes de texto enviados se SendRcsMessage diferencian de los enviados SendTextMessage (SMS) en dos aspectos:

  • Chips de sugerencias: puedes adjuntar hasta 11 chips de sugerencias a un mensaje de texto RCS. Con estos chips, los destinatarios pueden responder, abrir una URL, marcar un número de teléfono, compartir una ubicación o crear un evento en el calendario en un solo paso. Los SMS no admiten sugerencias.

  • Single-message entrega: un mensaje de texto RCS llega como un mensaje único, independientemente de su longitud (hasta 3.072 caracteres). Los operadores dividen los mensajes SMS de más de 160 caracteres en varios segmentos, por lo que pueden llegar desordenados o con demoras entre los segmentos.

Para obtener más información sobre todos los tipos de sugerencias disponibles y sus parámetros, consulteConfiguración de sugerencias de RCS.

RcsMessageContent estructura de los mensajes de texto

Cuando llamasSendRcsMessage, pasas la carga útil del mensaje como RcsMessageContent parámetro. Para un mensaje de texto, establece el Content campo en un TextMessage objeto que contenga una Body cadena. Para incluir fichas de sugerencias, añade una Suggestions matriz como hermana de nivel superior de. Content

El siguiente fragmento de código JSON muestra la estructura de un mensaje RcsMessageContent de texto con sugerencias:

{
  "Content": {
    "TextMessage": {
      "Body": "What would you like to do?"
    }
  },
  "Suggestions": [
    {
      "Reply": {
        "Text": "Check order status",
        "PostbackData": "action=check_order"
      }
    },
    {
      "OpenUrl": {
        "Text": "View details",
        "PostbackData": "action=view",
        "Url": "https://example.com/orders/1234"
      }
    }
  ]
}

En este ejemplo:

  • Content.TextMessage.Bodycontiene el texto del mensaje (obligatorio, de 1 a 3.072 caracteres).

  • Suggestionses una matriz de nivel superior (opcional, hasta 11 elementos). Cada sugerencia requiere un Text campo (hasta 25 caracteres) y un PostbackData campo (hasta 2048 caracteres).

La Suggestions matriz admite seis tipos de acciones: ReplyOpenUrl,DialPhone, ShowLocationRequestLocation, yCreateCalendarEvent. Puedes mezclar diferentes tipos de sugerencias en un solo mensaje. Para obtener información completa sobre cada tipo, consulteConfiguración de sugerencias de RCS.

Enviar un mensaje de texto

Para enviar un mensaje de texto RCS, llame SendRcsMessage con los siguientes parámetros obligatorios:

  • DestinationPhoneNumber: el número de teléfono del destinatario en E.164 formato.

  • OriginationIdentity: el ID del grupo o el agente RCS de AWS que envía el mensaje.

  • RcsMessageContent: La cadena JSON que contiene Content un TextMessage objeto.

Puede llamar a la API mediante la CLI de AWS (aws pinpoint-sms-voice-v2 send-rcs-message) o un SDK de AWS, como el cliente boto3pinpoint-sms-voice-v2.

Recurso alternativo por SMS o MMS

Si el dispositivo del destinatario no admite RCS o no se puede acceder a él temporalmente en el canal RCS, puede configurar el mensaje para que vuelva a ser SMS o MMS. Para habilitar la opción alternativa, incluye un objeto en la solicitud. FallbackConfiguration SendRcsMessage FallbackConfigurationEspecifica el canal alternativo (SMSoMMS), el cuerpo del mensaje alternativo y la identidad de origen (un número de teléfono o un ID de remitente) que se van a utilizar en el mensaje alternativo.

El respaldo es opcional. Si omite el RCS FallbackConfiguration y el destinatario no puede recibirlo, el mensaje no se entrega.

Para obtener más información sobre la configuración del comportamiento alternativo, consulte. Envío de mensajes RCS enriquecidos

Límites de mensajes de texto

Recurso Límite Notas
Cuerpo del mensaje (Body) 3.072 caracteres () UTF-8 Obligatorio. Debe contener al menos 1 carácter.
Sugerencias por mensaje 11 Total combinado de respuestas y acciones.
Texto de visualización de sugerencias (Text) 25 caracteres Se aplica a todos los tipos de sugerencias.
Datos de devolución () PostbackData 2,048 caracteres Necesario para todos los tipos de sugerencias.

Cuándo usar los mensajes de texto

TextMessageÚselo para:

  • Notificaciones como confirmaciones de pedidos, actualizaciones de envíos y recordatorios de citas.

  • One-time contraseñas y códigos de verificación.

  • Mensajes conversacionales que ofrecen opciones de respuesta como chips de sugerencias, lo que permite interacciones guiadas sin necesidad de introducir texto libre.

  • Actualizaciones de estado breves en las que el contenido no requiere imágenes ni diseños estructurados.

Para los mensajes que requieren imágenes, vídeos o diseños estructurados con títulos y descripciones, utiliza en su lugar tarjetas enriquecidas o carruseles. Consulte Envío de mensajes RCS enriquecidos.