Workplace do Facebook

É possível criar um bot do Workplace do Facebook para interagir com seus usuários finais usando a integração do Dialogflow com o Workplace do Facebook.

Limitações

Essa integração é compatível apenas com o idioma padrão do agente.

Como funciona

A integração funciona assim:

  • Você configura a integração do Dialogflow e a instância do Workplace para que eles se comuniquem.
  • A integração com o Dialogflow envia mensagens ao usuário final usando a API Messenger do Facebook.
  • A integração do Dialogflow recebe mensagens do usuário final atuando como o webhook do Workplace do Facebook.

Iniciar

Para iniciar a integração:

  1. Registre uma instância do Workplace (em inglês) se não tiver uma e verifique se você é o administrador do sistema do grupo.

  2. Ative a integração no Console do Dialogflow:

    1. Acesse o Console do Dialogflow ES.
    2. Clique em Integrations no menu da barra lateral à esquerda.
    3. Clique em Workplace do Facebook.
    4. Clique em INICIAR e você será redirecionado para o Workplace para concluir a instalação:
      • Faça login na sua conta do Workplace. A conta precisa ser um administrador do sistema no Workplace para instalar integrações.
      • Clique em adicionar o Workplace na janela pop-up que solicita a instalação da integração do Dialogflow. Você também tem a opção de personalizar o nome do bot.

  3. Testar seu aplicativo:

    1. Acesse Workplace e faça login na conta.
    2. Localize Dialogflow (ou o nome personalizado do bot) em Bots na seção Home da barra lateral e comece a conversar com o bot.

Cancelar

Se você clicou no botão START, mas não quer terminar a instalação no Workplace:

  1. Acesse o Console do Dialogflow ES.

  2. Clique em Integrations no menu da barra lateral à esquerda.

  3. Clique em Facebook Workplace:

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

Stop

Para interromper uma integração instalada:

  1. Acesse o Console do Dialogflow ES.

  2. Clique em Integrations no menu da barra lateral à esquerda.

  3. Clique em Facebook Workplace.

  4. Clique em PARAR e você será redirecionado para o Workplace para concluir a instalação:

    1. Faça login na sua conta do Workplace. Ela precisa ser um Administrador do sistema no Workplace para desinstalar as integrações.
    2. Encontre e selecione a integração do Dialogflow com as integrações instaladas no Workplace e clique em Desinstalar para concluir a desinstalação.

  5. A integração com o Dialogflow será desinstalada.

Mensagens de resposta avançadas

Essa integração converte algumas mensagens de resposta avançada em tipos de mensagens da plataforma do Facebook Messenger.

Respostas de imagem

As respostas de imagem são enviadas ao Facebook Messenger como mensagens de anexo de arquivo do Facebook Messenger. O valor message.attachment.type é definido como image. Os seguintes formatos são compatíveis:

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

Cards de resposta

Os cards de resposta são enviados ao Facebook Messenger como modelos genéricos do Facebook Messenger.

Respostas rápidas

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

Respostas de payload personalizadas

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

O formato geral do payload personalizado é assim:

{
  "facebook": {
    message
  }
}

No lugar de message, forneça o objeto message do Facebook Messenger. Para detalhes do objeto message, veja a referência da API Facebook Messenger.

Por exemplo:

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

Limitações

  1. Um agente do Dialogflow só pode ser instalado em uma instância do Workplace, mas é possível instalar vários agentes do Dialogflow em uma única instância do Workplace.

  2. Para remover uma instalação com falha, você precisa cancelar a instalação no Dialogflow e remover a instalação no Workplace.

Migração

Se você estiver usando a integração do Messenger e migrá-la para a integração do Workplace, será necessário:

  1. Interromper a integração com o Messenger.

  2. Remover o callback_url no aplicativo Facebook revertendo as etapas em Como configurar seu aplicativo do Facebook.

  3. Iniciar a integração do Workplace seguindo as etapas acima.