Slack

A integração do Slack permite criar bots do Slack com facilidade, empregando processamento de linguagem natural baseado na tecnologia de agentes de conversação (Dialogflow CX).

Limitações

Configurar o Slack

Para configurar a integração de um agente com o Slack, é necessário ter:

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

Criar um bot do Slack

  1. Acesse os apps do Slack.
  2. Crie um novo app do Slack usando um manifesto de app. Confira abaixo um exemplo de manifesto. Verifique se os campos oath_config e event_subscriptions correspondem ao exemplo de manifesto. 
    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 o aplicativo no espaço de trabalho que você escolher
    • Token de acesso do OAuth do usuário do bot
      • Acesse "Instalar app" > "Tokens OAuth para seu Workspace" > "Token OAuth do usuário bot".
    • Token de assinatura
      • Navegue até Informações básicas > Credenciais do app > Assinatura secreta.

Configurar agentes de conversação (Dialogflow CX)

  1. Clique na guia Gerenciar no painel à esquerda.
  2. Clique em Integrations no menu à esquerda.
  3. Clique no botão Conectar no bloco Slack.
  4. Preencha as seguintes informações:
    • Token de acesso
    • Token de assinatura
  5. Escolha um ambiente, conforme aplicável.
  6. Clique em Iniciar.
  7. Copie o endereço em Webhook URL.

Ativar o webhook no Slack

Volte ao app Slack e cole o URL do webhook em Assinaturas de eventos > Ativar eventos > Solicitar URL.

Teste

Para testar o app configurado, mencione-o em um canal de grupo ou envie uma mensagem direta no espaço de trabalho em que ele foi instalado.

Mensagens de resposta avançadas

As mensagens de resposta avançadas são compatíveis com o Payload personalizado em Fulfillment. Consulte a API de mensagem do Slack para saber o formato da mensagem.

Por exemplo, o payload personalizado a seguir 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.