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. Você executa as seguintes etapas:

1. Criar um bot do Amazon Lex

2. Criação de um aplicativo do Facebook

3. Integrar o Facebook Messenger ao seu bot do Amazon Lex

4. Validação da integração

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

1. Crie um bot do Amazon Lex. Para obter instruções, consulte Exercício 1: Criar um bot do Amazon Lex usando um esquema (Console)..

2. Implante o bot e crie um alias. Para obter instruções, consulte Exercício 3: publique uma versão e crie um alias.

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 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 AWS Management Console e abra o console do Amazon Lex em https://console.aws.amazon.com/lex/.

   2. Escolha seu bot do Amazon Lex.

   3. Escolha Canais.

   4. Escolha Facebook em Chatbots. O console exibe a página de integração do Facebook.

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

      

   6. Selecione Ativar.

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

2. No portal de desenvolvedor do Facebook, escolha seu aplicativo.

3. Escolha o produto Messenger e selecione Setup webhooks na seção Webhook da página.

   Para obter instruções, consulte Início rápido na documentação da plataforma Facebook Messenger.

4. 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_postbacks e messaging_optins).

   • Escolha Verify and Save. Isso inicia um handshake entre o Facebook e o Amazon Lex.

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

2. Na janela do Messenger, use os mesmas declarações de teste fornecidos no Etapa 1: criar um bot Amazon Lex (console).