Slack

Visualizar

Este produto ou recurso está sujeito aos Termos das Soluções Pré-GA na seção Termos Gerais de Serviço dos Termos Específicos de Serviço. Os produtos e recursos pré-GA estão disponíveis "no estado em que se encontram" e podem ter suporte limitado. Para mais informações, consulte as descrições da fase de lançamento.

A integração do Slack permite criar bots do Slack com processamento de linguagem natural com base na tecnologia do Dialogflow CX.

Observação: ao usar uma integração de terceiros, as solicitações e os dados do usuário final são enviados ao Google e ao terceiro. Os Termos de Serviço, o SLA, os preços e as cotas da edição do agente são aplicáveis ao processamento dessas solicitações pelo Google. Os Termos de Serviço, o SLA, os preços e as cotas de terceiros são aplicáveis ao processamento dessas solicitações por terceiros.

Limitações

• Somente a entrada de texto no idioma padrão do agente é compatível com essa integração.

Configurar o Slack

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

• 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 usando um manifesto de app. Confira a seguir um exemplo de manifesto: Verifique se os campos oauth_config e event_subscriptions correspondem ao manifesto de exemplo:

   display_information:
     name: Dialogflow CX
     description: 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 app no espaço de trabalho que quiser:

   • Token OAuth do usuário do bot:acesse Install App > OAuth Tokens for Your Workspace > Bot User OAuth Token.
   • Token de assinatura:acesse Basic Information > App Credentials > Signing Secret.

Configurar o Dialogflow CX

1. Acesse a guia Gerenciar no menu de navegação.
2. Selecione Integrações.
3. Clique no botão Conectar no bloco do Slack.
4. Informe o seguinte:
   • Token de acesso
   • Token de assinatura
5. Selecione um ambiente, conforme aplicável.
6. Clique em Iniciar.
7. Copie o endereço em Webhook URL.

Ativar o webhook no Slack

Acesse Apps do Slack e cole o URL do webhook em Inscrições em eventos > Ativar eventos > URL de solicitação.

Teste

Observação: verifique se o faturamento está ativado no projeto antes de testar a integração.

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

Mensagens de resposta avançadas

As mensagens de resposta avançada são compatíveis com o uso de payload personalizado no fulfillment. Para mais informações, consulte a API de mensagens do Slack para ver o formato da mensagem.

Observação: se não for especificado no payload personalizado, o campo channel será injetado automaticamente com o channel_id da mensagem de entrada.

Por exemplo, o payload personalizado a seguir fornece uma mensagem de texto 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 às mensagens do Slack.