Slack

Visualização

Este produto ou recurso está sujeito aos "Termos das ofertas pré-GA" na seção "Termos de Serviço gerais" dos Termos específicos do 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 Dialogflow com o Slack permite criar bots do Slack com facilidade usando processamento de linguagem natural baseado na tecnologia do Dialogflow.

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 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 Aplicativos do Slack.
2. Criar 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 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 que você quiser.
   • Token de OAuth do usuário de bot
     • Navegue até 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

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 webhook no Slack

Volte para o aplicativo Slack e cole o URL do webhook em Assinaturas de eventos > Ativar eventos > URL de solicitação.

testes

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 no espaço de trabalho em que ele foi instalado ou envie uma mensagem direta.

Mensagens de resposta avançadas

As mensagens de resposta avançadas são compatíveis com o Payload personalizado em Fulfillment. Consulte a API Slack Message para ver 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

Quando configuradas, as respostas específicas do canal com o canal DF_CX_SLACK serão usadas automaticamente quando o agente responder a mensagens do Slack.