

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

# Tutorial para enviar uma mensagem usando SMS de mensagens para o usuário AWS final
<a name="getting-started-tutorial"></a>

Esta seção fornece uma visão geral do tutorial criado para ajudar você a começar a usar o AWS End User Messaging SMS.

**Público-alvo**  
Este tutorial foi desenvolvido para administradores de sistemas e desenvolvedores responsáveis pela configuração, teste e implantação do AWS End User Messaging SMS.

**Características usadas**  
Este tutorial mostra como usar o console SMS do AWS End User Messaging para:  
+ Criar e configurar um pool telefônico.
+ Solicitar uma identidade de origem, que seja um número de telefone ou ID do remetente.
+ Criar e configurar uma configuração de proteção.
+ Envie uma mensagem SMS de teste com o simulador de SMS.

**Tempo necessário**  
A conclusão deste tutorial deve levar cerca de 10 a 15 minutos.

**Restrições regionais**  
Não há restrições de país ou regionais associadas ao uso desta solução.

**Custos de uso de recursos**  
Não há cobrança pela criação de uma AWS conta. Contudo, ao implementar essa solução, pode haver alguns ou todos os custos listados na tabela a seguir.      
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/sms-voice/latest/userguide/getting-started-tutorial.html)

**AWS permissões da conta**  
A conta que você usa para entrar no deve ser capaz de realizar as seguintes tarefas: Console de gerenciamento da AWS   
+ Criar um grupo
+ Criar um conjunto de configurações
+ Criar um destino de eventos
+ Enviar mensagens SMS
Para obter mais informações sobre permissões de conta, consulte [Gerenciamento de identidade e acesso para mensagens SMS para usuários AWS finais](security-iam.md).

## Passo 1: Criar um pool
<a name="getting-started-tutorial-step1"></a>

Os procedimentos nesta seção mostram como criar um grupo e adicionar um número de telefone ou ID do remetente ao grupo.

**Para criar um grupo**

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 **Visão geral**, na seção **Início rápido**, escolha **Criar um pool**.

1. Na seção **Configuração do pool**, insira um nome para seu pool em **Nome do pool**.

1. Escolha uma das seguintes opções:
   + **Número de telefone** — Se você escolher essa opção, em **Números de telefone disponíveis para associação**, escolha:
     + **Solicite um número de simulador** e, na lista suspensa **País**, escolha o país de destino e, em seguida, selecione **Solicitar número**. 
**nota**  
Números de telefone de simulador não exigem registro. Ele gera eventos realistas e é usado para testes. As mensagens enviadas a partir de um número de simulador só podem ser enviadas para outros números de destino de simulador e não são enviadas através da rede da operadora. 
     + Escolha um número de telefone que você tenha comprado anteriormente.
   + **ID do remetente** — Se você escolher essa opção, escolha um ID do remetente do **Remetente IDs disponível para associação**.

1. Escolha **Criar pool telefônico**.

## Etapa 2: criar um conjunto de configurações
<a name="getting-started-tutorial-step2"></a>

Os procedimentos nesta seção mostram como criar um conjunto de configurações, adicionar um destino CloudWatch Events, Amazon Data Firehose ou Amazon SNS e escolher os tipos de eventos.

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 **Visão geral**, na seção **Início rápido**, escolha **Criar configuração**.

1. Na seção **Detalhes do conjunto de configurações**, insira um nome em **Nome do conjunto de configurações**.

1. Para a **configuração do destino do evento**, escolha uma das seguintes opções:
   + **Configure CloudFormation** (recomendado) para CloudFormation criar e configurar o CloudWatch Amazon Data Firehose e o Amazon SNS para registrar todos os eventos. 
     + Em **Nome do destino do evento**, insira um nome para o destino de evento. 
     + Selecione **Iniciar Pilha**. 
     + Uma nova janela do navegador será aberta. Revise o formulário **Quick Create Stack** e verifique todas as confirmações. Selecione **Criar pilha**.
**nota**  
A criação da CloudFormation pilha pode levar até cinco minutos.
     + **Quando o indicador de status da CloudFormation pilha na página **Criar conjunto de configurações** for **Criada por pilha**, escolha Criar.**
   + **Configure o destino do evento** para configurar manualmente o conjunto de configurações e o destino do evento. 
     + Em **Nome do destino do evento**, insira um nome para o destino de evento. 
     + Para **Tipo de destino**, escolha Amazon Data Firehose ou Amazon SNS. CloudWatch Para obter mais informações sobre como configurar esses destinos de eventos [Configurar o destino do CloudWatch evento na Amazon](configuration-sets-cloud-watch.md), consulte [Configurar destino de evento Amazon Data Firehose](configuration-sets-kinesis.md) e [Configurar um destino de evento do Amazon SNS](configuration-sets-sns.md) 
     + Em **Tipos de eventos**, escolha a opção apropriada:
       + **Todos os eventos de SMS (recomendado)** — Envie todos os eventos de SMS listados [Tipos de eventos](configuration-sets-event-types.md) para o destino do evento.
       + **Eventos SMS personalizados** — Escolha eventos de SMS específicos para enviar ao destino do evento. Para editar a lista de eventos, escolha **Editar seleção de eventos por SMS**. Na janela **Editar seleção de eventos de SMS**, selecione somente os eventos que você deseja registrar. Escolha **Salvar seleção**.
       + **Todos os eventos MMS (recomendado)** — Envie todos os eventos MMS listados [Tipos de eventos](configuration-sets-event-types.md) para o destino do evento.
       + **Eventos MMS personalizados** — Escolha eventos MMS específicos para enviar ao destino do evento. Para editar a lista de eventos, escolha **Editar seleção de eventos por MMS**. Na janela de **seleção de eventos do Editar MMS**, selecione somente os eventos que você deseja registrar. Escolha **Salvar seleção**.
       + **Todos os eventos de voz (recomendado)** — Envie todos os eventos de voz listados [Tipos de eventos](configuration-sets-event-types.md) para o destino do evento.
       + **Eventos de voz personalizados** — Escolha eventos de voz específicos para enviar ao destino do evento. Para editar a lista de eventos, escolha **Editar seleção de eventos de voz**. Na janela **Editar seleção de eventos de voz**, escolha somente os eventos que você deseja registrar. Escolha **Salvar seleção**.
     + Escolha **Criar**.

1. Escolha **Criar conjunto de configuração**.

## Etapa 3: criar uma configuração de proteção
<a name="getting-started-tutorial-step4"></a>

Os procedimentos desta seção mostram como criar uma configuração de proteção para especificar para quais países as mensagens SMS do usuário AWS final podem enviar mensagens. 

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 **Visão geral**, na seção **Início rápido**, escolha **Criar configuração**.

1. Em **Detalhes da configuração de proteção**, insira um nome amigável para sua configuração de **proteção em Nome da configuração de proteção**.

1. Em Regras do país, selecione os países para os quais você deseja definir regras. Para cada país, escolha se deseja bloquear, filtrar ou permitir o envio de mensagens. Recomendamos:
   + Definir regras de bloqueio para países nos quais você não faz negócios.
   + Usar regras de filtro para países com altos custos por mensagem ou onde você tenha problemas com o envio de SMS.
   + Definir regras de permissão para países onde você não deseja usar o filtro.
**nota**  
Não bloqueie o país para o qual você enviará mensagens de teste na próxima etapa.

1. Em **Proteger associados de configuração**, em **Tipo de associação**, escolha **Associação do conjunto de configurações**. Em **Conjuntos de configurações disponíveis para associação**, escolha o conjunto de configurações que você criou na etapa 2.

1. Escolha **Criar configuração**.

## Etapa 4: Enviar uma mensagem de teste com o simulador de SMS
<a name="getting-started-tutorial-step3"></a>

**nota**  
Para adicionar um número de telefone de destino verificado, você deve ter um originador cujo status seja *Ativo*, consulte [Exibir o status e os recursos de um número de telefone no SMS de mensagens para o usuário AWS final](phone-numbers-status.md). Se você não tiver um originador *ativo*, use um número de telefone do simulador e um número de telefone de destino do simulador para enviar e receber a mensagem SMS de teste.

Os procedimentos nesta seção mostram como enviar uma mensagem de SMS de teste para verificar se o ambiente está configurado corretamente. 

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 **Visão geral**, na seção **Início rápido**, escolha **Testar envio de SMS**.

1. Para **Originador**, escolha **Pool telefônico**, **Número de telefone** ou **ID do remetente** como o tipo de originador para enviar a mensagem de teste. Em seguida, é necessário selecionar a identidade do originador na lista suspensa.

   1. (Opcional) Se você precisar de um número de telefone do simulador, escolha **Solicitar número do simulador**. Na janela **Número do simulador de solicitação**, escolha um **País** na lista suspensa e escolha **Número da solicitação**.
**Importante**  
Os números de telefone do simulador só podem ser enviados para outros números de telefone de destino do simulador, mas eles se comportam como números de telefone reais sem serem enviados pela rede da operadora. Não é possível usar um número de telefone do simulador para verificar um número de telefone de destino. Por exemplo, os números de telefone do simulador dos EUA só podem ser enviados para números de telefone do simulador de destino dos EUA. 

1. Na seção **Número de destino**, escolha o **número do simulador** ou o **número verificado** e, em seguida, selecione o número na lista suspensa.

   Para ver sua lista atual de números de destino verificados, escolha **Número verificado** e expanda **Gerenciar número de destino verificado**. Se você não tiver nenhum número de telefone de destino verificado ou precisar adicionar um novo número de telefone de destino verificado, faça o seguinte:

   1. Para verificar um novo número de telefone de destino, escolha **Verificar novo número**.

   1. Na janela **Adicionar número de telefone** para **Número de telefone de destino**, insira o número de telefone do dispositivo para receber a mensagem de teste. O número de telefone deve começar com um “\$1” e não pode conter espaços, hifens ou parênteses. Por exemplo, `+1 (206) 555-0142` não está no formato correto, mas `+12065550142` está.

   1. Escolha **Enviar e-mail de verificação**.

   1. O dispositivo de destino receberá um código de verificação válido por 15 minutos. Insira o código que o dispositivo recebeu no campo **Código de verificação**.

   1. Escolha **Verificar número**.

1. Em **conjunto de configuração**, escolha o destino do evento para receber os dados do evento. 

1. Em **Corpo da mensagem**, insira uma mensagem SMS personalizada.

1. Escolha **Enviar mensagem de teste**.

1. Em **Registros de eventos: CloudWatch**, escolha o botão Atualizar para exibir o registro de eventos da mensagem de teste.
**dica**  
Aguarde pelo menos 10 segundos após enviar a mensagem SMS de teste antes de atualizar.

## Migrar da sandbox para a produção
<a name="getting-started-tutorial-step1-next-steps"></a>

Depois de testar totalmente seu ambiente de SMS na sandbox de SMS, você pode solicitar por migrar para a produção.

1. Crie um AWS Support caso em [https://support.console.aws.amazon.com/support/home\$1/case/create? Tipo de problema = service-limit-increase](https://console.aws.amazon.com/support/home#/case/create?issueType=service-limit-increase).

1. Escolha o link **Procurando aumentos no limite de serviço?** e preencha o seguinte:
   + Em **Serviço**, escolha **AWS End User Messaging SMS (Pinpoint)**.
   + Em **Fornecer um link para o site ou aplicativo que enviará mensagens SMS**, forneça informações sobre o site, o aplicativo ou o serviço que enviará mensagens SMS.
   + Em **Qual tipo de mensagens você pretende enviar**, escolha o tipo de mensagem que você pretende enviar usando sua identidade de origem:
     + **Senhas de uso único**: mensagens que fornecem senhas que seus clientes usam para se autenticarem em seu site ou aplicação.
     + **Promocional**: mensagens não críticas que promovem o seu negócio ou serviço, como ofertas especiais ou anúncios.
     + **Transacional**: mensagens informativas importantes que oferecem suporte para transações do cliente, como confirmações de pedidos ou alertas de contas. As mensagens transacionais não devem conter conteúdo promocional nem de marketing.
   + Para De **qual você Região da AWS enviará mensagens, escolha Região da AWS a partir** da qual você enviará mensagens.
   + Em **Which countries do you plan to send messages to (Para quais países você planeja enviar mensagens)**, insira o país ou região em que deseja comprar códigos curtos.
   + Para **Como seus clientes optam por receber suas mensagens**, forneça detalhes sobre seu processo de consentimento.
   +  Para **Forneça o modelo de mensagem que você planeja usar para enviar mensagens aos seus clientes**, inclua o modelo que você usará.

1. Em **Solicitações**, preencha as seguintes seções:
   + Para a **Região**, escolha a Região da AWS partir da qual você enviará mensagens. 
**nota**  
A região é obrigatória na seção **Solicitações**. Mesmo que você tenha fornecido essas informações na seção **Detalhes do caso**, também é necessário incluí-las aqui.
   + Em **Tipo de recurso**, escolha **Limites gerais**.
   + Para a **Cota**, selecione **Acesso à produção de SMS**.
   + Para **Novo valor de cota**, insira 1.

1. Em **Descrição do caso**, em **Descrição do caso de uso**, insira todos os detalhes adicionais do caso de uso relevante sobre a solicitação.

1. (Opcional) Se você quiser enviar outras solicitações, escolha **Adicionar outra solicitação**. 

1. Em **Opções de contato**, para **Preferência de idioma de contato**, escolha se você deseja receber comunicações para esse caso em **inglês** ou **japonês**.

1. Quando terminar, escolha **Enviar**.