Messenger do Facebook

Com a integração do Facebook Messenger do Dialogflow, pode criar um bot do Facebook Messenger para interagir com os seus utilizadores finais.

Limitações

Apenas o idioma do agente predefinido é suportado por esta integração.

Como funciona

Veja como funciona a integração:

Configuração

Para configurar a integração:

  1. Siga os passos para criar uma app Facebook: Desenvolvimento de apps Facebook.

  2. Configure a app Facebook para usar a plataforma Facebook Messenger. Siga os passos na documentação Configurar a sua app do Facebook para realizar o seguinte:

    • Adicione a plataforma Messenger à sua app Facebook.
    • Subscreva a sua app numa página do Facebook. Neste passo, é-lhe fornecido um token de acesso. Copie este valor. Este token é usado para configurar a integração a partir da consola do Dialogflow.
    • Não configure o webhook nem teste a integração ainda.

  3. Configure a integração a partir da consola do Dialogflow:

    1. Aceda à consola do Dialogflow ES.
    2. Clique em Integrações no menu da barra lateral esquerda.
    3. Clique em Facebook Messenger.

    4. É aberta uma caixa de diálogo de configuração:

      • Mostrar URL de retorno antigo: Se este botão for apresentado, está desativado por predefinição. Esta é uma opção temporária para acomodar uma modificação recente à API Facebook Messenger. Não altere este botão, a menos que receba instruções do apoio técnico do Dialogflow. Depois de todos os agentes serem atualizados, esta opção é removida.
      • URL de retorno: copie este valor. Esta opção é usada para configurar o webhook do Facebook Messenger.
      • Validar token: pode introduzir qualquer token privado de que necessite. Copie este valor. Esta opção é usada para configurar o webhook do Facebook Messenger.
      • Chave de acesso da página: introduza a chave de acesso que copiou quando criou a página do Facebook.
      • Iniciar: clique para iniciar este serviço de integração para o seu agente.

  4. Conclua a configuração da app Facebook e teste-a. Siga os passos na documentação Configurar a sua app do Facebook para realizar o seguinte:

    • Configure o webhook do Facebook para a sua app. Use os valores do URL de retorno e do token de validação que copiou acima. Certifique-se de que ativa as opções messages e messaging_postbacks.
    • Teste a sua app.

Eventos

Os seguintes eventos são invocados por esta integração:

Evento Descrição
FACEBOOK_WELCOME Acionado quando um utilizador final inicia uma conversa com o seu bot.

Mensagens de resposta avançadas

Esta integração traduz algumas mensagens de resposta enriquecidas em tipos de mensagens da plataforma Facebook Messenger.

Respostas com imagens

As respostas com imagens são enviadas para o Facebook Messenger como mensagens de anexos de ficheiros do Facebook Messenger. O valor message.attachment.type é definido como image. São suportados os seguintes formatos:

  • jpg
  • png
  • GIF estático
  • GIF animado

Respostas de cartões

As respostas de cartões são enviadas para o Facebook Messenger como modelos genéricos do Facebook Messenger.

Respostas rápidas

As respostas rápidas são enviadas para o Facebook Messenger como respostas rápidas do Facebook Messenger.

Respostas de payload personalizadas

Para enviar outros tipos de mensagens do Facebook Messenger, pode usar um payload personalizado.

O formato geral da carga útil personalizada tem o seguinte aspeto:

{
  "facebook": {
    message
  }
}

Em vez de message, indique o objeto message do Facebook Messenger. Para ver detalhes do objeto message, consulte a referência da API Facebook Messenger.

Por exemplo:

  • Envie um link de áudio: 
    {
  "facebook": {
    "attachment": {
      "type": "audio",
      "payload": {
        "url": "https://example.com/audio/test.mp3"
      }
    }
  }
}
  • Envie um vídeo reproduzível: 
    {
  "facebook": {
    "attachment": {
      "type": "video",
      "payload": {
        "url": "https://example.com/video.mp4"
      }
    }
  }
}
  • Enviar um ficheiro: 
    {
  "facebook": {
    "attachment": {
      "type": "file",
      "payload": {
        "url": "https://example.com/file.pdf"
      }
    }
  }
}