Slack

A integração do Slack permite-lhe criar facilmente bots do Slack com compreensão de linguagem natural baseada na tecnologia de agentes de conversação (Dialogflow CX).

Limitações

Configure o Slack

Para configurar a integração do Slack para o seu agente, precisa do seguinte:

  • Uma conta do Slack
  • Um espaço de trabalho do Slack

Crie um bot do Slack

  1. Navegue para as suas apps do Slack
  2. Crie uma nova app do Slack a partir de um manifesto de app. Segue-se um exemplo de um manifesto. Certifique-se de que os campos oath_config e event_subscriptions correspondem ao manifesto de exemplo.
    display_information:
      name: Conversational Agents (Dialogflow CX)
      description: Conversational Agents (Dialogflow CX) integration
      background_color: "#1148b8"
    features:
      app_home:
        home_tab_enabled: false
        messages_tab_enabled: true
        messages_tab_read_only_enabled: false
      bot_user:
        display_name: CX
        always_online: true
    oauth_config:
      scopes:
        bot:
          - app_mentions:read
          - chat:write
          - im:history
          - im:read
          - im:write
          - incoming-webhook
    settings:
      event_subscriptions:
        request_url: https://dialogflow-slack-4vnhuutqka-uc.a.run.app
        bot_events:
          - app_mention
          - message.im
      org_deploy_enabled: false
      socket_mode_enabled: false
      token_rotation_enabled: false
    
  3. Instale a sua aplicação no espaço de trabalho à sua escolha
    • Token OAuth do utilizador do bot
      • Navegue para Install App > OAuth Tokens for Your Workspace > Bot User OAuth Token
    • Token de assinatura
      • Navegue para Informações básicas > Credenciais da app > Segredo de assinatura

Configure agentes de conversação (Dialogflow CX)

  1. Clique no separador Gerir no painel esquerdo.
  2. Clique em Integrações no menu do lado esquerdo.
  3. Clique no botão Associar no mosaico Slack.
  4. Preencha as seguintes informações:
    • Chave de acesso
    • Token de assinatura
  5. Escolha um ambiente, conforme aplicável.
  6. Clique em Iniciar.
  7. Copie o URL do webhook.

Ative o webhook no Slack

Regresse à app Slack e cole o URL do webhook em Subscrições de eventos > Ativar eventos > Pedir URL

Testes

Para testar a app configurada, no espaço de trabalho onde a instalou, mencione-a num canal de grupo ou envie-lhe uma MD.

Mensagens de resposta avançadas

As mensagens de resposta avançada são suportadas através de carga útil personalizada no preenchimento. Consulte a API de mensagens do Slack para ver o formato das mensagens.

Por exemplo, a seguinte carga útil personalizada fornece uma mensagem de texto simples do Slack:

{
  "text": "Hello, world"
}

Respostas específicas do canal

Depois de configurar as respostas específicas do canal, o canal DF_CX_SLACK é usado automaticamente quando o agente responde a mensagens do Slack.