View a markdown version of this page

Administración de agentes de AWS RCS en grupos - AWS SMS de mensajería para el usuario final

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.

Administración de agentes de AWS RCS en grupos

Puede añadir un agente de AWS RCS como identidad de origen en un grupo de teléfonos junto con sus números de teléfono SMS. Cuando un grupo contiene un agente de AWS RCS y números de teléfono SMS, la mensajería del usuario AWS final intenta primero la entrega por RCS y, automáticamente, recurre a SMS si no es posible la entrega por RCS. Para obtener más información sobre cómo funciona la alternativa, consulte. Recurso alternativo de RCS a SMS mediante grupos de teléfonos

nota

Cuando añada un agente de AWS RCS a un grupo, utilícelo ZZ como código de país ISO. El ZZ código indica que el agente de RCS no es específico de un país a nivel de grupo. El enrutamiento específico de cada país se gestiona mediante los registros de lanzamiento del agente por país. Un grupo puede incluir números de teléfono de varios países junto con el agente de RCS.

El código de país ISO se proporciona en el momento de la creación del grupo, pero no se conserva en el grupo. Si llamasDescribePools, el código ISO del país no aparecerá en la respuesta.

Creación de un grupo con un agente RCS de AWS

Puede crear un nuevo grupo que incluya su agente RCS de AWS mediante la consola de mensajería para el usuario AWS final o la CreatePool API.

Console
Para crear un grupo con un agente RCS de AWS mediante la consola
  1. Abra la consola de mensajería para el usuario AWS final.

  2. En el panel de navegación, elija Grupos de teléfonos.

  3. Elija Create pool (Crear grupo).

  4. En Identidad de origen, seleccione su agente de AWS RCS. El grupo hereda su configuración de la identidad de origen que seleccione.

  5. Configure los ajustes del grupo según sea necesario y, a continuación, elija Crear grupo.

  6. Una vez creado el grupo, añada sus números de teléfono SMS al grupo para habilitar la opción alternativa de SMS. Todas las identidades de origen del grupo deben tener una configuración coincidente. Para obtener más información, consulte Requisitos de configuración del grupo para RCS.

AWS CLI

Utilice la CreatePool API para crear un grupo con su agente RCS de AWS como identidad de origen inicial. Especifique el ARN del agente RCS de AWS como identidad de origen al crear el grupo.

El siguiente ejemplo crea un grupo mediante la AWS CLI:

aws pinpoint-sms-voice-v2 create-pool \ --origination-identity arn:aws:sms-voice:region:account-id:rcs-agent/rcs-agent-id \ --iso-country-code ZZ \ --message-type TRANSACTIONAL

Una vez creado el grupo, utilice la AssociateOriginationIdentity API para añadir números de teléfono SMS al grupo como alternativa.

Añadir agentes RCS de AWS a los grupos existentes

Si ya tiene un grupo con números de teléfono SMS, puede añadir su agente RCS de AWS al grupo para habilitar la mensajería RCS con SMS fallback. También puede añadir números de teléfono SMS adicionales a un grupo que ya contenga un agente RCS de AWS.

importante

Antes de añadir una identidad de origen a un grupo existente, compruebe que la configuración del grupo coincide con la identidad que va a añadir. Todas las identidades de origen de un grupo deben tener metadatos idénticos. Si hay una discrepancia, la operación falla con un. ConflictException Para obtener más información sobre qué campos deben coincidir y cómo resolver las discrepancias, consulte. Requisitos de configuración del grupo para RCS

Console

Antes de añadir un agente de AWS RCS a un grupo mediante la consola, consulte la página de detalles del grupo para revisar su configuración actual. Confirme que el tipo de mensaje del grupo, el código de país ISO y otros ajustes sean compatibles con el agente de AWS RCS que desee añadir.

Para añadir un agente de AWS RCS a un grupo existente mediante la consola
  1. Abra la consola de mensajería para el usuario AWS final.

  2. En el panel de navegación, elija Grupos de teléfonos.

  3. Elija el grupo al que quiere añadir el agente de AWS RCS.

  4. Revise la configuración del grupo en la página de detalles. Confirme que el tipo de mensaje y el resto de la configuración coinciden con el agente de AWS RCS que desea añadir.

  5. En la sección Identidades de origen, elija Agregar identidad de origen.

  6. Seleccione su agente de AWS RCS de la lista y elija Agregar.

AWS CLI

Antes de añadir un agente de AWS RCS a un grupo mediante la CLI o la API, utilice la DescribePools API para recuperar la configuración actual del grupo. Compruebe que la configuración del grupo coincide con el agente RCS de AWS que desea añadir.

En el siguiente ejemplo, se recuperan los detalles del grupo:

aws pinpoint-sms-voice-v2 describe-pools \ --pool-ids pool-id

Tras confirmar que la configuración coincide, utilice la AssociateOriginationIdentity API para añadir el agente RCS de AWS al grupo:

aws pinpoint-sms-voice-v2 associate-origination-identity \ --pool-id pool-id \ --origination-identity arn:aws:sms-voice:region:account-id:rcs-agent/rcs-agent-id \ --iso-country-code ZZ

Requisitos de configuración del grupo para RCS

Todas las identidades de origen de un grupo deben tener metadatos idénticos. Al añadir una identidad de origen a un grupo, AWS End User Messaging compara la configuración de la identidad con la configuración existente del grupo. Si no coincide, se produce un error en la operación y se incluyen detalles sobre los campos específicos que difieren. ConflictException

Los campos de configuración del grupo se dividen en dos categorías: los campos inmutables, que se establecen al crear el grupo y no se pueden cambiar, y los campos mutables, que se pueden actualizar después de la creación.

Los campos de configuración de grupos son inmutables o mutables
Campo Mutabilidad Notas
Tipo de mensaje Inmutable Ambientado en la creación de piscinas. Todas las identidades deben coincidir.
Código de país ISO Inmutable Establecido al momento de la creación de la piscina. Para los agentes RCS de AWS, el valor esZZ. Los grupos pueden contener números de teléfono de varios países.
Protección contra eliminación Mutable Se pueden cambiar después de la creación. Debe ser coherente en todas las identidades.
Lista de exclusión Mutable Se puede cambiar después de la creación. Debe ser coherente en todas las identidades.

Los siguientes campos de configuración deben coincidir en todas las identidades de origen de un grupo:

  • Tipo de mensaje: todas las identidades deben estar configuradas para el mismo tipo de mensaje (por ejemplo, TRANSACCIONAL o PROMOCIONAL).

  • Código de país ISO: se establece en el momento de la creación del grupo. Para los agentes de AWS RCS, ZZ utilícelo como código de país ISO. Los grupos pueden contener números de teléfono de varios países.

  • Protección contra la eliminación: la configuración de la protección contra la eliminación debe ser coherente en todas las identidades.

  • Lista de exclusión: todas las identidades deben estar asociadas a la misma lista de exclusión o ninguna de ellas debe tener una lista de exclusión.

Entender ConflictException los errores

Cuando intenta agregar una identidad de origen a un grupo y la configuración no coincide, la CreatePool API AssociateOriginationIdentity o devuelve unConflictException. El mensaje de excepción incluye detalles sobre los campos que difieren entre la identidad y el grupo.

Por ejemplo, si intenta añadir un número de teléfono configurado para mensajes PROMOCIONALES a un grupo configurado para mensajes TRANSACCIONALES, el mensaje de error indica que el tipo de mensaje no coincide.

Para resolver un ConflictException problema:

  1. Revise el mensaje de error para identificar qué campos son diferentes.

  2. Actualice la identidad de origen o la configuración del grupo para que los campos coincidan.

  3. Vuelva a intentar la operación AssociateOriginationIdentity or. CreatePool

nota

Si no puede resolver la discrepancia de configuración, considere la posibilidad de crear un grupo independiente para la identidad de origen. Cada grupo puede tener su propia configuración y puede usar grupos diferentes para distintos casos de uso.

Eliminar los agentes RCS de AWS de los grupos

Puede eliminar un agente de AWS RCS de un grupo mediante la consola de mensajería para el usuario AWS final o la DisassociateOriginationIdentity API. Al eliminar un agente de AWS RCS de un grupo, se deshabilita la entrega por RCS de los mensajes enviados a través de ese grupo. Los mensajes que se envían al grupo después de eliminar el agente se envían únicamente por SMS (utilizando los números de teléfono restantes del grupo).

Console
Para eliminar un agente de AWS RCS de un grupo mediante la consola
  1. Abra la consola de mensajería para el usuario AWS final.

  2. En el panel de navegación, elija Grupos de teléfonos.

  3. Elija el grupo que contiene el agente RCS de AWS que desea eliminar.

  4. En la sección Identidades de origen, seleccione el agente RCS de AWS.

  5. Seleccione Eliminar y, a continuación, confirme la eliminación.

AWS CLI

Use la DisassociateOriginationIdentity API para eliminar un agente de AWS RCS de un grupo:

aws pinpoint-sms-voice-v2 disassociate-origination-identity \ --pool-id pool-id \ --origination-identity arn:aws:sms-voice:region:account-id:rcs-agent/rcs-agent-id \ --iso-country-code ZZ

Tras eliminar el agente RCS de AWS, los mensajes enviados a través del grupo se entregan únicamente por SMS. Para volver a habilitar la entrega de RCS, vuelva a añadir el agente RCS de AWS al grupo mediante la API. AssociateOriginationIdentity