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](rcs-sms-fallback.md)
**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 llamas`DescribePools`, 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.
1. En el panel de navegación, elija **Grupos de teléfonos**.
1. Elija **Create pool** (Crear grupo).
1. En **Identidad de origen**, seleccione su agente de AWS RCS. El grupo hereda su configuración de la identidad de origen que seleccione.
1. Configure los ajustes del grupo según sea necesario y, a continuación, elija **Crear** grupo.
1. 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](#phone-pool-rcs-config).
------
#### [ 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](#phone-pool-rcs-config)
------
#### [ 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.
1. En el panel de navegación, elija **Grupos de teléfonos**.
1. Elija el grupo al que quiere añadir el agente de AWS RCS.
1. 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.
1. En la sección **Identidades de origen**, elija **Agregar identidad de origen**.
1. 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 un`ConflictException`. 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.
1. Actualice la identidad de origen o la configuración del grupo para que los campos coincidan.
1. 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.
1. En el panel de navegación, elija **Grupos de teléfonos**.
1. Elija el grupo que contiene el agente RCS de AWS que desea eliminar.
1. En la sección **Identidades de origen**, seleccione el agente RCS de AWS.
1. 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`
------