Slack

A integração do Slack permite criar bots do Slack facilmente com processamento de linguagem natural com base 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 a partir de 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 seu aplicativo no espaço de trabalho de sua escolha
    • Token de OAuth do usuário do bot
      • Navegue até Instalar app > Tokens OAuth para seu espaço de trabalho > Token de OAuth do usuário do 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 para o aplicativo Slack e cole o webhook em Inscrições em 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 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.