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á.
# Começando com o Notify
Este tutorial explica como criar uma configuração de notificação e enviar sua primeira mensagem OTP. Você pode concluir este tutorial em cerca de 5 minutos.
## Pré-requisitos
+ Um Conta da AWS.
+ Permissões do IAM para operações de SMS de mensagens de usuário AWS final. Para obter mais informações, consulte [Gerenciamento de identidade e acesso para mensagens SMS para usuários AWS finais](security-iam.md).
A política do IAM a seguir concede permissões para enviar mensagens e procurar modelos:
```
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"sms-voice:SendNotifyTextMessage",
"sms-voice:SendNotifyVoiceMessage",
"sms-voice:DescribeNotifyTemplates",
"sms-voice:DescribeNotifyConfigurations",
"sms-voice:ListNotifyCountries",
"sms-voice:PutMessageFeedback"
],
"Resource": "*"
}
]
}
```
A política a seguir concede permissões completas de gerenciamento do Notify:
```
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"sms-voice:CreateNotifyConfiguration",
"sms-voice:UpdateNotifyConfiguration",
"sms-voice:DeleteNotifyConfiguration",
"sms-voice:DescribeNotifyConfigurations",
"sms-voice:DescribeNotifyTemplates",
"sms-voice:ListNotifyCountries",
"sms-voice:SendNotifyTextMessage",
"sms-voice:SendNotifyVoiceMessage",
"sms-voice:SetNotifyMessageSpendLimitOverride",
"sms-voice:DeleteNotifyMessageSpendLimitOverride",
"sms-voice:PutMessageFeedback"
],
"Resource": "*"
}
]
}
```
Para restringir as permissões a uma configuração específica do Notify, use o ARN de configuração para ações em nível de recurso (como`SendNotifyTextMessage`,,, `SendNotifyVoiceMessage``DescribeNotifyConfigurations`, `CreateNotifyConfiguration` e). `UpdateNotifyConfiguration` `DeleteNotifyConfiguration` Ações que não oferecem suporte a permissões em nível de recurso (como`DescribeNotifyTemplates`, `ListNotifyCountries` `SetNotifyMessageSpendLimitOverride``DeleteNotifyMessageSpendLimitOverride`, e`PutMessageFeedback`) exigem. `"Resource": "*"`
## Etapa 1: criar uma configuração de notificação
------
#### [ 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 **Notificar, escolha Notificar** **configurações**.
1. Escolha **Criar configuração de notificação**.
1. Em **Nome de exibição**, insira o nome da sua marca (por exemplo,`AcmeCorp`).
1. Para **o caso de uso**, a **verificação de código** é selecionada automaticamente.
1. Em **Canais**, selecione **SMS**, **VOZ** ou ambos.
1. (Opcional) Expanda **Configurações avançadas** para selecionar países, um modelo padrão, um pool associado ou ativar a proteção contra exclusão.
1. Escolha **Criar configuração de notificação**.
Sua configuração é criada no status **Pendente** enquanto o sistema valida sua conta. Depois de validado, o status muda para **Ativo** e você pode começar a enviar mensagens.
**nota**
A criação da configuração inclui validação automática da conta e verificações do nome da marca. A maioria das configurações é ativada em segundos. Se o nome da sua marca exigir verificação, o status será **Exigir verificação**.
------
#### [ AWS CLI ]
```
aws pinpoint-sms-voice-v2 create-notify-configuration \
--display-name "AcmeCorp" \
--use-case CODE_VERIFICATION \
--enabled-channels SMS
```
------
Status da configuração:
PENDING
A configuração está sendo validada.
ATIVO
Pronto para enviar mensagens.
REQUER\_VERIFICAÇÃO
O nome da marca exige verificação antes da ativação.
REJEITADA
A configuração foi rejeitada. Verifique `RejectionReason` os detalhes.
## Etapa 2: procure os modelos disponíveis
Antes de enviar, verifique quais modelos estão disponíveis para seu nível e canal:
```
aws pinpoint-sms-voice-v2 describe-notify-templates \
--filters '[{"Name":"channels","Values":["SMS"]},{"Name":"tier-access","Values":["BASIC"]}]'
```
## Etapa 3: enviar uma mensagem de teste
------
#### [ Console ]
1. Na lista Notificar configurações, escolha sua configuração.
1. Selecione a guia **Testar**.
1. Selecione um modelo na tabela de modelos.
1. Em **Número de telefone de destino**, insira um número de telefone no formato E.164 (por exemplo,`+12065550100`).
1. Preencha as variáveis do modelo (por exemplo, insira `123456` a variável de **código**).
1. Selecione **Enviar**.
------
#### [ AWS CLI ]
```
aws pinpoint-sms-voice-v2 send-notify-text-message \
--notify-configuration-id "{{nc-1234567890abcdef0}}" \
--destination-phone-number "{{+12065550100}}" \
--template-id "{{notify-code-verification-english-001}}" \
--template-variables '{"code":"123456"}'
```
------
#### [ Python (boto3) ]
```
import boto3
client = boto3.client('pinpoint-sms-voice-v2')
response = client.send_notify_text_message(
NotifyConfigurationId='nc-1234567890abcdef0',
DestinationPhoneNumber='+12065550100',
TemplateId='notify-code-verification-english-001',
TemplateVariables={
'code': '123456'
}
)
print(f"Message ID: {response['MessageId']}")
print(f"Resolved body: {response['ResolvedMessageBody']}")
```
------
## Etapa 4: verifique os países disponíveis
Use `ListNotifyCountries` para ver quais países estão disponíveis para seu nível e canal:
```
aws pinpoint-sms-voice-v2 list-notify-countries \
--channels SMS \
--tier BASIC
```
## Próximas etapas
+ [Gerenciando as configurações do Notify](notify-configurations.md)— Conheça todas as opções de configuração.
+ [Trabalhando com modelos de notificação](notify-templates.md)— Navegue e entenda os modelos disponíveis.
+ [Notificar níveis](notify-tiers.md)— Saiba mais sobre os níveis e como fazer o upgrade para o Avançado.
+ [Notificar limites de gastos](notify-spend-limits.md)— Gerencie seus limites de gastos do Notify.