Workplace from Facebook

Com a integração do Dialogflow com o Facebook Workplace, pode criar um bot do Workplace from Facebook 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 a integração do Dialogflow e a instância do Workplace, para que comuniquem entre si.
  • A integração do Dialogflow envia mensagens ao utilizador final através da API Messenger do Facebook.
  • A integração do Dialogflow recebe mensagens do utilizador final através da atuação como o webhook do Workplace do Facebook.

Iniciar

Para iniciar a integração:

  1. Registe uma instância do Workplace, se não tiver uma, e certifique-se de que é o administrador do sistema do grupo.

  2. Ative 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 Workplace do Facebook.
    4. Clique em INICIAR e é redirecionado para o Workplace para concluir a instalação:
      • Inicie sessão na sua conta do Workplace. A conta tem de ser um administrador do sistema no Workplace para instalar integrações.
      • Clique em Adicionar ao Workplace na janela de pop-up que lhe pede para instalar a integração do Dialogflow. Também tem a opção de personalizar o nome do bot.

  3. Teste a sua app:

    1. Aceda ao Workplace e inicie sessão na conta.
    2. Encontre o Dialogflow (ou o nome personalizado do seu bot) em Bots na secção Início da barra lateral e comece a conversar com o bot.

Cancelar

Se clicou no botão INICIAR, mas não quer concluir a instalação no Workplace:

  1. Aceda à consola do Dialogflow ES.

  2. Clique em Integrações no menu da barra lateral esquerda.

  3. Clique em Facebook Workplace:

    1. Se vir um botão CANCELAR: clique em CANCELAR para cancelar a instalação.
    2. Se vir um botão PARAR: siga as instruções abaixo para desinstalar a integração.

Parar

Para parar uma integração instalada com êxito:

  1. Aceda à consola do Dialogflow ES.

  2. Clique em Integrações no menu da barra lateral esquerda.

  3. Clique em Facebook Workplace.

  4. Clique em PARAR e vai aceder ao Workplace para concluir a instalação:

    1. Inicie sessão na sua conta do Workplace. A conta tem de ter a função de administrador do sistema no Workplace para desinstalar integrações.
    2. Encontre e selecione a integração do Dialogflow nas integrações instaladas no Workplace e clique em Desinstalar para concluir a desinstalação.

  5. A integração do Dialogflow vai ser desinstalada.

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"
      }
    }
  }
}

Limitações

  1. Um agente do Dialogflow só pode ser instalado numa instância do Workplace, mas pode instalar vários agentes do Dialogflow numa instância do Workplace.

  2. Para remover uma instalação com falha, tem de cancelar a instalação no Dialogflow e remover a instalação no Workplace.

Migração

Se estiver a usar a integração do Messenger e a for migrar para a integração do Workplace, tem de:

  1. Pare a integração do Messenger.

  2. Remova o callback_url na app Facebook invertendo os passos em Configurar a sua app Facebook.

  3. Inicie a integração do Workplace seguindo os passos acima.