Slack

A integração do Slack ao Dialogflow facilita a criação de aplicativos e bots do Slack, além de treiná-los para processar a linguagem natural.

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 o idioma do agente padrão é compatível com essa integração.

Como configurar o Slack

Para configurar a integração de um agente com o Slack, é necessário ter:

• uma conta do Slack
• uma equipe do Slack

Criar um aplicativo do Slack

1. Acesse o Console de desenvolvimento do Slack.
2. Digite o nome do aplicativo.
3. Escolha a equipe a que o aplicativo estará associado.
4. Clique no botão Create App.

Adicionar um usuário de bot

1. Clique em OAuth e permissões no menu à esquerda.
2. Acesse a seção Escopos e verifique se os seguintes escopos do OAuth estão na seção "Scope Token Scopes" ()
3. Clique em Página inicial do aplicativo no menu à esquerda.
4. Ative Always Show My Bot as Online e edite App Dislay Name se necessário. Isso é o que os usuários verão para seu bot.

Como ativar a integração no Dialogflow

No console para desenvolvedores do Slack, clique em Basic Information no menu à esquerda e role até a seção App Credentials. Anote os dados de Client ID, Client Secret e Verification Token.

Vincular o Slack ao Dialogflow

1. No Dialogflow, acesse Integrations no menu à esquerda.
2. Clique no bloco Slack.
3. Digite os valores relacionados nos seguintes campos:
   1. ID do cliente
   2. Client Secret
   3. Verification Token
4. Clique em Start.

Como continuar a configuração do Slack

Depois de configurar o Slack e o Dialogflow, ative o OAuth, os URLs de solicitação de evento (fornecidos pelo Dialogflow) e as assinaturas de eventos.

Adicionar o URL do OAuth

1. Copie o URL do OAuth da página de configurações do Dialogflow no Slack.

Observação: caso seu aplicativo Slack seja um app do Slack clássico e você ainda não tenha feito o upgrade, clique em Mostre URLs do fluxo de trabalho legado do Slack na página de configuração do Slack no Dialogflow e copie o URL do OAuth. Consulte Guia de início rápido: diferenças entre os apps antigos e novos do Slack para mais informações.

1. Acesse o console de desenvolvimento do Slack e clique em OAuth & Permissions no menu à esquerda.
2. Clique no botão Add a new Redirect URL e cole o URL do OAuth.
3. Clique em Add.
4. Clique no botão Salvar URLs.

Adicionar o URL de solicitação de evento e ativar as inscrições de evento

1. Copie o URL de solicitação de evento da página de configurações do Dialogflow no Slack.
2. Acesse o console de desenvolvimento do Slack e clique em Event Subscriptions no menu à esquerda.
3. Clique na chave para ativar os eventos e cole o URL de assinatura de evento no campo Request URL.
   
   Depois de alguns instantes, você verá um campo verde "Verified" acima do campo "Request URL".

4. Na seção Subscribe to Bot Events, clique no botão Add Bot User Event.
   
   Serão exibidos o campo de texto e a lista de eventos. Digite termos nesse campo para pesquisar os eventos a que você quer que o bot responda. Veja uma lista de termos sugeridos:
   

   Nome do evento	Descrição do evento
   message.im	Uma mensagem foi postada em um canal de mensagem direta.
   message.groups	Uma mensagem foi postada em um canal privado.
   message.channels	Uma mensagem foi postada em um canal.
   im_created	Uma mensagem direta foi criada. Na seção Inscrever-se em eventos em nome dos usuários, clique no botão Adicionar evento do Workspace para adicionar o evento im_created e pressione Salvar alterações.,

   

5. Quando terminar de atualizar essas configurações, clique no botão Salvar alterações na parte inferior da página.

Adicionar o bot do Slack a uma equipe

1. No console de desenvolvimento do Slack, clique em Manage Distribution no menu à esquerda.
2. Na seção Share Your App with Your Workplace, clique no botão Add to Slack.
3. Na próxima página, clique no botão Authorize para adicionar o agente.

Teste

É possível testar o agente sem criar um bot público do Slack. Para fazer isso, acesse a página Integrations do agente e clique na chave no bloco Slack. Na janela pop-up, clique no botão Test In Slack.

Será solicitado que você faça login no Slack. Após fazer o login, vá até a instância e localize o usuário do bot chamado @dialogflow-bot. Envie uma mensagem direta ao agente para testá-lo ou adicione-o aos canais na sua instância.

Observação :para alterar o nome do agente ou adicionar um logotipo, será necessário tornar o bot público.

Eventos

Os eventos a seguir são invocados por esta integração:

Evento	Descrição
SLACK_WELCOME	Acionado quando um usuário inicia uma conversa com o bot do Slack.

Mensagens de resposta avançadas

As mensagens de resposta avançadas a seguir são compatíveis.

Respostas de imagem

Formatos e tamanhos compatíveis:

• gif
• jpeg
• png
• bmp

Cards de resposta

Não há campos obrigatórios para cartões no Slack. Qualquer combinação de elementos pode ser usada.

Botões com um URL e um postback de texto são compatíveis. Os botões com um URL são exibidos como hiperlinks.

Respostas rápidas

As respostas rápidas são compatíveis com as integrações do Slack de apenas um clique e correspondem a uma versão de texto dos botões interativos do Slack.

Respostas de payload personalizadas

Texto formatado na integração de apenas um clique do Slack

Seus bots do Slack podem enviar texto formatado, como mostra o exemplo a seguir:

{
  "slack": {
    "text": "This is an example of *bold*, _italic_, and `code`."
  }
}