As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Mensagens SMS bidirecionais em SMS de mensagens para usuários AWS finais
AWS O SMS de mensagens para o usuário final inclui suporte para SMS bidirecional. Ao ativar o SMS bidirecional, você pode receber mensagens de seus clientes. Você também pode usar mensagens bidirecionais junto com outros AWS serviços, como Lambda e Amazon Lex, para criar experiências interativas de mensagens de texto.
Quando um dos seus clientes envia uma mensagem para o seu número de telefone, o corpo da mensagem é enviado para um tópico do Amazon SNS ou para uma instância do Amazon Connect para processamento.
O SMS bidirecional está disponível somente em determinados países e regiões. Para obter mais informações sobre a compatibilidade do SMS bidirecional por país ou região, consulte [Capacidades e limitações de SMS e MMS do país](phone-numbers-sms-support-by-country.md).
O remetente IDs não suporta mensagens SMS bidirecionais.
**nota**
O SMS bidirecional está disponível somente em determinados países e regiões. Para obter mais informações sobre a compatibilidade do SMS bidirecional por país ou região, consulte [Capacidades e limitações de SMS e MMS do país](phone-numbers-sms-support-by-country.md).
O MMS bidirecional não é suportado, mas seu número de telefone ainda pode receber mensagens SMS em resposta a uma mensagem MMS de saída.
O Amazon Connect para SMS bidirecional está disponível na Regiões da AWS lista em [Mensagens de bate-papo: subtipo SMS no guia](https://docs.aws.amazon.com/connect/latest/adminguide/regions.html#chatmessaging_region) do administrador do *Amazon Connect*.
**Topics**
+ [Configurar mensagens SMS bidirecionais para um número de telefone](two-way-sms-phone-number.md)
+ [Configurar mensagens SMS bidirecionais para um pool de telefone](two-way-sms-pool.md)
+ [Políticas do IAM para tópicos do Amazon SNS](two-way-sms-iam-policy.md)
+ [Políticas de tópicos para tópicos do Amazon SNS](two-way-sms-iam-policy-auto.md)
+ [Políticas do IAM para o Amazon Connect](two-way-connect-iam-policy.md)
+ [Exemplo de carga útil de mensagem SMS bidirecional](two-way-sms-payload.md)
# Configurar mensagens SMS bidirecionais para um número de telefone no AWS End User Messaging SMS.
O AWS End User Messaging SMS oferece suporte a SMS bidirecional. Ao ativar o SMS bidirecional, você pode receber mensagens de seus clientes. Você também pode usar mensagens bidirecionais em conjunto com outros Serviços da AWS serviços, como o Lambda e o Amazon Lex, para criar experiências interativas de mensagens de texto.
Quando um dos seus clientes envia uma mensagem para o seu número de telefone, o corpo da mensagem é enviado para um tópico do Amazon SNS ou para uma instância do Amazon Connect para processamento.
**nota**
O SMS bidirecional está disponível somente em determinados países e regiões. Para obter mais informações sobre a compatibilidade do SMS bidirecional por país ou região, consulte [Capacidades e limitações de SMS e MMS do país](phone-numbers-sms-support-by-country.md).
O Amazon Connect para SMS bidirecional está disponível nas Regiões da AWS listadas em [Chat messaging: SMS subtype](https://docs.aws.amazon.com/connect/latest/adminguide/regions.html#chatmessaging_region) no *Guia do administrador do Amazon Connect*.
O MMS bidirecional não é suportado, mas seu número de telefone ainda pode receber mensagens SMS em resposta a uma mensagem MMS de saída.
------
#### [ Two-way SMS messaging (Console) ]
Para habilitar o SMS bidirecional usando o console do AWS End User Messaging SMS, siga estas etapas:
**Habilitar SMS bidirecional**
1. Abra o console do AWS End User Messaging SMS em [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/).
1. No painel de navegação, em **Configurações**, selecione **Números de telefone**.
1. Na página **Números de telefone**, selecione um número.
1. Na guia **SMS bidirecional**, clique no botão **Editar configurações**.
1. Na página **Editar configurações**, selecione **Habilitar mensagem bidirecional**.
1. Para **Tipo de destino**, escolha **Amazon SNS** ou **Amazon Connect**.
+ Para o Amazon SNS, escolha **Novo tópico do Amazon SNS** ou **Tópico existente do Amazon SNS** e, em seguida, para **Função de canal bidirecional**, **Escolha perfil do IAM existente** ou **Usar políticas de tópico do Amazon SNS.**
+ **Novo tópico do Amazon SNS**: se você escolher essa opção, o AWS End User Messaging SMS criará um tópico em sua conta. O tópico é criado automaticamente com todas as permissões necessárias. Para obter mais informações sobre os tópicos do Amazon SNS, consulte [Configurando o Amazon SNS](https://docs.aws.amazon.com/sns/latest/dg/sns-getting-started.html) no [Guia do desenvolvedor do Amazon Simple Notification Service](https://docs.aws.amazon.com/sns/latest/dg/).
+ **Tópico existente do Amazon SNS**: se você escolher essa opção, deverá escolher um tópico existente do Amazon SNS no menu suspenso **Destino das mensagens recebidas**.
+ Para a **função de canal bidirecional**, escolha uma das seguintes opções:
+ **Escolha o perfil do IAM existente** — Escolha uma política do IAM existente para aplicar ao tópico do Amazon SNS. Por exemplo, consulte as políticas do Amazon SNS em [Políticas do IAM para tópicos do Amazon SNS](two-way-sms-iam-policy.md).
+ **Use políticas de tópico do Amazon SNS** – o tópico do Amazon SNS exige a política de tópico apropriada do Amazon SNS para conceder acesso ao AWS End User Messaging SMS. Por exemplo, consulte as políticas do Amazon SNS em [Políticas de tópicos para tópicos do Amazon SNS](two-way-sms-iam-policy-auto.md).
+ Para Amazon Connect em **Função de canal bidirecional**, escolha **Escolher perfis do IAM existentes**.
+ No menu suspenso **perfis do IAM existentes**, escolha um perfil do IAM existente como o destino da mensagem. Para obter exemplos de políticas do IAM, consulte [Políticas do IAM para o Amazon Connect](two-way-connect-iam-policy.md) .
1. Escolha **Salvar alterações**.
1. *(Opcional)* Se você escolheu o Amazon Connect como o **tipo de destino**, na janela **Importar número de telefone para o Amazon Connect**:
1. No menu suspenso **Destino das mensagens recebidas**, escolha a instância do Amazon Connect que receberá mensagens de entrada.
1. Escolha **Importar número de telefone**.
------
#### [ Two-way SMS messaging (AWS CLI) ]
Você pode usar o comando [update-phone-number](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/update-phone-number.html) para ativar o SMS bidirecional.
Na linha de comando, insira o seguinte comando:
```
$ 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
```
No comando anterior, faça as seguintes alterações:
+ No comando anterior, substitua *PhoneNumber* pelo PhoneNumberID ou nome do recurso da Amazon (ARN) do número de telefone.
+ Substitua *TwoWayARN* pelo nome de recurso da Amazon (ARN) para receber mensagens SMS recebidas. Por exemplo, consulte as políticas do Amazon SNS em [Políticas de tópicos para tópicos do Amazon SNS](two-way-sms-iam-policy-auto.md). Para definir o Amazon Connect como destino de entrada, defina *TwoWayARN* como `connect.region.amazonaws.com`. Substitua a *região* pela instância Região da AWS do Amazon Connect na qual está hospedada.
+ Substitua *TwoChannelWayRole* pelo nome do recurso da Amazon (ARN) do perfil do IAM a ser usado. Por exemplo, políticas de permissão do SNS, consulte [Políticas do IAM para tópicos do Amazon SNS](two-way-sms-iam-policy.md) e, por exemplo, políticas do Amazon Connect, consulte [Políticas do IAM para o Amazon Connect](two-way-connect-iam-policy.md). Esse parâmetro é necessário somente se você optar por usar políticas de permissão do IAM.
------
# Configurar mensagens SMS bidirecionais para um pool de telefone no AWS End User Messaging SMS.
Use o console AWS End User Messaging SMS ou AWS CLI habilite o SMS bidirecional para seu pool telefônico.
------
#### [ Two-way SMS messaging (Console) ]
Para habilitar o SMS bidirecional usando o console do AWS End User Messaging SMS, siga estas etapas:
**Habilitar SMS bidirecional**
1. Abra o console do AWS End User Messaging SMS em [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/).
1. No painel de navegação, em **Configurações**, selecione **pools de telefone**.
1. Na página **Pools de números de telefone**, escolha um pool de números de telefone.
1. Na guia **SMS bidirecional**, selecione **Editar configurações**.
1. Na página **Editar configurações**, ative a opção **Habilitar mensagens bidirecionais**.
1. Para **Tipo de destino**, escolha **Amazon SNS** ou **Amazon Connect**.
+ Para o Amazon SNS, escolha **Novo tópico do Amazon SNS** ou **Tópico existente do Amazon SNS** e, em seguida, para **Função de canal bidirecional**, **Escolha perfil do IAM existente** ou **Usar políticas de tópico do Amazon SNS.**
+ **Novo tópico do Amazon SNS**: se você escolher essa opção, o AWS End User Messaging SMS criará um tópico em sua conta. O tópico é criado automaticamente com todas as permissões necessárias. Para obter mais informações sobre os tópicos do Amazon SNS, consulte [Configurar o Amazon SNS](https://docs.aws.amazon.com/sns/latest/dg/sns-getting-started.html) no *Guia do desenvolvedor do Amazon SNS*.
+ **Tópico existente do Amazon SNS**: se você escolher essa opção, deverá escolher um tópico existente do Amazon SNS no menu suspenso **Destino das mensagens recebidas**.
+ Para a **função de canal bidirecional**, escolha uma das seguintes opções:
+ **Escolha o perfil do IAM existente** — Escolha uma política do IAM existente para aplicar ao tópico do Amazon SNS. Por exemplo, consulte as políticas do Amazon SNS em [Políticas do IAM para tópicos do Amazon SNS](two-way-sms-iam-policy.md).
+ **Use políticas de tópico do Amazon SNS** – o tópico do Amazon SNS exige a política de tópico apropriada do Amazon SNS para conceder acesso ao AWS End User Messaging SMS. Por exemplo, consulte as políticas do Amazon SNS em [Políticas de tópicos para tópicos do Amazon SNS](two-way-sms-iam-policy-auto.md).
+ Para Amazon Connect em **Função de canal bidirecional**, escolha **Escolher perfis do IAM existentes**.
+ No menu suspenso **perfis do IAM existentes**, escolha um perfil do IAM existente como o destino da mensagem. Para obter exemplos de políticas do IAM, consulte [Políticas do IAM para o Amazon Connect](two-way-connect-iam-policy.md) .
1. Escolha **Salvar alterações**.
------
#### [ Two-way SMS messaging (AWS CLI) ]
Você pode usar o comando [update-pool](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/update-pool.html) para ativar o SMS bidirecional.
Na linha de comando, insira o seguinte comando:
```
$ aws pinpoint-sms-voice-v2 update-pool \
> --pool-id poolid \
> --two-way-channel-arn TwoWayARN \
> --two-way-channel-role TwoChannelWayRole
```
No comando anterior, faça as seguintes alterações:
+ Substitua *poolid* pelo PhonePoolID ou nome do recurso da Amazon (ARN) do número de telefone.
+ Substitua *TwoWayARN* pelo nome de recurso da Amazon (ARN) para receber mensagens SMS recebidas. Por exemplo, consulte as políticas do Amazon SNS em [Políticas de tópicos para tópicos do Amazon SNS](two-way-sms-iam-policy-auto.md). Para definir o Amazon Connect como destino de entrada, defina *TwoWayARN* como `connect.region.amazonaws.com`. Substitua a *região* pela instância Região da AWS do Amazon Connect na qual está hospedada.
+ Substitua *TwoChannelWayRole* pelo nome do recurso da Amazon (ARN) do perfil do IAM a ser usado. Por exemplo, políticas de permissão do SNS, consulte [Políticas do IAM para tópicos do Amazon SNS](two-way-sms-iam-policy.md) e, por exemplo, políticas do Amazon Connect, consulte [Políticas do IAM para o Amazon Connect](two-way-connect-iam-policy.md). Esse parâmetro é necessário somente se você optar por usar políticas de permissão do IAM.
------
# Políticas do IAM para tópicos do Amazon SNS
Se você quiser que o AWS End User Messaging SMS use uma função existente do IAM ou se você criar uma nova função, anexe as seguintes políticas a essa função para que o AWS End User Messaging SMS possa assumi-la. Para obter informações sobre como modificar a relação de confiança de uma função, consulte [Modificando uma função](https://docs.aws.amazon.com//IAM/latest/UserGuide/id_roles_manage.html) no [https://docs.aws.amazon.com//IAM/latest/UserGuide/introduction.html](https://docs.aws.amazon.com//IAM/latest/UserGuide/introduction.html).
A seguir, apresentamos a **política de confiança** para o perfil do IAM. Na política do IAM a esse perfil, faça as seguintes alterações:
+ *accountId*Substitua pelo ID exclusivo da sua AWS conta.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "SMSVoice",
"Effect": "Allow",
"Principal": {
"Service": "sms-voice.amazonaws.com"
},
"Action": "sts:AssumeRole",
"Condition": {
"StringEquals": {
"aws:SourceAccount": "accountId"
}
}
}
]
}
```
------
A seguir está a política de permissões para o perfil do IAM. O `SMSVoiceAllowSNSPublish` Sid é uma política de permissão para permitir a publicação em tópicos do Amazon SNS e `SMSVoiceAllowEncryptedSNSTopics` o Sid é uma opção para tópicos criptografados do Amazon SNS.
Na política de permissão do IAM a esse perfil, faça as seguintes alterações:
+ *partition*Substitua pela AWS partição na qual você usa o AWS End User Messaging SMS.
+ *region*Substitua por Região da AWS aquela em que você usa AWS o SMS de mensagens de usuário final.
+ *accountId*Substitua pelo ID exclusivo do seu Conta da AWS.
+ *snsTopicArn*Substitua pelos tópicos do Amazon SNS que receberão mensagens.
------
#### [ 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 tópicos para tópicos do Amazon SNS
O tópico do Amazon SNS exige a política de tópico apropriada para conceder acesso ao SMS de mensagens de usuário AWS final, caso elas não sejam fornecidas no *TwoChannelWayRole* parâmetro.
```
{
"Effect": "Allow",
"Principal": {
"Service": "sms-voice.amazonaws.com"
},
"Action": "sns:Publish",
"Resource": "snsTopicArn"
}
```
No exemplo anterior, faça as seguintes alterações:
+ *snsTopicArn*Substitua pelo tópico do Amazon SNS que enviará e receberá mensagens.
**nota**
Tópicos FIFO do Amazon SNS são incompatíveis.
Embora os dados do AWS End User Messaging SMS sejam criptografados, você pode usar tópicos do Amazon SNS que são criptografados usando AWS KMS chaves para obter um nível adicional de segurança. Essa segurança adicional pode ser útil se seu aplicativo manipula dados privados ou confidenciais.
Você precisa realizar algumas etapas adicionais de configuração para usar tópicos criptografados do Amazon SNS com mensagens bidirecionais.
O exemplo de declaração a seguir usa as `SourceArn` condições opcionais, mas recomendadas, `SourceAccount` para evitar o confuso problema substituto e somente a conta do proprietário do SMS do AWS End User Messaging tem acesso. Para obter mais informações sobre o problema de confused deputy”, consulte [O problema de “confused deputy”](https://docs.aws.amazon.com//IAM/latest/UserGuide/confused-deputy.html) no *[usuário do IAM](https://docs.aws.amazon.com//IAM/latest/UserGuide/introduction.html)*.
Primeiro, a chave que você usa deve ser *simétrica*. Tópicos criptografados do Amazon SNS não oferecem suporte a chaves AWS KMS assimétricas.
Em segundo lugar, a política de chaves deve ser modificada para permitir que o SMS de mensagens de usuário AWS final use a chave. Adicione as seguintes permissões à política de chave 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 obter informações sobre como editar políticas de chave, consulte [Alterar uma política de chaves](https://docs.aws.amazon.com/kms/latest/developerguide/key-policy-modifying.html) no *Guia do desenvolvedor do AWS Key Management Service *.
Para obter mais informações sobre a criptografia de tópicos do Amazon SNS AWS KMS usando chaves, [consulte Habilitar a compatibilidade entre fontes de eventos AWS de serviços e tópicos criptografados](https://docs.aws.amazon.com/sns/latest/dg/sns-key-management.html#compatibility-with-aws-services) no Guia do desenvolvedor do *Amazon Simple Notification Service*.
# Políticas do IAM para o Amazon Connect
Se você quiser que o AWS End User Messaging SMS use uma função existente do IAM ou se você criar uma nova função, anexe as seguintes políticas a essa função para que o AWS End User Messaging SMS possa assumi-la. Para obter informações sobre como modificar uma relação de confiança existente de uma função, consulte [Modifying a Role](https://docs.aws.amazon.com//IAM/latest/UserGuide/id_roles_manage.html) no [https://docs.aws.amazon.com//IAM/latest/UserGuide/introduction.html](https://docs.aws.amazon.com//IAM/latest/UserGuide/introduction.html).
Para criar novas políticas de IAM, faça o seguinte:
1. Crie uma nova **política de permissão** seguindo as instruções em [Criar políticas usando o editor JSON](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create-console.html#access_policies_create-json-editor) no Guia do usuário do IAM.
1. Na etapa 4, use a **política de permissão** definida abaixo.
1. Crie uma nova **política de confiança** seguindo as instruções em [Criar um perfil usando políticas de confiança personalizadas](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-custom.html) no Guia do usuário do IAM.
1. Na etapa 4, use a **política de confiança** definida abaixo.
1. Na etapa 11, adicione a **política de permissão** que você criou na etapa anterior.
A seguir está a **política de permissão** do perfil do IAM para permitir a publicação no Amazon Connect.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"connect:SendChatIntegrationEvent"
],
"Resource": [
"*"
]
}
]
}
```
------
A seguir está a **política de confiança** para o perfil do IAM Faça as seguintes alterações:
+ *accountId*Substitua pelo ID exclusivo do seu Conta da 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"
}
}
}
]
}
```
------
# Exemplo de carga útil de mensagem SMS bidirecional para tópicos do Amazon SNS
Quando seu número recebe uma mensagem SMS, o AWS End User Messaging SMS envia uma carga JSON para um tópico do Amazon SNS que você designar. A carga JSON contém a mensagem e dados relacionados, como no exemplo a seguir:
```
{
"originationNumber":"+14255550182",
"destinationNumber":"+12125550101",
"messageKeyword":"JOIN",
"messageBody":"EXAMPLE",
"inboundMessageId":"cae173d2-66b9-564c-8309-21f858e9fb84",
"previousPublishedMessageId":"wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY"
}
```
A carga útil da mensagem de entrada contém as seguintes informações:
****
| Propriedade | Description |
| --- | --- |
| `originationNumber` | O número de telefone que enviou a mensagem recebida para você (em outras palavras, o número de telefone do cliente). |
| `destinationNumber` | O número de telefone para o qual o cliente enviou a mensagem (seu número de telefone dedicado). |
| `messageKeyword` | A palavra-chave registrada associada ao seu número de telefone dedicado. |
| `messageBody` | A mensagem que o cliente enviou para você. |
| `inboundMessageId` | O identificador exclusivo da mensagem recebida. |
| `previousPublishedMessageId` | O identificador exclusivo da mensagem à qual o cliente está respondendo. |