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.
# Mensajería SMS bidireccional en SMS de mensajería para el usuario AWS final
AWS La mensajería SMS para el usuario final incluye la compatibilidad con los SMS bidireccionales. Cuando configure SMS bidireccionales, puede recibir los mensajes entrantes de los clientes. También puede usar la mensajería bidireccional junto con otros AWS servicios, como Lambda y Amazon Lex, para crear experiencias de mensajería de texto interactivas.
Cuando uno de sus clientes envía un mensaje a su número de teléfono, el cuerpo del mensaje se envía a un tema de Amazon SNS o Amazon Connect para su procesamiento.
Los SMS bidireccionales solo están disponibles en algunos países y regiones. Para obtener más información sobre la disponibilidad de los SMS bidireccionales en cada país o región, consulte [Capacidades y limitaciones por país para SMS y MMS](phone-numbers-sms-support-by-country.md).
Los remitentes IDs no admiten la mensajería SMS bidireccional.
**nota**
Los SMS bidireccionales solo están disponibles en algunos países y regiones. Para obtener más información sobre la disponibilidad de los SMS bidireccionales en cada país o región, consulte [Capacidades y limitaciones por país para SMS y MMS](phone-numbers-sms-support-by-country.md).
No se admiten los MMS bidireccionales, pero su número de teléfono puede seguir recibiendo mensajes SMS entrantes en respuesta a un mensaje MMS saliente.
Amazon Connect para SMS bidireccionales está disponible en el Regiones de AWS [subtipo Mensajes de chat: SMS](https://docs.aws.amazon.com/connect/latest/adminguide/regions.html#chatmessaging_region) de la guía del *administrador de Amazon Connect*.
**Topics**
+ [Configuración de mensajería SMS bidireccional para un número de teléfono](two-way-sms-phone-number.md)
+ [Configuración de mensajería SMS bidireccional para un grupo de teléfonos](two-way-sms-pool.md)
+ [Políticas de IAM para temas de Amazon SNS](two-way-sms-iam-policy.md)
+ [Políticas de tema para temas de Amazon SNS](two-way-sms-iam-policy-auto.md)
+ [Políticas de IAM para Amazon Connect](two-way-connect-iam-policy.md)
+ [Ejemplo de carga útil de mensaje SMS bidireccional](two-way-sms-payload.md)
# Configuración de mensajería SMS bidireccional para un número de teléfono en Mensajes SMS para usuarios finales de AWS
Mensajes SMS para usuarios finales de AWS admite SMS bidireccionales. Cuando configure SMS bidireccionales, puede recibir los mensajes entrantes de los clientes. También puede usar la mensajería bidireccional junto con otros Servicios de AWS, como Lambda y Amazon Lex, para crear experiencias de mensajería de texto interactivas.
Cuando uno de sus clientes envía un mensaje al número de teléfono, el cuerpo del mensaje se envía a un tema de Amazon SNS o una instancia de Amazon Connect para su procesamiento.
**nota**
Los SMS bidireccionales solo están disponibles en algunos países y regiones. Para obtener más información sobre la disponibilidad de los SMS bidireccionales en cada país o región, consulte [Capacidades y limitaciones por país para SMS y MMS](phone-numbers-sms-support-by-country.md).
Amazon Connect para SMS bidireccionales está disponible en las Regiones de AWS enumeradas en [Mensajería de chat: subtipo SMS](https://docs.aws.amazon.com/connect/latest/adminguide/regions.html#chatmessaging_region) en la *Guía del administrador de Amazon Connect*.
No se admiten los MMS bidireccionales, pero su número de teléfono puede seguir recibiendo mensajes SMS entrantes en respuesta a un mensaje MMS saliente.
------
#### [ Two-way SMS messaging (Console) ]
Para habilitar SMS bidireccionales mediante la consola de Mensajes SMS para usuarios finales de AWS, siga estos pasos:
**Habilitación de SMS bidireccionales**
1. Abra la consola de Mensajes SMS para usuarios finales de AWS en [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/).
1. En el panel de navegación, en **Configuraciones**, elija **Números de teléfono**.
1. En la página **Números de teléfono**, elija un número de teléfono.
1. En la pestaña **SMS bidireccional**, seleccione el botón **Editar configuración**.
1. En la página **Editar configuración**, seleccione **Habilitar mensaje bidireccional**.
1. En **Tipo de destino**, elija **Amazon SNS** o **Amazon Connect**.
+ Para Amazon SNS, elija un **Tema nuevo tema de Amazon SNS** o **Tema existente de Amazon SNS** y, a continuación, en **Rol de canal bidireccional**, seleccione **Elegir un rol de IAM existente** o **Utilizar políticas de temas de Amazon SNS**.
+ **Nuevo tema de Amazon SNS**: si elige esta opción, Mensajes SMS para usuarios finales de AWS crea un tema en la cuenta. El tema se crea automáticamente con todos los permisos necesarios. Para obtener más información sobre los temas de Amazon SNS, consulte [Configuración de Amazon SNS](https://docs.aws.amazon.com/sns/latest/dg/sns-getting-started.html) en la [Guía para desarrolladores de Amazon Simple Notification Service](https://docs.aws.amazon.com/sns/latest/dg/).
+ **Tema de Amazon SNS existente**: si elige esta opción, debe elegir un tema de Amazon SNS existente en el menú desplegable **Destino de los mensajes entrantes**.
+ En **Rol de canal bidireccional**, elija una de las siguientes opciones:
+ **Elija un rol de IAM existente**. Elija una política de IAM existente para aplicarla al tema de Amazon SNS. Para ver, por ejemplo, políticas de Amazon SNS, consulte [Políticas de IAM para temas de Amazon SNS](two-way-sms-iam-policy.md).
+ **Utilizar políticas de temas de Amazon SNS**. El tema de Amazon SNS requiere la política de temas de Amazon SNS adecuada para permitir el acceso a Mensajes SMS para usuarios finales de AWS. Para ver, por ejemplo, políticas de Amazon SNS, consulte [Políticas de tema para temas de Amazon SNS](two-way-sms-iam-policy-auto.md).
+ Para Amazon Connect en **Rol de canal bidireccional**, seleccione **Elegir roles de IAM existentes**.
+ En el menú desplegable **Roles de IAM existentes**, elija un rol de IAM existente como el destino del mensaje. Para ver ejemplos de políticas de IAM, consulte [Políticas de IAM para Amazon Connect](two-way-connect-iam-policy.md) .
1. Seleccione **Guardar cambios**.
1. *(Opcional)* si ha elegido Amazon Connect como **Tipo de destino**, en la ventana **Importar número de teléfono a Amazon Connect**:
1. En el menú desplegable **Destino de mensajes entrantes**, seleccione la instancia de Amazon Connect que recibirá los mensajes entrantes.
1. Seleccione **Importar número de teléfono**.
------
#### [ Two-way SMS messaging (AWS CLI) ]
Puede usar el comando [update-phone-number](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/update-phone-number.html) para activar los SMS bidireccionales.
En la línea de comandos, introduzca el comando siguiente:
```
$ aws pinpoint-sms-voice-v2 update-phone-number \
> --phone-number-id PhoneNumber \
> --two-way-enabled True \
> --two-way-channel-arn TwoWayARN \
> --two-way-channel-role TwoChannelWayRole
```
En el comando anterior, realice los siguientes cambios:
+ Sustituya *PhoneNumber* por PhoneNumberID o el nombre de recurso de Amazon (ARN) del número de teléfono.
+ Sustituya *TwoWayARN* por el nombre de recurso de Amazon (ARN) para recibir los SMS entrantes. Para ver, por ejemplo, políticas de Amazon SNS, consulte [Políticas de tema para temas de Amazon SNS](two-way-sms-iam-policy-auto.md). Para configurar Amazon Connect como destino de entrada, configure *TwoWayARN* como `connect.region.amazonaws.com`. Sustituya la *región* por la Región de AWS en la que está alojada la instancia de Amazon Connect.
+ Sustituya *TwoChannelWayRole* por el nombre de recurso de Amazon (ARN) del rol de IAM que desea utilizar. Para ver, por ejemplo, las políticas de permisos de SNS, consulte [Políticas de IAM para temas de Amazon SNS](two-way-sms-iam-policy.md) y, por ejemplo, las políticas de Amazon Connect, consulte [Políticas de IAM para Amazon Connect](two-way-connect-iam-policy.md). Este parámetro solo es necesario si decide utilizar políticas de permisos de IAM.
------
# Configuración de mensajería SMS bidireccional para un grupo de teléfonos en Mensajes SMS para usuarios finales de AWS
Utilice la consola de Mensajes SMS para usuarios finales de AWS o la AWS CLI para activar los SMS bidireccionales en su grupo de teléfonos.
------
#### [ Two-way SMS messaging (Console) ]
Para habilitar SMS bidireccionales mediante la consola de Mensajes SMS para usuarios finales de AWS, siga estos pasos:
**Habilitación de SMS bidireccionales**
1. Abra la consola de Mensajes SMS para usuarios finales de AWS en [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/).
1. En el panel de navegación, en **Configuraciones**, elija **Grupos de teléfonos**.
1. En la página **Grupos de teléfonos**, elija un grupo de teléfonos.
1. En la pestaña **SMS bidireccional**, elija el botón **Editar configuración**.
1. En la página **Editar configuración**, active **Activar mensaje bidireccional**.
1. En **Tipo de destino**, elija **Amazon SNS** o **Amazon Connect**.
+ Para Amazon SNS, elija un **Tema nuevo tema de Amazon SNS** o **Tema existente de Amazon SNS** y, a continuación, en **Rol de canal bidireccional**, seleccione **Elegir un rol de IAM existente** o **Utilizar políticas de temas de Amazon SNS**.
+ **Nuevo tema de Amazon SNS**: si elige esta opción, Mensajes SMS para usuarios finales de AWS crea un tema en la cuenta. El tema se crea automáticamente con todos los permisos necesarios. Para obtener más información sobre el tema de Amazon SNS, consulte [Configuración de Amazon SNS](https://docs.aws.amazon.com/sns/latest/dg/sns-getting-started.html) en la *Guía para desarrolladores de Amazon SNS*.
+ **Tema de Amazon SNS existente**: si elige esta opción, debe elegir un tema de Amazon SNS existente en el menú desplegable **Destino de los mensajes entrantes**.
+ En **Rol de canal bidireccional**, elija una de las siguientes opciones:
+ **Elija un rol de IAM existente**. Elija una política de IAM existente para aplicarla al tema de Amazon SNS. Para ver, por ejemplo, políticas de Amazon SNS, consulte [Políticas de IAM para temas de Amazon SNS](two-way-sms-iam-policy.md).
+ **Utilizar políticas de temas de Amazon SNS**. El tema de Amazon SNS requiere la política de temas de Amazon SNS adecuada para permitir el acceso a Mensajes SMS para usuarios finales de AWS. Para ver, por ejemplo, políticas de Amazon SNS, consulte [Políticas de tema para temas de Amazon SNS](two-way-sms-iam-policy-auto.md).
+ Para Amazon Connect en **Rol de canal bidireccional**, elija **Elegir roles de IAM existentes**.
+ En el menú desplegable **Roles de IAM existentes**, elija un rol de IAM existente como el destino del mensaje. Para ver ejemplos de políticas de IAM, consulte [Políticas de IAM para Amazon Connect](two-way-connect-iam-policy.md).
1. Seleccione **Guardar cambios**.
------
#### [ Two-way SMS messaging (AWS CLI) ]
Puede usar el comando [update-pool](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/update-pool.html) para activar los SMS bidireccionales.
En la línea de comandos, introduzca el comando siguiente:
```
$ aws pinpoint-sms-voice-v2 update-pool \
> --pool-id poolid \
> --two-way-channel-arn TwoWayARN \
> --two-way-channel-role TwoChannelWayRole
```
En el comando anterior, realice los siguientes cambios:
+ Sustituya *poolId* por el PhonePoolID o nombre de recurso de Amazon (ARN) del grupo de teléfonos.
+ Sustituya *TwoWayARN* por el nombre de recurso de Amazon (ARN) para recibir los SMS entrantes. Para ver, por ejemplo, políticas de Amazon SNS, consulte [Políticas de tema para temas de Amazon SNS](two-way-sms-iam-policy-auto.md). Para configurar Amazon Connect como destino de entrada, configure *TwoWayARN* como `connect.region.amazonaws.com`. Sustituya la *región* por la Región de AWS en la que está alojada la instancia de Amazon Connect.
+ Sustituya *TwoChannelWayRole* por el nombre de recurso de Amazon (ARN) del rol de IAM que desea utilizar. Para ver, por ejemplo, las políticas de permisos de SNS, consulte [Políticas de IAM para temas de Amazon SNS](two-way-sms-iam-policy.md) y, por ejemplo, las políticas de Amazon Connect, consulte [Políticas de IAM para Amazon Connect](two-way-connect-iam-policy.md). Este parámetro solo es necesario si decide utilizar políticas de permisos de IAM.
------
# Políticas de IAM para temas de Amazon SNS
Si desea que la función de mensajería SMS para el usuario AWS final utilice una función de IAM existente o si crea una nueva, adjunte las siguientes políticas a esa función para que la función de mensajería SMS para el usuario AWS final pueda asumirla. Para obtener información acerca de cómo modificar la relación de confianza de un rol, consulte [Modificación de un rol](https://docs.aws.amazon.com//IAM/latest/UserGuide/id_roles_manage.html) en la [https://docs.aws.amazon.com//IAM/latest/UserGuide/introduction.html](https://docs.aws.amazon.com//IAM/latest/UserGuide/introduction.html).
Esta es la **política de confianza** para el rol de IAM. En la siguiente política de IAM, realice los siguientes cambios:
+ *accountId*Sustitúyalo por el identificador único de tu AWS cuenta.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "SMSVoice",
"Effect": "Allow",
"Principal": {
"Service": "sms-voice.amazonaws.com"
},
"Action": "sts:AssumeRole",
"Condition": {
"StringEquals": {
"aws:SourceAccount": "accountId"
}
}
}
]
}
```
------
Esta es la **política de permisos** para el rol de IAM. El Sid `SMSVoiceAllowSNSPublish` es una política de permisos que permite publicar temas en Amazon SNS y el Sid `SMSVoiceAllowEncryptedSNSTopics` es una opción para temas de Amazon SNS cifrados.
En la siguiente política de permisos de IAM, realice los siguientes cambios:
+ *partition*Sustitúyala por la AWS partición en la que utilizas los mensajes SMS para el usuario AWS final.
+ *region*Sustitúyala por la Región de AWS que utilizas la mensajería SMS para el usuario AWS final.
+ *accountId*Reemplácelo por el ID único de su Cuenta de AWS.
+ *snsTopicArn*Sustitúyalos por los temas de Amazon SNS que recibirán los mensajes.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "SMSVoiceAllowSNSPublish",
"Effect": "Allow",
"Action": "sns:Publish",
"Resource": "arn:aws:sns:us-east-1:111122223333:snsTopicArn",
"Condition": {
"StringEquals": {
"aws:ResourceAccount": "111122223333"
}
}
},
{
"Sid": "SMSVoiceAllowEncryptedSNSTopics",
"Effect": "Allow",
"Action": [
"kms:Decrypt",
"kms:GenerateDataKey*"
],
"Resource": "*",
"Condition": {
"StringEquals": {
"kms:EncryptionContext:aws:sns:topicArn": "arn:aws:sns:us-east-1:111122223333:snsTopicArn",
"aws:CalledViaLast": "sns.amazonaws.com"
}
}
}
]
}
```
------
# Políticas de tema para temas de Amazon SNS
El tema Amazon SNS requiere la política de temas adecuada para conceder acceso a los SMS de mensajería de usuario AWS final si no se proporcionan en el *TwoChannelWayRole* parámetro.
```
{
"Effect": "Allow",
"Principal": {
"Service": "sms-voice.amazonaws.com"
},
"Action": "sns:Publish",
"Resource": "snsTopicArn"
}
```
En el ejemplo anterior, realice los siguientes cambios:
+ *snsTopicArn*Sustitúyalo por el tema Amazon SNS que enviará y recibirá mensajes.
**nota**
No se admiten los temas FIFO de Amazon SNS.
Si bien los datos de SMS de mensajería de usuario AWS final están cifrados, puede utilizar los temas de Amazon SNS cifrados mediante AWS KMS claves para obtener un nivel de seguridad adicional. Esta seguridad adicional puede resultar útil si la aplicación maneja datos privados o confidenciales.
Debe realizar algunos pasos de configuración adicionales para utilizar temas de Amazon SNS cifrados con mensajería bidireccional.
En la siguiente declaración de ejemplo, se utilizan las `SourceArn` condiciones, opcionales pero recomendadas, `SourceAccount` para evitar el confuso problema de los suplentes y solo el propietario de la cuenta del propietario de los SMS de mensajería de usuario AWS final tiene acceso. Para obtener información general sobre el problema del suplente confuso, consulte [El problema del suplente confuso](https://docs.aws.amazon.com//IAM/latest/UserGuide/confused-deputy.html) en la *[Guía del usuario de IAM](https://docs.aws.amazon.com//IAM/latest/UserGuide/introduction.html)*.
En primer lugar, la clave que utilice debe ser *simétrica*. Los temas cifrados de Amazon SNS no admiten claves asimétricas AWS KMS .
En segundo lugar, la política de claves debe modificarse para permitir que los SMS de mensajería de usuario AWS final utilicen la clave. Agregue los siguientes permisos a la política de claves existente:
```
{
"Effect": "Allow",
"Principal": {
"Service": "sms-voice.amazonaws.com"
},
"Action": [
"kms:GenerateDataKey*",
"kms:Decrypt"
],
"Resource": "*",
"Condition": {
"StringEquals": {
"aws:SourceAccount": "accountId"
},
"ArnLike": {
"aws:SourceArn": "arn:aws:sms-voice:region:accountId:*"
}
}
}
```
Para obtener más información sobre cómo editar políticas de claves, consulte [Cambio de una política de claves](https://docs.aws.amazon.com/kms/latest/developerguide/key-policy-modifying.html) en la *Guía para desarrolladores de AWS Key Management Service *.
Para obtener más información sobre el cifrado de temas de Amazon SNS AWS KMS mediante claves, [consulte Habilitar la compatibilidad entre las fuentes de eventos AWS de los servicios y los temas cifrados](https://docs.aws.amazon.com/sns/latest/dg/sns-key-management.html#compatibility-with-aws-services) en la Guía para desarrolladores de *Amazon Simple Notification Service*.
# Políticas de IAM para Amazon Connect
Si desea que la función de mensajería SMS para el usuario AWS final utilice una función de IAM existente o si crea una nueva, adjunte las siguientes políticas a esa función para que el usuario AWS final pueda asumirla. Para obtener información sobre cómo modificar una relación de confianza existente entre un rol, consulte [Modificación de un rol](https://docs.aws.amazon.com//IAM/latest/UserGuide/id_roles_manage.html) en la [https://docs.aws.amazon.com//IAM/latest/UserGuide/introduction.html](https://docs.aws.amazon.com//IAM/latest/UserGuide/introduction.html).
Para crear nuevas políticas de IAM, haga lo siguiente:
1. Cree una nueva **política de permisos** siguiendo las instrucciones que se indican en [Creación de políticas mediante el editor JSON](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create-console.html#access_policies_create-json-editor) en la Guía del usuario de IAM.
1. En el paso 4, utilice la **política de permisos** que se define a continuación.
1. Cree una nueva **política de confianza** siguiendo las instrucciones que se indican en la sección [Creación de un rol mediante políticas de confianza personalizadas](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-custom.html) de la Guía del usuario de IAM.
1. En el paso 4, utilice la **política de confianza** que se define a continuación.
1. En el paso 11, agregue la **política de permisos** que ha creado en el paso anterior.
A continuación, la **política de permisos** del rol de IAM para permitir la publicación en Amazon Connect.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"connect:SendChatIntegrationEvent"
],
"Resource": [
"*"
]
}
]
}
```
------
A continuación, la **política de confianza** para el rol de IAM. Realice los siguientes cambios:
+ *accountId*Sustitúyalo por el identificador exclusivo de su. Cuenta de AWS
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "SMSVoice",
"Effect": "Allow",
"Principal": {
"Service": "sms-voice.amazonaws.com"
},
"Action": "sts:AssumeRole",
"Condition": {
"StringEquals": {
"aws:SourceAccount": "accountId"
}
}
}
]
}
```
------
# Ejemplo de una carga útil de mensajes SMS bidireccionales para temas de Amazon SNS
Cuando su número recibe un mensaje SMS, AWS End User Messaging SMS envía una carga útil JSON a un tema de Amazon SNS que usted designe. La carga útil JSON contiene el mensaje y los datos relacionados, como en el siguiente ejemplo:
```
{
"originationNumber":"+14255550182",
"destinationNumber":"+12125550101",
"messageKeyword":"JOIN",
"messageBody":"EXAMPLE",
"inboundMessageId":"cae173d2-66b9-564c-8309-21f858e9fb84",
"previousPublishedMessageId":"wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY"
}
```
La carga útil del mensaje entrante contiene la siguiente información:
****
| Propiedad | Description (Descripción) |
| --- | --- |
| `originationNumber` | El número de teléfono que le envió el mensaje entrante (es decir, el número de teléfono de su cliente). |
| `destinationNumber` | El número de teléfono al que el cliente envió el mensaje (su número de teléfono dedicado). |
| `messageKeyword` | La palabra clave registrada que está asociada a su número de teléfono dedicado. |
| `messageBody` | El mensaje que el cliente le envió. |
| `inboundMessageId` | Identificador único del mensaje entrante. |
| `previousPublishedMessageId` | Identificador único del mensaje al que responde el cliente. |