Envío de mensajes RCS

AWS La mensajería para el usuario final utiliza la misma SendTextMessage API para la entrega de RCS y SMS. La forma en que el servicio enruta el mensaje depende de la identidad de origen que especifique en la solicitud. Puede enviar mensajes a través de un grupo de teléfonos (recomendado), a nivel de cuenta o directamente a través de un ARN de agente RCS de AWS.

En esta sección se explican los tres patrones de envío, cómo interpretar los recibos de entrega y se proporcionan ejemplos de códigos. Para obtener más información sobre el envío fijo, la identidad de origen, el orden de prioridad y la reserva automática de SMS, consulte. Recurso alternativo de RCS a SMS mediante grupos de teléfonos Para obtener más información sobre la administración de los agentes de AWS RCS, consulteAdministrar los agentes de RCS.

Patrones de envío

AWS La mensajería del usuario final admite tres patrones para enviar mensajes RCS. Cada patrón determina la forma en que el servicio selecciona una identidad de origen y si está disponible la opción alternativa automática de SMS.

Envío basado en grupos (recomendado)

El envío basado en grupos es el enfoque recomendado para todos los casos de uso de RCS. Cuando especificas un ID de grupo como identidad de origen de tu SendTextMessage solicitud, AWS End User Messaging selecciona la mejor identidad de origen del grupo en función del destino, la disponibilidad del canal y el historial de envíos persistente.

Si el grupo contiene un agente de AWS RCS y números de teléfono SMS, el servicio intenta primero la entrega por RCS. Si se produce un error en la entrega de RCS, el servicio recurre automáticamente a los SMS utilizando un número de teléfono del mismo grupo. Como todas las identidades del grupo están registradas para el mismo caso de uso, el mensaje alternativo siempre se envía desde un número adecuado.

Para obtener más información sobre la creación y configuración de grupos con los agentes RCS de AWS, consulteRecurso alternativo de RCS a SMS mediante grupos de teléfonos.

Envío a nivel de cuenta

Al omitir la identidad de origen de su SendTextMessage solicitud, AWS End User Messaging selecciona una identidad de origen de entre todas las identidades disponibles en su cuenta. El servicio usa el orden de prioridad de la identidad de origen para determinar qué identidad usar. Para obtener más información, consulte Lógica alternativa y orden de prioridad.

Envío directo (solo RCS)

Cuando especifica un ARN de agente RCS de AWS como identidad de origen en SendTextMessage su solicitud AWS , End User Messaging envía el mensaje únicamente a través de RCS. No existe una alternativa automática por SMS. Si se produce un error en la entrega del RCS, el mensaje no se vuelve a intentar en otro canal.

Usa el envío directo cuando:

Envío fijo, orden prioritario y reserva de SMS

Cuando envías mensajes a través de un pool o a nivel de cuenta, la mensajería para el usuario AWS final utiliza el envío continuo (una optimización del enrutamiento en 25 horas), un orden de prioridad de identidad de origen y un SMS alternativo automático para seleccionar el mejor canal e identidad para cada mensaje. Para obtener información completa sobre el funcionamiento de estos mecanismos, incluidos el respaldo automático, los recibos de entrega durante el proceso alternativo y las implicaciones de facturación, consulte. Recurso alternativo de RCS a SMS mediante grupos de teléfonos

Ejemplos de código

Los siguientes ejemplos de Python muestran cómo enviar mensajes RCS utilizando cada uno de los tres patrones de envío. Todos los ejemplos utilizan el pinpoint-sms-voice-v2 cliente boto3 y la API. SendTextMessage

Ejemplo de envío basado en grupos

El siguiente ejemplo envía un mensaje a través de un grupo de teléfonos. El servicio selecciona la mejor identidad de origen del grupo y recurre automáticamente a los SMS si no es posible la entrega por RCS.

import boto3

client = boto3.client('pinpoint-sms-voice-v2')

response = client.send_text_message(
    DestinationPhoneNumber='+12065550100',
    OriginationIdentity='pool-a1b2c3d4e5f6g7h8i',
    MessageBody='Your appointment is confirmed for tomorrow at 2:00 PM.',
    MessageType='TRANSACTIONAL'
)

print(f"Message ID: {response['MessageId']}")
            

Ejemplo de envío a nivel de cuenta

El siguiente ejemplo envía un mensaje a nivel de cuenta omitiendo la identidad de origen. El servicio selecciona una identidad de entre todas las identidades disponibles en su cuenta siguiendo el orden de prioridad.

import boto3

client = boto3.client('pinpoint-sms-voice-v2')

response = client.send_text_message(
    DestinationPhoneNumber='+12065550100',
    MessageBody='Your verification code is 123456.',
    MessageType='TRANSACTIONAL'
)

print(f"Message ID: {response['MessageId']}")
            

Ejemplo de envío directo

El siguiente ejemplo envía un mensaje directamente a través de un ARN de agente RCS de AWS. El mensaje se entrega únicamente a través de RCS, sin necesidad de enviar SMS de respaldo.

import boto3

client = boto3.client('pinpoint-sms-voice-v2')

response = client.send_text_message(
    DestinationPhoneNumber='+12065550100',
    OriginationIdentity='arn:aws:sms-voice:us-east-1:123456789012:rcs-agent/rcs-a1b2c3d4',
    MessageBody='Welcome to our RCS channel! Reply HELP for assistance.'
)

print(f"Message ID: {response['MessageId']}")
            

Un agente de IA solicita el envío de mensajes RCS

Si utiliza un asistente de codificación de IA generativo o un agente de IA, puede utilizar el siguiente mensaje para obtener ayuda para enviar mensajes de RCS mediante la AWS CLI o el SDK.

## RCS Messaging Assistant Prompt

Help me send RCS messages using AWS End User Messaging SMS with the
`pinpoint-sms-voice-v2` service. Show me exact CLI commands and Python/boto3
examples. Ask me for my details before generating any commands.

**Important rules for generating commands:**
- The API is `send-text-message` — the same command used for SMS. There is
  NO separate RCS send API.
- There is NO `describe-messages` API. Do not generate it.
- The boto3 method is `send_text_message` on the
  `pinpoint-sms-voice-v2` client.
- Use the term "testing" — NOT "sandbox".

**Prerequisites:** I have an existing RCS agent (created via the setup process)
and a verified test device.

### Pattern 1: Direct RCS sending (simplest, good for testing)

Send directly through my RCS Agent ARN. RCS-only delivery, no SMS fallback.
If the recipient's device doesn't support RCS, the message is not delivered.

CLI: `send-text-message --destination-phone-number <E.164>
--origination-identity <agent-arn> --message-body "<text>"
--message-type <TRANSACTIONAL|PROMOTIONAL>`

Returns `MessageId`.

### Pattern 2: Pool-based sending (recommended for production)

Send through a phone pool containing my RCS agent (and optionally SMS phone
numbers for fallback). The service tries RCS first, then falls back to SMS
asynchronously if no RCS signal within 25 seconds. This is NOT synchronous
fallback — the SMS is sent as a separate attempt after the timeout.

To set up a pool:
- `create-pool --origination-identity <rcs-agent-id> --message-type TRANSACTIONAL` → returns `PoolId`
- Optionally add SMS numbers: `associate-origination-identity --pool-id <id>
  --origination-identity <phone-number-id>`

CLI: `send-text-message --destination-phone-number <E.164>
--origination-identity <pool-id> --message-body "<text>"
--message-type <TRANSACTIONAL|PROMOTIONAL>`

### Pattern 3: Account-level sending

Send without specifying `--origination-identity`. The service auto-selects
the best identity from the account.

CLI: `send-text-message --destination-phone-number <E.164>
--message-body "<text>" --message-type <TRANSACTIONAL|PROMOTIONAL>`

**Compliance warning:** If the account has multiple RCS agents, SMS numbers,
or different use cases, the service picks an identity automatically — which
may not be the intended one. Use pool-based or direct sending for explicit
control over which identity is used.

### Delivery verification

- For testing: check the test device directly — the message appears from
  the branded RCS agent.
- For production: configure event destinations BEFORE sending using
  `create-event-destination` (SNS, CloudWatch Logs, or Firehose). Event
  destinations do not retroactively capture events for already-sent messages.
- CloudWatch metrics in `AWS/SMSVoice` namespace provide aggregate delivery
  statistics.

### Behavioral notes

- Sticky sending: the service remembers the last successful identity per
  destination number for 25 hours.
- Pool-based sending is recommended for production because it provides
  automatic SMS fallback.
- All three patterns use the same `send-text-message` API — the only
  difference is what you pass (or don't pass) as `--origination-identity`.

---

**Before generating commands, ask me for:**
- Which sending pattern I want to use (direct, pool-based, or account-level)
- My RCS Agent ARN
- My pool ID (if using pool-based sending)
- Destination phone number in E.164 format
- Message type (TRANSACTIONAL or PROMOTIONAL)
- Message text
            

Gestión del recibo de entrega

AWS End User Messaging proporciona recibos de entrega de los mensajes de RCS a través de Amazon EventBridge y los destinos de eventos establecidos en la configuración. Los recibos de entrega indican el estado final del mensaje y el canal que se utilizó para la entrega. Para obtener información sobre cómo configurar los destinos de los eventos para capturar los recibos de entrega y otros eventos de mensajes, consulteDestinos de eventos en los SMS de mensajería para usuarios AWS finales.

Valores del estado de entrega

Los siguientes valores de estado de entrega se aplican a los mensajes RCS:

Atribución del canal

Los recibos de entrega incluyen la atribución del canal, que indica si el mensaje se entregó mediante RCS o SMS. Esto es importante para entender la combinación de entregas y para fines de facturación.

Para obtener más información sobre las CloudWatch métricas de RCS y la supervisión de los patrones de entrega, consulte. Monitorización y CloudWatch métricas de RCS Para obtener información sobre cómo el canal de entrega afecta a la facturación, consulteModelo de facturación y precios de RCS.