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

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 (comoSendNotifyTextMessage,,, SendNotifyVoiceMessageDescribeNotifyConfigurations, CreateNotifyConfiguration e). UpdateNotifyConfiguration DeleteNotifyConfiguration Ações que não oferecem suporte a permissões em nível de recurso (comoDescribeNotifyTemplates, ListNotifyCountries SetNotifyMessageSpendLimitOverrideDeleteNotifyMessageSpendLimitOverride, ePutMessageFeedback) 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/.

2. No painel de navegação, em Notificar, escolha Notificar configurações.

3. Escolha Criar configuração de notificação.

4. Em Nome de exibição, insira o nome da sua marca (por exemplo,AcmeCorp).

5. Para o caso de uso, a verificação de código é selecionada automaticamente.

6. Em Canais, selecione SMS, VOZ ou ambos.

7. (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.

8. 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:

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.

2. Selecione a guia Testar.

3. Selecione um modelo na tabela de modelos.

4. Em Número de telefone de destino, insira um número de telefone no formato E.164 (por exemplo,+12065550100).

5. Preencha as variáveis do modelo (por exemplo, insira 123456 a variável de código).

6. 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