Aviso de fim do suporte: em 15 de setembro de 2025, o suporte para o Amazon Lex V1 AWS será interrompido. Após 15 de setembro de 2025, você não poderá mais acessar o console do Amazon Lex V1 nem os respectivos recursos. Se você estiver usando o Amazon Lex V2, consulte o [guia do Amazon Lex V2](https://docs.aws.amazon.com/lexv2/latest/dg/what-is.html) em vez disso. 

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

# Integração de um bot do Amazon Lex com o SMS programável do Twilio
<a name="twilio-bot-association"></a>

Este exercício fornece instruções para integrar um bot do Amazon Lex com o serviço de mensagens simples (SMS) do Twilio. Execute as seguintes etapas:

1. Criar um bot do Amazon Lex

1. Integre o SMS programável do Twilio com seu bot de Amazon Lex

1. Iniciar uma interação com o bot do Amazon Lex e testar a configuração usando o serviço SMS no celular

1. Teste da integração 

**Topics**
+ [Etapa 1: criar um bot do Amazon Lex](#twilio-bot-assoc-create-bot)
+ [Etapa 2: criar uma conta de SMS do Twilio](#twilio-bot-assoc-create-fb-app)
+ [Etapa 3: Integrar o endpoint do serviço de sistema de mensagens do Twilio com o bot do Amazon Lex](#twilio-bot-assoc-create-assoc)
+ [Etapa 4: teste a integração](#twilio-bot-test)

## Etapa 1: criar um bot do Amazon Lex
<a name="twilio-bot-assoc-create-bot"></a>

Se você ainda não tem um bot do Amazon Lex, crie e implante um. Neste tópico, pressupomos que você esteja usando o bot que criou no Exercício 1 dos Conceitos básicos. No entanto, você pode usar qualquer um dos bots de exemplo fornecidos neste guia. Para o Exercício 1 dos Conceitos básicos, consulte [Exercício 1: Criar um bot do Amazon Lex usando um esquema (Console).](gs-bp.md).

1. Crie um bot do Amazon Lex. Para instruções, consulte [Exercício 1: Criar um bot do Amazon Lex usando um esquema (Console).](gs-bp.md). 

1. Implante o bot e crie um alias. Para instruções, consulte [Exercício 3: publique uma versão e crie um alias](gettingstarted-ex3.md).

## Etapa 2: criar uma conta de SMS do Twilio
<a name="twilio-bot-assoc-create-fb-app"></a>

Cadastre-se para criar uma conta do Twilio e registre as seguintes informações de conta: 
+ **SID DA CONTA** 
+ **TOKEN DE AUTENTICAÇÃO** 

Para obter instruções de inscrição, consulte [https://www.twilio.com/console](https://www.twilio.com/console).

## Etapa 3: Integrar o endpoint do serviço de sistema de mensagens do Twilio com o bot do Amazon Lex
<a name="twilio-bot-assoc-create-assoc"></a>

**Como integrar o Twilio com seu bot de Amazon Lex**

1. Para associar o bot do Amazon Lex com o endpoint de SMS programável do Twilio, ative a associação de canal do bot no console do Amazon Lex. Quando a associação de canal do bot estiver ativada, o Amazon Lex retornará uma URL de retorno de chamada. Anote o URL de retorno de chamada, pois você precisará dele mais tarde.

   1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon Lex em [https://console.aws.amazon.com/lex/](https://console.aws.amazon.com/lex/).

   1. Selecione o bot do Amazon Lex que você criou na Etapa 1.

   1. Escolha a guia **Canais**.

   1. Na seção **Chatbots**, escolha **Twilio SMS**. 

   1. Na página **Twilio SMS**, forneça as seguintes informações:
      + Digite um nome. Por exemplo, .`BotTwilioAssociation`
      + Escolha "aws/lex" em **KMS key**.
      + Para **Alias**, escolha o alias bot.
      + Para **Authentication Token**, digite o TOKEN DE AUTORIZAÇÃO para sua conta do Twilio. 
      + Em **Account SID**, digite o SID DA CONTA do Twilio.  
![\[A tela de configuração do Twilio.\]](http://docs.aws.amazon.com/pt_br/lex/latest/dg/images/twilio-10a.png)

   1. Selecione **Ativar**. 

      O console cria a associação de canal de bot e retorna um URL de retorno de chamada. Anote o URL.

1. No console do Twilio, conecte o endpoint de SMS do Twilio ao bot do Amazon Lex.

   1. [Faça login no console Twilio em https://www.twilio.com /console.](https://www.twilio.com/console) 

   1. Se você não tiver um endpoint de SMS do Twilio, crie um.

   1. Atualize a configuração **Configurações de entrada** do serviço de mensagens definindo o valor **URL DA SOLICITAÇÃO** para o URL de retorno de chamada que o Amazon Lex forneceu na etapa anterior.

   

## Etapa 4: teste a integração
<a name="twilio-bot-test"></a>

Use seu celular para testar a integração entre o SMS do Twilio e o bot.

**Como testar a integração**

1. Entre no console do Twilio em [https://www.twilio.com/console](https://www.twilio.com/console) e faça o seguinte:

   1. Verifique se você tem um número do Twilio associado ao serviço de mensagens em **Manage Numbers**. 

      Envie mensagens para esse número e inicie uma interação por SMS com o bot do Amazon Lex no celular. 

   1. Verifique se seu telefone celular está na lista branca como **Verified Caller ID**. 

      Se não estiver, siga as instruções no console do Twilio para permitir o celular que você planeja usar para testes. 

      Agora, você pode usar o celular para enviar mensagens ao endpoint de SMS do Twilio, que é mapeado para o bot do Amazon Lex. 

1. Usando seu celular, envie mensagens para o número do Twilio. 

   O bot do Amazon Lex responde. Se você criou o bot usando o Exercício 1 dos Conceitos básicos, pode usar as conversas de exemplo fornecidas no exercício. Para obter mais informações, consulte [Etapa 4: Adicione a função do Lambda como hook de código (console)](gs-bp-create-integrate.md).