

**Aviso de fim do suporte:** em 30 de outubro de 2026, AWS encerrará o suporte para o Amazon Pinpoint. Após 30 de outubro de 2026, você não poderá mais acessar o console do Amazon Pinpoint nem seus recursos (endpoints, segmentos, campanhas, jornadas e analytics). Para obter mais informações, consulte [Fim do suporte do Amazon Pinpoint](https://docs.aws.amazon.com/console/pinpoint/migration-guide). **Observação:** APIs relacionados a SMS, voz, push móvel, OTP e validação de número de telefone não são afetados por essa alteração e são compatíveis com o AWS End User Messaging.

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

# Configurar o Amazon API Gateway para mensagens SMS no Amazon Pinpoint
<a name="tutorials-two-way-sms-part-4"></a>

Nesta seção, você vai criar uma API usando o Amazon API Gateway como parte do registro de SMS para o Amazon Pinpoint. O formulário de registro que você implanta nessa solução chama essa API. Em seguida, o API Gateway envia as informações capturadas no formulário de registro para a função do Lambda que você criou em [Criar funções do Lambda](tutorials-two-way-sms-part-3.md).

## Criar a API
<a name="tutorials-two-way-sms-part-4-create-api"></a>

Primeiro, é preciso criar uma API no API Gateway. Os procedimentos a seguir mostram como criar uma API REST.

**Para criar uma API**

1. Abra o console do API Gateway em [https://console.aws.amazon.com/apigateway/](https://console.aws.amazon.com/apigateway/). 

1. Selecione **Criar API**. Faça as seguintes seleções:
   + Em **Choose the protocol (Escolher o protocolo)**, selecione **REST**.
   + Em **Create new API** (Criar nova API), selecione **New API** (Nova API).
   + Em **Settings (Configurações)**, para **Name (Nome)**, insira um nome, como **RegistrationForm**. Para **Description (Descrição)**, insira, como opção, algum texto que descreva o objetivo da API. Em **Endpoint Type (Tipo de endpoint)**, escolha **Regional**. Em seguida, selecione **Create API (Criar API)**.

   Um exemplo dessas configurações é mostrado na imagem a seguir.  
![\[Protocolo definido como REST, Criar nova API definido como Nova API, Nome da API definido como e Tipo de endpoint definido como Regional. RegistrationForm\]](http://docs.aws.amazon.com/pt_br/pinpoint/latest/userguide/images/SMS_Reg_Tutorial_APIGW_Step2.png)

## Criar um recurso
<a name="tutorials-two-way-sms-part-4-create-resource"></a>

Agora que você criou uma API, é possível começar a adicionar recursos a ela. Depois disso, você adiciona um método POST ao recurso e informa ao API Gateway para transmitir os dados recebidos desse método para a função do Lambda.

1. No menu **Actions (Ações)**, escolha **Create Resource (Criar recurso)**. No painel **New Child Resource (Novo recurso filho)**, para **Resource Name (Nome do recurso)**, insira **register**, conforme mostrado na imagem a seguir. Escolha **Create Resource** (Criar recurso).  
![\[O novo painel de recursos secundários com o nome do recurso definido como registro.\]](http://docs.aws.amazon.com/pt_br/pinpoint/latest/userguide/images/SMS_Reg_Tutorial_APIGW_Step3.png)

1. No menu **Actions (Ações)**, selecione **Create Method (Criar método)**. No menu exibido, escolha **POST**, conforme mostrado na imagem a seguir. Em seguida, escolha o botão de **marca de seleção**.  
![\[O painel de criação do método com a marca de seleção selecionada.\]](http://docs.aws.amazon.com/pt_br/pinpoint/latest/userguide/images/SMS_Reg_Tutorial_APIGW_Step4.png)

1. No painel **/register - POST - Setup**, faça as seguintes seleções:
   + Em **Integration type (Tipo de integração)**, escolha **Lambda Function (Função do Lambda)**.
   + Selecione **Usar a integração de proxy do Lambda**.
   + Em **Região do Lambda**, escolha a Região na qual você criou a função do Lambda.
   + Para **Função Lambda**, escolha a RegisterEndpoint função que você criou em Criar funções [Lambda](tutorials-two-way-sms-part-3.md).

   Um exemplo dessas configurações é mostrado na imagem a seguir.  
![\[O painel /register - POST - Configuração com a Função do Lambda selecionada.\]](http://docs.aws.amazon.com/pt_br/pinpoint/latest/userguide/images/SMS_Reg_Tutorial_APIGW_Step5.png)

   Escolha **Salvar**. Na janela exibida, escolha **OK** para conceder permissão ao API Gateway para executar a função do Lambda.

## Implantar a API
<a name="tutorials-two-way-sms-part-4-deploy-api"></a>

Agora a API está pronta para uso. Nesse ponto, é preciso implantá-la para criar um endpoint publicamente acessível.

1. No menu **Actions (Ações)**, escolha **Deploy API (Implantar API)**. Na janela **Deploy API (Implantar API)**, faça as seguintes seleções:
   + Em **Estágio de implantação**, escolha **Novo estágio**.
   + Em **Stage name (Nome do estágio)**, insira **v1**.
   + Escolha **Deploy** (Implantar).

   Um exemplo dessas seleções é mostrado na imagem a seguir.  
![\[As janelas de implantação da API com o nome do Estágio definido como v1\]](http://docs.aws.amazon.com/pt_br/pinpoint/latest/userguide/images/SMS_Reg_Tutorial_APIGW_Step6.png)

1. No painel **v1 Stage Editor (Editor do estágio v1)**, escolha o recurso **/register** e depois o método **POST**. Copie o endereço exibido ao lado de **Invoke URL Invocar URL)**, conforme mostrado na imagem a seguir.  
![\[O painel Editor de estágio v1 mostrando o URL de invocação a ser copiado\]](http://docs.aws.amazon.com/pt_br/pinpoint/latest/userguide/images/SMS_Reg_Tutorial_APIGW_Step7.png)

1. No painel de navegação, escolha **Resources (Recursos)**. Na lista de recursos, escolha o recurso **/register**. Por fim, no menu **Actions (Ações)**, escolha **Enable CORS (Habilitar o CORS)**, conforme mostrado na imagem a seguir.  
![\[O menu suspenso de Ações mostrando que a opção Ativar CORS está selecionada\]](http://docs.aws.amazon.com/pt_br/pinpoint/latest/userguide/images/SMS_Reg_Tutorial_APIGW_Step8.png)

1. Na painel **Enable CORS (Habilitar o CORS)**, escolha **Enable CORS and replace existing CORS headers (Habilitar o CORS e substituir os cabeçalhos do CORS existentes)**.

**Próximo**: [Criar e implantar o formulário da Web](tutorials-two-way-sms-part-5.md)