Integração de um bot do Amazon Lex com o Facebook Messenger - Amazon Lex V1

Se você estiver usando o Amazon Lex V2, consulte o Guia do Amazon Lex V2.

 

Se você estiver usando o Amazon Lex V1, recomendamos atualizar seus bots para o Amazon Lex V2. Não estamos mais adicionando novos atributos à V1 e recomendamos o uso da V2 para todos os novos bots.

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

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

      Formulário para integrar seu bot com o Facebook.
    6. 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.

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

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

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