Slack

A integração do Slack do Dialogflow facilita a criação das suas próprias apps e bots do Slack, bem como a respetiva formação para compreenderem a linguagem natural.

Limitações

Apenas o idioma do agente predefinido é suportado por esta integração.

Configurar o Slack

Para configurar a integração do Slack para o seu agente, precisa do seguinte:

Crie uma app Slack

  1. Navegue para a Slack Developer Console
  2. Introduza um nome para a sua app
  3. Escolha uma equipa à qual quer associar a app
  4. Clique no botão Criar app

Adicione um utilizador bot

  1. Clique em OAuth e autorizações no menu do lado esquerdo
  2. Aceda à secção Âmbitos e certifique-se de que os seguintes âmbitos de OAuth estão na secção Âmbitos do token do bot
  3. Clique em Página inicial da app no menu do lado esquerdo
  4. Ative a opção Mostrar sempre o meu bot como online e edite o Nome a apresentar da app, se necessário (é o que os utilizadores vão ver para o seu bot)

Ativar a integração no Dialogflow

Na Slack Developer Console, clique em Informações básicas no menu do lado esquerdo e desloque a página para baixo até à secção Credenciais da app. Tome nota do ID de cliente, do segredo do cliente e do token de validação.

  1. No Dialogflow, aceda a Integrações no menu do lado esquerdo
  2. Clique no mosaico Slack
  3. Introduza os valores relacionados nos seguintes campos:
    1. ID de cliente
    2. Segredo do cliente
    3. Token de validação
  4. Clique em Iniciar

Continuar configuração do Slack

Agora que configurou o Slack e o Dialogflow, vai ativar o OAuth, os URLs de pedidos de eventos (fornecidos pelo Dialogflow) e as subscrições de eventos.

Adicione o URL do OAuth

  1. Copie o URL do OAuth da página de definições do Slack do Dialogflow
  1. Aceda à Slack Developer Console e clique em OAuth & Permissions no menu do lado esquerdo
  2. Clique no botão Adicionar um novo URL de redirecionamento e cole o URL OAuth
  3. Clique em Adicionar
  4. Clique no botão Guardar URLs

Adicione o URL do pedido de evento e ative as subscrições de eventos

  1. Copie o URL do pedido de evento da página de definições do Slack do Dialogflow
  2. Aceda à Slack Developer Console e clique em Event Subscriptions no menu do lado esquerdo
  3. Clique no interruptor para ativar os Eventos e cole o URL de subscrição de eventos no campo URL de pedido

    Após alguns momentos, deve ver "Validado" a verde acima do campo URL de pedido.

  4. Em Subscrever eventos de bots , clique no botão Adicionar evento de utilizador de bot

    Esta ação revela o campo de texto e a lista de eventos. Pode introduzir termos neste campo para pesquisar eventos aos quais quer que o bot responda. Segue-se uma lista de eventos que sugerimos adicionar:

    Nome do evento Descrição do Evento
    message.im Uma mensagem foi publicada num canal de mensagens diretas
    message.groups Foi publicada uma mensagem num canal privado
    message.channels Uma mensagem foi publicada num canal
    im_created Foi criada uma MD. Na secção Subscrever eventos em nome dos utilizadores, clique no botão Adicionar evento do Workspace para adicionar o evento im_created, e, de seguida, prima Guardar alterações.

  5. Quando terminar de atualizar estas definições, clique no botão Guardar alterações na parte inferior da página.

Adicione o seu bot do Slack a uma equipa

  1. Na Slack Developer Console, clique em Gerir distribuição no menu do lado esquerdo
  2. Na secção Partilhe a sua app com o seu local de trabalho, clique no botão Adicionar ao Slack
  3. Na página seguinte, clique no botão Autorizar para adicionar o agente

Testes

Pode testar o seu agente sem criar um bot público do Slack. Para o fazer, aceda à página Integrações do seu agente e clique no interruptor no mosaico Slack. Na janela de pop-up, clique no botão Testar no Slack.

É-lhe pedido que inicie sessão no Slack. Depois de iniciar sessão, navegue para a instância e localize o utilizador do bot denominado @dialogflow-bot. Pode enviar uma mensagem direta ao agente para o testar ou adicioná-lo a canais na sua instância.

Eventos

Os seguintes eventos são invocados por esta integração:

Evento Descrição
SLACK_WELCOME Acionado quando um utilizador inicia uma conversa com o seu bot do Slack.

Mensagens de resposta avançadas

São suportadas as seguintes mensagens de resposta avançadas.

Respostas com imagens

Formatos e tamanhos suportados:

  • gif
  • jpeg
  • png
  • bmp

Respostas de cartões

Não existem campos obrigatórios para cartões no Slack. Pode usar qualquer combinação de elementos.

Os botões com um URL e com um postback de texto são suportados. Os botões com um URL são apresentados como hiperligações.

Respostas rápidas

As respostas rápidas são suportadas em integrações do Slack com 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 do Slack com um clique

Os seus bots do Slack podem enviar texto formatado, como mostra o exemplo seguinte:

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