Integrando com o Slack

IBM Cloud

O Slack é um aplicativo de sistema de mensagens baseado em nuvem que ajuda as pessoas a colaborarem entre si.

Depois de criar uma ação, você pode integrar seu assistente com o Slack.

Quando integrado, dependendo dos eventos configurados para o suporte do assistente, ele poderá responder a perguntas feitas em mensagens diretas ou em canais nos quais é mencionado diretamente.

Um exemplo e instruções sobre como criar um Slackbot usando watsonx Assistant, Slack e Db2 são fornecidos no tutorial da solução, Construir um Slackbot orientado por banco de dados.

Antes de Iniciar

Para integrar o Slack ao seu assistente, você deve ter um aplicativo Slack e as funções e permissões necessárias:

Funções	Permissões
Proprietário da área de trabalho ou da organização do	Visualizar informações Postar informações Executar ações

Para criar um aplicativo do Slack, consulte Início rápido: Iniciar um fluxo de trabalho.

Para obter mais informações sobre funções e permissões, consulte Slack - Primeiros passos.

Incluindo a integração do Slack

Acesse a página Integrações clicando no ícone de integrações () no menu esquerdo.
Clique em Incluir no tile Slack.
Em seguida, clique em Adicionar novamente.

Iniciar

Há quatro etapas para configurar o Slack:

Configure seu bot do Slack
Conecte watsonx Assistant ao Slack
Configure seu bot do Slack
Conecte seu assistente

Configure seu bot do Slack

Vá para a página Seus aplicativos no site do Slack e clique no aplicativo que você deseja usar ou crie um novo.

Conecte watsonx Assistant ao Slack

Na página de configurações do aplicativo Slack, vá para a guia Informações básicas e role para baixo até a seção Credenciais do aplicativo.
Copie seu token de verificação e cole-o na página Configuração do assistente.
Na página Configurações do aplicativo Slack, vá para Features > OAuth & Permissions e role para baixo até a seção Bot Token Scopes.
Clique em Add an OAuth Scope (Adicionar um escopo OAuth ) e selecione os seguintes escopos:
- app_mentions:read
- chat:write
- im:history
- im:read
- im:write
Role a página para cima até a seção OAuth Tokens for Your Workspace e clique em Install App to Workspace e, em seguida, clique em Allow.

Você deve ser redirecionado para a página OAuth & Permissions.
Copie e cole o token de acesso OAuth do usuário do Bot na página Configuração do assistente.
Clique em Avançar para continuar.

Configure seu bot do Slack

Copie o URL da solicitação gerada.
Na página Configurações do aplicativo Slack, acesse Features > Event Subscriptions e alterne a opção Enable Events on.
Cole o link URL em Solicitação URL.

Aguarde até que você veja Verificado com uma marca verde ao lado de Solicitação URL.
Role a tela para baixo e clique em Subscribe to bot events.
Selecione os tipos de eventos que você deseja assinar. Deve-se selecionar pelo menos um dos tipos a seguir:
- message.im: atende eventos de mensagem que são postados em um canal de mensagens diretas.
- app_mention: atende somente eventos de mensagem que mencionam o seu app ou robô.
  
  Escolha a entrada app_mention em fonte normal, e não a entrada app_mention que está em fonte negrito.
Clique em Salvar Mudanças.
Na página Configuração do assistente, clique em Próximo.

Conecte seu assistente

Na página Configurações do aplicativo Slack, vá para Features > AppHome e clique em Edit ao lado de App Display Name.
Clique em Salvar depois de fazer as alterações.
Alterne a alternância Always Show My Bot as Online para on.
Vá para a seção Show Tabs e alterne a Messages Tab para on.
Marque a caixa de seleção Permitir que os usuários enviem comandos e mensagens do Slash a partir da guia de mensagens.
Se você quiser adicionar suporte para exibir botões, menus e opções de desambiguação no aplicativo Slack, execute as seguintes etapas:
1. Vá para a guia Interactivity & Shortcuts e ative o recurso
2. Cole o URL de sua solicitação no campo de entrada de texto fornecido.
3. Clique em Salvar Mudanças.
Na página Configuração do assistente, clique em Finish.

Se um campo token necessário para autenticação for alterado, então todas as entradas nos campos relacionados deverão ser preenchidas e validadas novamente

Considerações de ação

As respostas avançadas que você adiciona a uma ação são exibidas em um canal do Slack, com as seguintes exceções:

Conectar-se ao agente ativo: Esse tipo de resposta é ignorado.
Opção: esse tipo de resposta mostra uma lista de opções das quais o usuário pode escolher.
- Depois que um usuário clica em uma das opções, as seleções existentes desaparecem e substituem as seleções pela entrada do usuário gerada pela seleção do usuário. Se você incluir vários tipos de resposta em uma única resposta, deverá posicionar o tipo de resposta de opção no final para evitar confusões devido à mistura de respostas e entradas do usuário.
- Se as opções forem exibidas em uma lista suspensa, cada valor de opção deverá ter 75 caracteres ou menos de comprimento. Quando uma lista inclui 5 ou mais opções, ela é exibida em uma lista suspensa.

Conversando com o assistente

Para iniciar um bate-papo com o assistente, conclua as etapas a seguir:

Abra o Slack e acesse a área de trabalho associada ao seu app.
Clique no aplicativo criado na seção Apps.
Chat com o assistente.

A ação de boas-vindas não é processada pela integração Slack. A mensagem de boas-vindas não é exibida no canal Slack como na visualização do assistente. Ela não é acionada daqui porque os nós com a condição especial welcome são ignorados em fluxos de ação que são iniciados pelos usuários. O Slack espera que o usuário inicie a conversa.

O fluxo de ação para a sessão atual é reiniciado após 60 minutos de inatividade (5 minutos para planos Lite e Standard). Isso significa que, se um usuário parar de interagir com o assistente, após 60 (ou 5) minutos, todos os valores da variável de contexto configurados durante a conversa anterior serão configurados como nulos ou de volta para seus valores padrão.