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

Essa integração é compatível apenas com o idioma padrão do agente.

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 vão encontrar no 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 ID do cliente, Chave secreta do cliente e Token de verificação.

Vincular o Slack ao Dialogflow

1. No Dialogflow, acesse Integrations no menu à esquerda.
2. Clique no bloco Slack.
3. Digite os valores equivalentes 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 evento.

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 Slack Developer Console 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 Slack Developer Console 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ê vai ver um "Verified" verde acima do campo "Request URL".

4. Em 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. Confira uma lista de eventos que sugerimos adicionar:
   

   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 Save Changes na parte de baixo da página.

Adicionar o bot do Slack a uma equipe

1. No Slack Developer Console, 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.

Você será solicitado a fazer 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 mudar 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`."
  }
}