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á.
# Configure um destino de evento do Amazon SNS em AWS End User Messaging SMS
O Amazon Simple Notification Service (Amazon SNS) é um serviço da Web que permite que aplicativos, usuários finais e dispositivos enviem e recebam notificações instantaneamente. Para obter mais informações sobre o Amazon SNS, consulte o [Guia do desenvolvedor do Amazon Simple Notification Service](https://docs.aws.amazon.com/sns/latest/dg/).
Alguns dos exemplos desta seção também pressupõem que você já instalou e configurou a AWS Command Line Interface. Para obter mais informações sobre como configurar o AWS CLI, consulte o [Guia AWS Command Line Interface do usuário](https://docs.aws.amazon.com/cli/latest/userguide/).
**Topics**
+ [Política de acesso do Amazon SNS](configuration-sets-sns-creating-role.md)
+ [Crie um destino para eventos do Amazon SNS](configuration-sets-sns-add.md)
+ [Editar um destino de evento do Amazon SNS](configuration-sets-sns-edit.md)
+ [Excluir um destino de evento do Amazon SNS](configuration-sets-sns-delete.md)
# Política de acesso do Amazon SNS
O acesso a um tópico do Amazon SNS é controlado por uma *política de recursos* anexada ao tópico do Amazon SNS, também chamada de *política de acesso*. Para obter mais informações sobre as *políticas de acesso* do Amazon SNS, consulte [Gerenciamento de identidade e acesso](https://docs.aws.amazon.com/sns/latest/dg/security-iam.html) no *Guia do desenvolvedor do Amazon SNS*.
**nota**
Se o seu tópico do Amazon SNS tiver a criptografia do lado do servidor habilitada, AWS Key Management Service adicione também a política à chave gerenciada pelo cliente de criptografia [simétrica](#configuration-sets-sns-creating-role-encrypted) associada.
Atualize a *política de acesso* com a seguinte declaração para permitir que o SMS de mensagens de usuário AWS final seja publicado no tópico do Amazon SNS.
+ *111122223333*Substitua pelo ID exclusivo da sua AWS conta.
+ *TopicName*Substitua pelo nome do tópico do Amazon SNS.
+ *Region*Substitua pelo Região da AWS que contém o tópico e o conjunto de configurações do Amazon SNS.
+ Substitua *ConfigSetName* pelo nome do conjunto de configurações.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"Service": "sms-voice.amazonaws.com"
},
"Action": "sns:Publish",
"Resource": "arn:aws:sns:us-east-1:111122223333:TopicName",
"Condition": {
"StringEquals": {
"aws:SourceAccount": "accountId"
},
"ArnLike": {
"aws:SourceArn": "arn:aws:sms-voice:us-east-1:111122223333:configuration-set/ConfigSetName"
}
}
}
]
}
```
------
## Política de acesso para tópicos criptografados do Amazon SNS
Se o tópico do Amazon SNS tiver a criptografia do lado do servidor habilitada com AWS Key Management Service, adicione a seguinte política à chave gerenciada pelo cliente de criptografia simétrica associada. Você deve adicionar a política a uma chave gerenciada pelo cliente porque você não pode modificar a chave AWS gerenciada para o Amazon SNS.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Id": "example-ID",
"Statement": [
{
"Sid": "example-statement-ID",
"Effect": "Allow",
"Principal": {
"Service": "sms-voice.amazonaws.com"
},
"Action": [
"kms:GenerateDataKey",
"kms:Decrypt"
],
"Resource": "*"
}
]
}
```
------
# Crie um destino de evento do Amazon SNS em AWS End User Messaging SMS
Antes de criar um destino de evento do Amazon SNS, você deve criar um tópico do Amazon SNS. Para obter mais informações sobre a criação de tópicos do Amazon SNS, consulte [Criação de um tópico no Guia](https://docs.aws.amazon.com/sns/latest/dg/sns-create-topic.html) do *desenvolvedor do Amazon Simple Notification Service*.
Você também deve já ter definido um conjunto de configurações para associar os destinos do evento, consulte[Conjuntos de configurações no AWS End User Messaging SMS](configuration-sets.md).
------
#### [ Create an Amazon SNS event destination (Console) ]
Para criar um destino de evento do Amazon SNS usando o console SMS do AWS End User Messaging, siga estas etapas:
1. Abra o console SMS do AWS End User Messaging em [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/).
1. No painel de navegação, em **Configurações, escolha Conjuntos** de **configurações**.
1. Na página **Conjuntos de configurações**, escolha o conjunto de configurações ao qual adicionar um destino de evento.
1. Na página de **detalhes do conjunto de configurações**, escolha **Adicionar evento de destino**.
1. Na seção **Detalhes do evento**, insira um nome.
1. No menu suspenso **Tipo de destino**, escolha Amazon SNS.
1. **Novo tópico do Amazon SNS** — Escolha esta opção para enviar mensagens SMS ao usuário AWS final para 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 [Configuração do Amazon SNS no Guia do desenvolvedor do Amazon](https://docs.aws.amazon.com/sns/latest/dg/sns-getting-started.html) [Simple](https://docs.aws.amazon.com/sns/latest/dg/) Notification Service.
1. **Tópico **existente do Amazon SNS — Escolha essa opção se você tiver um tópico** existente do Amazon SNS no menu suspenso Tópico.**
1. Em **Tipos de eventos**, escolha:
+ **Todos os eventos de SMS (recomendado)** — Escolha essa opção para enviar todos os eventos de SMS listados [Tipos de eventos](configuration-sets-event-types.md) para o Amazon SNS.
+ **Eventos de SMS personalizados** — Escolha dois eventos de SMS específicos para enviar para o Amazon SNS. Para editar a lista de eventos, escolha **Editar seleção de eventos por SMS**. Na **seleção Editar evento SMS**, marque somente os eventos que você deseja enviar para o Amazon SNS. Escolha **Salvar seleção**.
+ **Todos os eventos de voz (recomendado)** — Escolha essa opção para enviar todos os eventos de voz listados [Tipos de eventos](configuration-sets-event-types.md) para o Amazon SNS.
+ **Eventos de voz personalizados** — Escolha eventos de voz específicos para enviar para o Amazon SNS. Para editar a lista de eventos, escolha **Editar seleção de eventos de voz**. Na **seleção Editar evento de voz**, marque somente os eventos que você deseja enviar para o Amazon SNS. Escolha **Salvar seleção**.
+ **Todos os eventos MMS (recomendado)** — Escolha essa opção para enviar todos os eventos MMS listados [Tipos de eventos](configuration-sets-event-types.md) para o Amazon SNS.
+ Eventos **MMS personalizados — Escolha eventos** MMS específicos para enviar para o Amazon SNS. Para editar a lista de eventos, escolha **Editar seleção de eventos MMS**. Na **seleção Editar evento MMS**, marque somente os eventos que você deseja enviar para o Amazon SNS. Escolha **Salvar seleção**.
1. Escolha **Create event (Criar evento)**.
------
#### [ Create an Amazon SNS event destination (AWS CLI) ]
Você pode usar o [create-event-destination](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/create-event-destination.html)comando para criar um destino de evento.
```
$ aws pinpoint-sms-voice-v2 create-event-destination \
> --event-destination-name eventDestinationName \
> --configuration-set-name configurationSet \
> --matching-event-types eventTypes \
> --sns-destination TopicArn=arn:aws:sns:us-east-1:111122223333:snsTopic
```
No comando anterior, faça as seguintes alterações:
+ *eventDestinationName*Substitua por um nome descritivo para o destino do evento.
+ *configurationSet*Substitua pelo nome do conjunto de configurações ao qual você deseja associar o destino do evento.
+ *eventTypes*Substitua por um dos tipos de eventos listados em[Tipos de evento para SMS, MMS e voz](configuration-sets-event-types.md).
+ Substitua o valor de `TopicArn` pelo nome do recurso da Amazon (ARN) do tópico do Amazon SNS para o qual você deseja enviar eventos.
------
# Edite um destino de evento do Amazon SNS em AWS End User Messaging SMS
Use o console AWS End User Messaging SMS ou AWS CLI edite um destino de evento do Amazon SNS.
------
#### [ Update an Amazon SNS event destination (Console) ]
Para atualizar o destino de um evento SMS do AWS End User Messaging usando o console AWS End User Messaging SMS, siga estas etapas:
1. Abra o console SMS do AWS End User Messaging em [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/).
1. No painel de navegação, em **Configurações, escolha Conjuntos** de **configurações**.
1. Na página **Conjuntos de configurações**, escolha o conjunto de configurações ao qual adicionar um destino de evento.
1. Na página **Conjuntos de configurações**, escolha o conjunto de configurações a ser editado.
1. **Na página de **detalhes do conjunto de configurações**, escolha um destino de evento do Amazon SNS e depois Edite.**
1. No menu suspenso **Tipo de destino**, escolha Amazon SNS.
1. **Novo tópico do Amazon SNS** — Escolha esta opção. AWS End User Messaging SMS cria 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 [Configuração do Amazon SNS no Guia do desenvolvedor do Amazon](https://docs.aws.amazon.com/sns/latest/dg/sns-getting-started.html) [Simple](https://docs.aws.amazon.com/sns/latest/dg/) Notification Service.
1. **Tópico **existente do Amazon SNS — Escolha essa opção se você tiver um tópico** existente do Amazon SNS no menu suspenso Tópico.**
1. Em **Tipos de eventos**, escolha:
+ **Todos os eventos de SMS (recomendado)** — Escolha essa opção para enviar todos os eventos de SMS listados [Tipos de eventos](configuration-sets-event-types.md) para o Amazon SNS.
+ **Eventos de SMS personalizados** — Escolha esta opção e escolha eventos de SMS específicos para enviar para o Amazon SNS. Para editar a lista de eventos, escolha **Editar seleção de eventos por SMS**. Na **seleção Editar evento SMS**, marque somente os eventos que você deseja enviar para o Amazon SNS. Escolha **Salvar seleção**.
+ **Todos os eventos de voz (recomendado)** — Escolha essa opção para enviar todos os eventos de voz listados [Tipos de eventos](configuration-sets-event-types.md) para o Amazon SNS.
+ **Eventos de voz personalizados** — Escolha esta opção e escolha eventos de voz específicos para enviar para o Amazon SNS. Para editar a lista de eventos, escolha **Editar seleção de eventos de voz**. Na **seleção Editar evento de voz**, marque somente os eventos que você deseja enviar para o Amazon SNS. Escolha **Salvar seleção**.
+ **Todos os eventos MMS (recomendado)** — Escolha essa opção para enviar todos os eventos MMS listados [Tipos de eventos](configuration-sets-event-types.md) para o Amazon SNS.
+ **Eventos MMS personalizados** — Escolha esta opção e escolha eventos MMS específicos para enviar para o Amazon SNS. Para editar a lista de eventos, escolha **Editar seleção de eventos MMS**. Na **seleção Editar evento MMS**, marque somente os eventos que você deseja enviar para o Amazon SNS. Escolha **Salvar seleção**.
1. Escolha **Editar evento**.
------
#### [ Update an Amazon SNS event destination (AWS CLI) ]
Você pode usar o [update-event-destination](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/update-event-destination.html)comando para atualizar o destino de um evento.
O procedimento para atualizar um destino de evento do Amazon SNS é semelhante ao processo de criação de um destino de evento.
**Para atualizar um destino de evento do Amazon SNS no AWS CLI**
+ Na linha de comando, execute o seguinte comando:
```
$ aws pinpoint-sms-voice-v2 update-event-destination \
> --event-destination-name eventDestinationName \
> --configuration-set-name configurationSet \
> --matching-event types eventTypes \
> --sns-destination TopicArn=arn:aws:sns:us-east-1:111122223333:snsTopic
```
No comando anterior, faça as seguintes alterações:
+ *eventDestinationName*Substitua por um nome do destino do evento que você deseja modificar.
+ *configurationSet*Substitua pelo nome do conjunto de configurações ao qual você deseja associar o destino do evento. Você pode associar o destino do evento a um conjunto de configurações diferente.
+ *eventTypes*Substitua por um ou mais dos tipos de eventos listados em[Tipos de evento para SMS, MMS e voz](configuration-sets-event-types.md).
+ Substitua o valor de `TopicArn` pelo nome do recurso da Amazon (ARN) do tópico do Amazon SNS para o qual você deseja enviar eventos.
------
# Excluir um destino de evento do Amazon SNS em AWS End User Messaging SMS
Use o console AWS End User Messaging SMS ou AWS CLI exclua um tópico do Amazon SNS.
------
#### [ Delete an Amazon SNS event destination (Console) ]
O processo para excluir um destino de evento é o mesmo, independentemente do tipo de destino do evento que você deseja excluir.
**Para excluir um destino de evento do Amazon SNS no console**
1. Abra o console SMS do AWS End User Messaging em [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/).
1. No painel de navegação, em **Configurações, escolha Conjuntos** de **configurações**.
1. Na página **Conjuntos de configuração**, escolha o conjunto de configurações do qual remover um destino de evento.
1. Na seção **Todos os destinos**, escolha um destino para o evento e escolha **Excluir**.
------
#### [ Delete an Amazon SNS event destination (AWS CLI) ]
Você pode usar o [delete-event-destination](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/delete-event-destination.html)comando para excluir o destino de um evento.
O processo para excluir um destino de evento é o mesmo, independentemente do tipo de destino do evento que você deseja excluir.
**Para excluir um destino de evento do Amazon SNS no AWS CLI**
+ Na linha de comando, execute o seguinte comando:
```
$ aws pinpoint-sms-voice-v2 delete-event-destination \
> --event-destination-name eventDestinationName \
> --configuration-set-name configurationSetName
```
No comando anterior, faça as seguintes alterações:
+ *eventDestinationName*Substitua pelo nome ou Amazon Resource Name (ARN) do destino do evento que você deseja excluir.
+ *configurationSetName*Substitua pelo nome ou ARN do conjunto de configurações ao qual o destino do evento está associado.
------