Slack

A integração do Slack permite criar bots do Slack com facilidade, usando o processamento de linguagem natural baseado na tecnologia de agentes de conversa (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 seus apps do Slack.
  2. Crie um novo app do Slack com base em um manifesto de app. Confira um exemplo de manifesto abaixo. Verifique se 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 o aplicativo no espaço de trabalho de sua escolha.
    • Token OAuth do usuário de bot
      • Acesse Instalar app > Tokens OAuth para seu espaço de trabalho > Token OAuth do usuário bot
    • Token de assinatura
      • Navegue até "Informações básicas" > "Credenciais do app" > "Secret de assinatura".

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 do Slack e cole o URL do webhook em Assinaturas de eventos > Ativar eventos > URL da solicitação.

Teste

Para testar o app configurado, mencione-o em um canal de grupo ou envie uma mensagem direta no workspace 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 mensagens 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 será usado automaticamente quando o agente responder às mensagens do Slack.