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.

Limitações

Somente o idioma padrão do agente é compatível com essa integração.

Como configurar o Slack

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

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 Sempre mostrar meu bot como on-line e edite Nome de exibição do app se: necessário (é isso que os usuários verão para seu bot)

Como ativar a integração no Dialogflow

No console de desenvolvimento do Slack, clique em Basic Information, na esquerda e role para baixo até a seção App Credentials. Anote os valores ID do cliente, Chave secreta do cliente e Token de verificação.

  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

Agora que você configurou o Slack e o Dialogflow, vai ativar as APIs OAuth, URL de solicitações (fornecidos pelo Dialogflow) e assinaturas de eventos.

Adicionar o URL do OAuth

  1. Copie o URL do OAuth da página de configurações do Dialogflow no Slack.
  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 "Events" e cole o URL de assinatura de eventos no campo Solicitar URL

    Depois de alguns instantes, você verá a mensagem "Verificado" em verde acima do URL de solicitação .

  4. Em Subscription to Bot Events , clique em Add Bot User Event. botão

    O campo de texto e a lista de eventos serão exibidos. Digite termos nesse campo para pesquisar os eventos a que você quer que o bot responda. Aqui está 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 inferior 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 Compartilhar seu aplicativo com seu local de trabalho, clique no botão Adicionar ao Botão do 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 isso, acesse a Integrações 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.

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`."
  }
}