Envío de mensajes de RCS

AWS La mensajería de usuario final utiliza la misma SendTextMessage API para la entrega de RCS y SMS. La forma en que el servicio enruta tu mensaje depende de la identidad de origen que especifiques 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 del agente de AWS RCS.

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ódigo. Para obtener más información sobre el envío fijo, la identidad de origen, el orden de prioridad y la alternativa automática de SMS, consulte. Recurso 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, consulte. Administración de agentes de RCS

Patrones de envío

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

Pool-based envío (recomendado)

Pool-based el envío es el enfoque recomendado para todos los casos de uso de RCS. Cuando especificas un identificador de grupo como identidad de origen en tu SendTextMessage solicitud, la mensajería de usuario AWS final selecciona la mejor identidad de origen del grupo en función del destino, la disponibilidad del canal y el historial de envíos fijo.

Si el grupo contiene tanto un agente de AWS RCS como números de teléfono SMS, el servicio intentará entregar primero el RCS. Si se produce un error en la entrega de RCS, el servicio recurre automáticamente a los SMS con 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 apropiado.

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

Account-level enviar

Cuando omites la identidad de origen de tu SendTextMessage solicitud, la mensajería de usuario AWS final selecciona una identidad de origen de entre todas las identidades disponibles en tu cuenta. Si su cuenta tiene un agente de RCS de AWS activo, el servicio intenta entregar primero el RCS. Si se produce un error en la entrega de RCS, el servicio recurre a un número de teléfono o identificador de remitente dedicado en la cuenta. Las rutas SMS compartidas no son compatibles con el modo alternativo de RCS. Si la cuenta no contiene un remitente exclusivo válido para el país de destino, el mensaje fallará. 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 del agente RCS de AWS como identidad de origen en la SendTextMessage solicitud, la mensajería AWS al usuario final envía el mensaje únicamente a través de RCS. No existe una alternativa automática de SMS. Si se produce un error en la entrega del RCS, el mensaje no se vuelve a intentar en otro canal.

Utilice el envío directo cuando:

Envío fijo, orden prioritario y respaldo de SMS

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

Ejemplos de código

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

Pool-based ejemplo de envío

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']}")
            

Account-level ejemplo de envío

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 según 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 del agente RCS de AWS. El mensaje se entrega únicamente a través de RCS, sin SMS alternativos.

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']}")
            

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

Si utilizas un asistente de codificación de IA generativo o un agente de IA, puedes usar 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 de recibos de entrega

AWS La mensajería de usuario final proporciona acuses de recibo de los mensajes de RCS a través de Amazon EventBridge y establece los destinos de los eventos. 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 las confirmaciones de entrega y otros eventos de mensajes, consulte. Destinos 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 de RCS:

Atribución de canales

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

Para obtener más información sobre las CloudWatch métricas del 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.