Slack

Visualizar

Esse produto ou recurso está sujeito aos "Termos de ofertas 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 facilita a criação de bots do Slack, empregando processamento de linguagem natural baseado 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

• Essa integração é compatível apenas com entrada de texto no idioma padrão do agente.

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 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: 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 aplicativo no espaço de trabalho de sua preferência.
   • Token OAuth do usuário de bot
     • Acesse Instalar app > Tokens OAuth para seu espaço de trabalho > Token OAuth do usuário de bot.
   • Token de assinatura
     • Acesse Informações básicas > Credenciais do app > Chave secreta de assinatura.

Configurar 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 URL do webhook.

Ativar o webhook no Slack

Volte ao seu app do Slack e cole o URL do webhook em Event Subscriptions > Enable Events > Request URL

Teste

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

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 mensagens do Slack para o formato da mensagem.

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

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 a mensagens do Slack.