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á.
# Implantação de bots do Amazon Lex
Esta seção fornece exemplos de implantação de bots do Amazon Lex em várias plataformas de sistema de mensagens e em aplicativos para dispositivos móveis.
**Topics**
+ [Implantação de um bot do Amazon Lex em uma plataforma de sistema de mensagens](example1.md)
+ [Implantação de um bot do Amazon Lex em aplicativos móveis](example2.md)
# Implantação de um bot do Amazon Lex em uma plataforma de sistema de mensagens
Esta seção explica como implantar bots do Amazon Lex nas plataformas de sistema de mensagens Facebook, Slack e Twilio.
**nota**
Ao armazenar as configurações do Facebook, Slack ou Twilio, o Amazon Lex usa uma CMK do AWS Key Management Service para criptografar as informações. Na primeira vez que você cria um canal para uma das seguintes plataformas de sistema de mensagens, o Amazon Lex cria uma CMK padrão (`aws/lex`). Como alternativa, você pode criar sua própria chave gerenciada pelo cliente com AWS KMS. Isso lhe dá mais flexibilidade, incluindo a capacidade de criar, girar e desabilitar as chaves. Você também pode definir controles de acesso e auditar as chaves de criptografia usadas para proteger seus dados. Para obter mais informações, consulte o [Guia do desenvolvedor do AWS Key Management Service](https://docs.aws.amazon.com/kms/latest/developerguide/).
Quando uma plataforma de sistema de mensagens envia uma solicitação ao Amazon Lex, informações específicas à plataforma são incluídas como um atributo de solicitação para a função do Lambda. Use esses atributos para personalizar a forma como o seu bot se comporta. Para obter mais informações, consulte [Definição de atributos de solicitação](context-mgmt-request-attribs.md).
Todos os atributos levam o namespace `x-amz-lex:` como prefixo. Por exemplo, o atributo `user-id` é chamado `x-amz-lex:user-id`. Existem atributos comuns que são enviados por todas as plataformas de mensagens, além de outros que são específicos de uma determinada plataforma. A tabela a seguir lista os atributos de solicitação que as plataformas de sistema de mensagens enviam à função do Lambda do bot.
**Atributos de solicitação comuns**
| Atributo | Descrição |
| --- | --- |
| channel-id | O identificador do endpoint do canal do Amazon Lex. |
| channel-name | O nome do canal do Amazon Lex. |
| channel-type | Um dos seguintes valores: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/lex/latest/dg/example1.html) |
| webhook-endpoint-url | O endpoint do Amazon Lex para o canal. |
**Atributos de solicitação do Facebook**
| Atributo | Descrição |
| --- | --- |
| user-id | O identificador do Facebook do remetente. Veja [https://developers.facebook.com/docs/messenger- platform/webhook-reference/message -received](https://developers.facebook.com/docs/messenger-platform/webhook-reference/message-received). |
| facebook-page-id | O identificador da página do Facebook do destinatário. Veja [https://developers.facebook.com/docs/messenger- platform/webhook-reference/message -received](https://developers.facebook.com/docs/messenger-platform/webhook-reference/message-received). |
**Atributos de solicitação do Kik**
| Atributo | Descrição |
| --- | --- |
| kik-chat-id | O identificador para a conversa no qual o bot está envolvido. Para obter mais informações, consulte [https://dev.kik.com/\$1/docs/messaging \$1message](https://dev.kik.com/#/docs/messaging#message-formats) -formats. |
| kik-chat-type | O tipo de conversa do qual a mensagem foi originada. Para obter mais informações, consulte [https://dev.kik.com/\$1/docs/messaging \$1message](https://dev.kik.com/#/docs/messaging#message-formats) -formats. |
| kik-message-id | Um UUID que identifica a mensagem. Para obter mais informações, consulte [https://dev.kik.com/\$1/docs/messaging \$1message](https://dev.kik.com/#/docs/messaging#message-formats) -formats. |
| kik-message-type | O tipo de mensagem. Para obter mais informações, consulte [https://dev.kik.com/\$1/docs/messaging \$1message](https://dev.kik.com/#/docs/messaging#message-types) -types. |
**Atributos de solicitação do Twilio**
| Atributo | Descrição |
| --- | --- |
| user-id | O número de telefone do remetente ("De"). Consulte [https://www.twilio.com/docs/api/rest/message](https://www.twilio.com/docs/api/rest/message). |
| twilio-target-phone-number | O número de telefone do destinatário ("Para"). Consulte [https://www.twilio.com/docs/api/rest/message](https://www.twilio.com/docs/api/rest/message). |
**Atributos de solicitação do Slack**
| Atributo | Descrição |
| --- | --- |
| user-id | O identificador do usuário do Slack. Veja [https://api.slack.com/types/o usuário](https://api.slack.com/types/user). |
| slack-team-id | O identificador da equipe que enviou a mensagem. Consulte [https://api.slack.com/methods/team.info](https://api.slack.com/methods/team.info). |
| slack-bot-token | O token do desenvolvedor que dá ao bot acesso ao Slack APIs. Veja os [https://api.slack.com/docs/tipos de tokens](https://api.slack.com/docs/token-types). |
# Integração de um bot do Amazon Lex com o Facebook Messenger
Este exercício mostra como integrar o Facebook Messenger ao bot do Amazon Lex. Execute as seguintes etapas:
1. Criar um bot do Amazon Lex
1. Criação de um aplicativo do Facebook
1. Integrar o Facebook Messenger ao seu bot do Amazon Lex
1. Validação da integração
**Topics**
+ [Etapa 1: criar um bot do Amazon Lex](#fb-bot-assoc-create-bot)
+ [Etapa 2: criar um aplicativo do Facebook](#fb-bot-assoc-create-fb-app)
+ [Etapa 3: integrar o Facebook Messenger ao bot do Amazon Lex](#fb-bot-assoc-create-assoc)
+ [Etapa 4: teste a integração](#fb-bot-test)
## Etapa 1: criar um bot do Amazon Lex
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 um aplicativo do Facebook
No portal de desenvolvedor do Facebook, crie um aplicativo do Facebook e uma página do Facebook. Para obter instruções, consulte [Início rápido](https://developers.facebook.com/docs/messenger-platform/guides/quick-start) na documentação da plataforma Facebook Messenger. Anote o seguinte:
+ O **App Secret** para o aplicativo do Facebook
+ O **Page Access Token** para a página do Facebook
## Etapa 3: integrar o Facebook Messenger ao bot do Amazon Lex
Nesta seção, você integrará o Facebook Messenger ao seu bot do Amazon Lex.
Depois de concluir essa etapa, o console fornece um URL de retorno de chamada. Anote esse URL.
**Para integrar o Facebook Messenger ao seu bot**
1.
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. Escolha seu bot do Amazon Lex.
1. Escolha **Canais**.
1. Escolha **Facebook** em **Chatbots**. O console exibe a página de integração do Facebook.
1. Na página de integração do Facebook:
+ Digite este nome: `BotFacebookAssociation`.
+ Para **KMS key**, escolha **aws/lex**.
+ Para **Alias**, escolha o alias bot.
+ Para **Verify token**, digite um token. Pode ser qualquer string que você escolher (por exemplo, `ExampleToken`). Use esse token posteriormente no portal de desenvolvedor do Facebook ao configurar o webhook.
+ Para acessar **Page access token**, digite o token que você obteve do Facebook na Etapa 2.
+ Para **App secret key**, digite a chave que você obteve do Facebook na Etapa 2.
![\[Formulário para integrar seu bot com o Facebook.\]](http://docs.aws.amazon.com/pt_br/lex/latest/dg/images/fb-10a.png)
1. Selecione **Ativar**.
O console cria a associação de canal de bot e retorna um URL de retorno de chamada. Anote esse URL.
1. No portal de desenvolvedor do Facebook, escolha seu aplicativo.
1. Escolha o produto **Messenger** e selecione **Setup webhooks** na seção **Webhook** da página.
Para obter instruções, consulte [Início rápido](https://developers.facebook.com/docs/messenger-platform/guides/quick-start) na documentação da plataforma Facebook Messenger.
1. Na página **webhook** do assistente de assinatura:
+ Para **Callback URL**, digite o URL de retorno de chamada no console do Amazon Lex anteriormente no procedimento.
+ Para **Verify Token**, digite o mesmo token usado no Amazon Lex.
+ Escolha **Subscription Fields** (**messages**, **messaging\$1postbacks** e **messaging\$1optins**).
+ Escolha **Verificar e salvar**. Isso inicia um handshake entre o Facebook e o Amazon Lex.
1. Ative a integração do Webhooks. Escolha a página que você criou e, em seguida, escolha **subscribe**.
**nota**
Se você atualizar ou recriar um webhook, deverá cancelar a assinatura e, em seguida, assinar a página novamente.
## Etapa 4: teste a integração
Agora, você pode iniciar uma conversa no Facebook Messenger com seu bot do Amazon Lex.
1. Abra a página do Facebook e escolha **Message**.
1. Na janela do Messenger, use os mesmas declarações de teste fornecidos no [Etapa 1: criar um bot Amazon Lex (console)](gs-bp-create-bot.md).
# Integrar um bot do Amazon Lex com o Kik
Este exercício fornece instruções para integrar um bot do Amazon Lex com o aplicativo de sistema de mensagens Kik. Execute as seguintes etapas:
1. Crie um bot do Amazon Lex.
1. Crie um bot do Kik usando o aplicativo e o site do sistema.
1. Integre o bot do Amazon Lex com o do Kik usando o console do Amazon Lex.
1. Inicie uma conversa com o bot do Amazon Lex usando o Kik para testar a associação entre o bot do Amazon Lex e o Kik.
**Topics**
+ [Etapa 1: criar um bot do Amazon Lex](kik-bot-assoc-create-bot.md)
+ [Etapa 2: criar um bot do Kik](kik-bot-assoc-create-kik-bot.md)
+ [Etapa 3: integrar o bot do Kik com o do Amazon Lex](kik-bot-assoc-create-assoc.md)
+ [Etapa 4: teste a integração](kik-bot-assoc-test.md)
# Etapa 1: criar um bot do Amazon Lex
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).
**Próxima etapa**
[Etapa 2: criar um bot do Kik](kik-bot-assoc-create-kik-bot.md)
# Etapa 2: criar um bot do Kik
Nesta etapa, use a interface de usuário do Kik para criar um bot. Use as informações geradas ao criar o bot para conectá-lo ao bot do Amazon Lex.
1. Se você ainda não tiver feito isso, baixe e instale o aplicativo do Kik e cadastre-se para criar uma conta. Se você já tem uma conta, faça login.
1. Abra o site da Kik em [https://dev.kik.com/](https://dev.kik.com). Deixe a janela do navegador aberta.
1. No aplicativo do Kik, selecione o ícone de engrenagem para abrir as configurações e, em seguida, selecione **Seu código Kid**.
1. Digitalize o código no site do Kik para abrir o chatbot do Botsworth. Selecione **Sim** para abrir o painel de bot.
1. No aplicativo do Kik, selecione **Criat um Bot**. Siga as solicitações para criar o bot do Kik.
1. Assim que o bot for criado, selecione **Configuração** no seu navegador. Verifique se o novo bot está selecionado.
1. Anote o nome do bot e a chave de API para a próxima seção.
**Próxima etapa**
[Etapa 3: integrar o bot do Kik com o do Amazon Lex](kik-bot-assoc-create-assoc.md)
# Etapa 3: integrar o bot do Kik com o do Amazon Lex
Agora que criou os bots do Amazon Lex e do Kik, você está pronto para criar um associação de canal entre eles no Amazon Lex. Quando a associação for ativada, o Amazon Lex configurará automaticamente uma URL de retorno de chamada com o Kik.
1. Faça login no AWS Management Console 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 **Canais**, selecione **Kik**.
1. Na página do Kik, insira as informações a seguir:
+ Digite um nome. Por exemplo, .`BotKikIntegration`
+ Digite uma descrição.
+ No menu suspenso **Chave do KMS**, escolha "aws/lex".
+ Em **Alias**, selecione um alias da lista suspensa.
+ Em **Nome de usuário do bot do Kik**, digite o nome que você deu ao bot no Kik.
+ Em **Chave da API do Kik**, digite a chave de API que foi atribuída ao bot no Kik.
+ Em **Saudação do usuário**, digite a saudação que você deseja que o bot envie na primeira vez em que um usuário iniciar um bate-papo com ele.
+ Em **Mensagem de erro**, insira uma mensagem de erro que é exibida ao usuário quando parte da conversa não é compreendida.
+ Em **Comportamento do bate-papo em grupo**, selecione uma das opções:
+ **Habilitar**: permite que todo o grupo de bate-papo interaja com o bot em uma única conversa.
+ **Desabilitar**: restringe a conversa a um usuário do grupo de bate-papo.
+ Selecione **Ativar** para criar a associação e vinculá-la ao bot do Kik.
![\[A tela de configuração do Kik.\]](http://docs.aws.amazon.com/pt_br/lex/latest/dg/images/kik-10.png)
**Próxima etapa**
[Etapa 4: teste a integração](kik-bot-assoc-test.md)
# Etapa 4: teste a integração
Agora que você criou uma associação entre o bot do Amazon Lex e o do Kik, use o aplicativo do Kik para testá-la.
1. Inicie o aplicativo do Kik e faça login. Selecione o bot que você criou.
1. Teste o bot da seguinte forma:
![\[1. "I would like to pick up flowers; 2. roses; 3. tomorrow; 4. 6:00 p.m.; 5. yes. (Desejo retirar flores; 2. rosas; 3. amanhã; 4. 18 horas; 5. sim.)"\]](http://docs.aws.amazon.com/pt_br/lex/latest/dg/images/kik-20.png)
À medida que você inserir cada frase, o bot do Amazon Lex responderá por meio do Kik com um prompt que você criou para cada slot.
# Integração de um bot de Amazon Lex com o Slack
Este exercício fornece instruções para integrar um bot do Amazon Lex com o aplicativo de sistema de mensagens Slack. Execute as seguintes etapas:
1. Crie um bot do Amazon Lex.
1. Crie um aplicativo de mensagem do Slack
1. Integre o aplicativo do Slack ao bot do Amazon Lex.
1. Teste a integração iniciando uma conversa com seu bot do Amazon Lex. Você envia mensagens com o aplicativo do Slack e testa em uma janela do navegador.
**Topics**
+ [Etapa 1: criar um bot do Amazon Lex](slack-bot-assoc-create-bot.md)
+ [Etapa 2: cadastre-se no Slack e crie uma equipe do Slack](slack-bot-assoc-create-team.md)
+ [Etapa 3: crie uma aplicação do Slack](slack-bot-assoc-create-app.md)
+ [Etapa 4: Integrar o aplicativo do Slack com o bot do Amazon Lex](slack-bot-assoc-create-assoc.md)
+ [Etapa 5: Completar a integração do Slack](slack-bot-back-in-slack-console.md)
+ [Etapa 6: teste a integração](slack-bot-test.md)
# Etapa 1: criar um bot do Amazon Lex
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).
**Próxima etapa**
[Etapa 2: cadastre-se no Slack e crie uma equipe do Slack](slack-bot-assoc-create-team.md)
# Etapa 2: cadastre-se no Slack e crie uma equipe do Slack
Cadastre-se em uma conta do Slack e crie uma equipe do Slack. Para obter instruções, consulte [Uso do Slack](https://get.slack.help/hc/en-us/articles/212675257-Creating-a-Slack-account). Na próxima seção, você criará uma aplicação do Slack que qualquer equipe do Slack pode instalar.
**Próxima etapa**
[Etapa 3: crie uma aplicação do Slack](slack-bot-assoc-create-app.md)
# Etapa 3: crie uma aplicação do Slack
Nesta seção, faça o seguinte:
1. Crie uma aplicação do Slack no console da API do Slack
1. Configure o aplicativo para adicionar mensagens interativas ao seu bot:
No final desta seção, você obterá as credenciais do aplicativo (ID do cliente, segredo do cliente e token de verificação). Na próxima seção, você usará essas informações para configurar a associação do canal do bot no console do Amazon Lex.
1. Faça login no console da API do Slack em [http://api.slack.com API ](http://api.slack.com).
1. Crie um aplicativo.
Depois de que você cria o aplicativo com êxito, o Slack exibe a página **Informações básicas** do aplicativo.
1. Configure os atributos da aplicação da seguinte forma:
1. No menu à esquerda, escolha **Interatividade e atalhos**.
+ Selecione o seletor para ativar os componentes interativos.
+ Na caixa **URL da solicitação** especifique qualquer URL válido. Por exemplo, você poderá usar o **https://slack.com**.
**nota**
Por enquanto, insira qualquer URL válida para obter o token de verificação necessário na próxima etapa. Você atualizará essa URL depois de adicionar a associação de canal do bot no console do Amazon Lex.
+ Escolha **Salvar alterações**.
1. No menu esquerdo, em **Configurações**, escolha **Informações básicas**. Registre as seguintes credenciais do aplicativo:
+ ID de cliente
+ Segredo do cliente
+ Token de verificação
**Próxima etapa**
[Etapa 4: Integrar o aplicativo do Slack com o bot do Amazon Lex](slack-bot-assoc-create-assoc.md)
# Etapa 4: Integrar o aplicativo do Slack com o bot do Amazon Lex
Agora que tem as credenciais do aplicativo do Slack, você pode integrar o aplicativo com o bot do Amazon Lex. Para associar o aplicativo do Slack a seu bot, adicione uma associação de canal do bot no Amazon Lex.
No console do Amazon Lex, ative uma associação de canal do bot para associar o bot ao aplicativo do Slack. Quando a associação do canal do bot é ativada, o Amazon Lex retorna dois URLs (URL do **Postback e **OAuthURL****). Grave-os URLs porque você precisará deles mais tarde.
**Para integrar o aplicativo do Slack ao bot do Amazon Lex**
1. Faça login no AWS Management Console 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. No menu esquerdo, selecione **Slack**.
1. Na página **Slack**, forneça os valores a seguir:
+ Digite um nome. Por exemplo, .`BotSlackIntegration`
+ No menu suspenso **Chave do KMS**, escolha "aws/lex".
+ Para **Alias**, escolha o alias bot.
+ Digite o **ID do cliente**, o **Segredo do cliente**e o **Token de verificação**, que você registrou na etapa anterior. Essas são as credenciais da aplicação do Slack.
![\[A tela de configuração do Slack.\]](http://docs.aws.amazon.com/pt_br/lex/latest/dg/images/slack-10a.png)
1. Selecione **Ativar**.
O console cria a associação do canal do bot e retorna duas URLs (URL do postback e OAuth URL). Anote-os. Na próxima seção, você atualizará a configuração da sua aplicação do Slack para usar esses endpoints conforme o seguinte:
+ A URL do Postback é o endpoint do bot do Amazon Lex que ouve aos eventos do Slack. Você usa este URL:
+ Como o URL de solicitação no atributo **Assinaturas de eventos** do aplicativo do Slack.
+ Para substituir o valor do espaço reservado para o URL solicitado no atributo **Mensagens interativas** do aplicativo do Slack.
+ A OAuth URL é o endpoint do seu bot Amazon Lex para um OAuth handshake com o Slack.
**Próxima etapa**
[Etapa 5: Completar a integração do Slack](slack-bot-back-in-slack-console.md)
# Etapa 5: Completar a integração do Slack
Nesta seção, use o console da API do Slack para completar a integração do aplicativo do Slack.
1. Faça login no console da API do Slack em [http://api.slack.com API](http://api.slack.com). Selecione o aplicativo que você criou em [Etapa 3: crie uma aplicação do Slack](slack-bot-assoc-create-app.md).
1. Atualize o recurso **OAuth & Permissões** da seguinte forma:
1. No menu à esquerda, escolha **OAuth & Permissões**.
1. Na URLs seção **Redirecionar**, adicione a OAuth URL que o Amazon Lex forneceu na etapa anterior. Escolha **Adicionar um novo URL de redirecionamento** e, em seguida, escolha **Salvar URLs**.
1. Na seção **Escopos do Bot Token**, adicione duas permissões com o botão **Adicionar um OAuth escopo**. Filtre a lista com o seguinte texto:
+ **chat:write**
+ **team:read**
1. Atualize o atributo **Interatividade e atalhos** atualizando o valor **URL da solicitação** para o URL do Postback que o Amazon Lex forneceu na etapa anterior. Insira o URL Postback que você salvou na etapa 4 e selecione **Salvar alterações**.
1. Assine o atributo **Assinaturas de eventos** da seguinte forma:
+ Habilite eventos escolhendo a opção **Ligado**.
+ Defina o valor da **URL da solicitação** como URL de Postback que o Amazon Lex forneceu na etapa anterior.
+ Na seção **Inscreva-se nos eventos do bot**, inscreva-se no evento de bot `message.im` para habilitar mensagens diretas entre o usuário final e o bot do Slack.
+ Salve as alterações.
1. Ative o envio de mensagens a partir da guia de mensagens da seguinte maneira:
+ No menu à esquerda, escolha **Página inicial do aplicativo**.
+ Na seção **Mostrar guias**, escolha **Permitir que os usuários enviem comandos e mensagens com barras a partir da guia de mensagens**.
**Próxima etapa**
[Etapa 6: teste a integração](slack-bot-test.md)
# Etapa 6: teste a integração
Agora, use uma janela do navegador para testar a integração do Slack com o bot do Amazon Lex.
1. Escolha **Gerenciar distribuição** em **Configurações**. Escolha **Adicionar ao Slack** para instalar o aplicativo. Autorize o bot a responder a mensagens.
1. Você é redirecionado para sua equipe do Slack. No menu esquerdo, na seção **Mensagens diretas**, escolha o bot. Se você não vir o bot, escolha o ícone de mais (\$1) ao lado de **Mensagens diretas** para procurá-lo.
1. Inicie um bate-papo com o aplicativo do Slack, que está vinculado ao bot do Amazon Lex. Seu bot agora responde a mensagens.
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).
# Integração de um bot do Amazon Lex com o SMS programável do Twilio
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
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
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
**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
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).
# Implantação de um bot do Amazon Lex em aplicativos móveis
Usando AWS Amplify, você pode integrar seus bots do Amazon Lex com aplicativos móveis ou web. Para obter mais informações, consulte [Interações: introdução](https://docs.amplify.aws/lib/interactions/getting-started/q/platform/js) nos *documentos do AWS Amplify *.