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 Facebook Messenger
<a name="fb-bot-association"></a>

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
<a name="fb-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 um aplicativo do Facebook
<a name="fb-bot-assoc-create-fb-app"></a>

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
<a name="fb-bot-assoc-create-assoc"></a>

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
<a name="fb-bot-test"></a>

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