Conectando-se ao Slack

Editar online

Use a integração com o Slack para habilitar o Slack como canal de comunicação para o seu agente. As equipes que utilizam o Slack podem se comunicar com seus agentes em tempo real diretamente no Slack.

Integre seu agente ao Slack usando os aplicativos do Slack, que disponibilizam as funções do agente aos usuários. Dependendo da sua configuração, o aplicativo Slack pode responder aos usuários nos canais em que é mencionado ou em mensagens diretas. Você também pode conectar agentes em rascunho a um aplicativo do Slack para testá-los antes de implantá-los em produção. A integração usa o ID do cliente, o segredo do cliente e o segredo de assinatura do aplicativo para estabelecer uma conexão segura e autenticada.

Interações suportadas

A integração com o Slack suporta as seguintes interações a partir de fluxos de trabalho do Agentic como entidades ricas:

  • Entrada de texto

  • Entrada numérica

  • Formulários

Para habilitar formulários interativos na sua configuração atual do Slack, consulte Habilitando a interação com formulários no Slack.

O que Você Aprenderá

Neste tópico, você aprenderá como:

  • Verifique os pré-requisitos necessários antes de configurar a integração com o Slack.

  • Configure a integração com o Slack, incluindo a configuração de escopos OAuth e URLs de redirecionamento.

  • Habilite a visibilidade do e-mail no Slack para que seu agente possa recuperar os endereços de e-mail dos usuários.

  • Configure seu aplicativo Slack para oferecer suporte a mensagens diretas.

  • Habilite interações em tela dividida para melhorar a experiência do usuário no Slack.

Antes de iniciar

Para iniciar a integração, certifique-se de que os seguintes pré-requisitos estejam atendidos:

  • Um espaço de trabalho do Slack com permissão para criar ou gerenciar aplicativos.

  • Um aplicativo Slack criado dentro do seu espaço de trabalho. Você pode criar um aplicativo do Slack aqui.

  • Acesso às credenciais de autenticação do aplicativo, incluindo:

    • ID do cliente : um identificador exclusivo para seu aplicativo Slack, usado para autenticar solicitações de API.

    • Segredo do cliente : uma chave confidencial usada para verificar a identidade do seu aplicativo Slack durante a autenticação.

    • Segredo de assinatura : um token secreto que garante que as solicitações recebidas pelo seu aplicativo sejam originárias do Slack.

    • OAuth e do usuário do bot : O token de acesso do bot (começa com ) usado para chamadas de API em nome do seu bot.
    • ID da equipe : O ID do seu espaço de trabalho no Slack (começa com T), que pode ser encontrado na página URL do seu espaço de trabalho ou nas configurações.

Para localizar essas credenciais no seu aplicativo do Slack:

  • ID do cliente, segredo do cliente e segredo de assinatura : acesse Informações básicas > Credenciais do aplicativo
  • Token de usuário do bot OAuth : Acesse OAuth e vá para Permissões > Token de usuário do bot OAuth (começa com xoxb-)
  • ID da equipe : Encontrado no seu ID do Slack (começa com T, disponível no espaço de trabalho URL ou nas configurações)
Importante:

Os aplicativos de teste são aplicativos do Slack pré-configurados que você pode usar para demonstrações ou em ambientes de teste. Use aplicativos de rascunho para testar os recursos de integração do Slack, verificar a autenticação e explorar o comportamento do canal antes de implantar na produção.

Configure a integração com o Slack

Siga estas etapas para integrar o Slack como canal de comunicação:

  1. Acesse https://api.slack.com/apps e selecione seu aplicativo.
  2. Vá para Canais > Slack.
  3. Selecione o ambiente (Rascunho ou Ativo) e clique em Criar novo.
  4. Na página Começar, revise as instruções e aplique as etapas relevantes. Quando estiver pronto, clique em Avançar.
  5. Na página Criar seu aplicativo Slack, siga as orientações fornecidas e aplique as etapas relevantes. Em seguida, clique em Avançar.
  6. Na página Conectar ao Slack, insira o Client ID, Client secret, e Signing secret que você salvou anteriormente.

    Siga as etapas na página “Conectar-se ao Slack ”. As etapas podem incluir ativar o recurso " OAuth ", configurar os escopos necessários e definir os URLs de redirecionamento apropriados. Você pode encontrar os detalhes de cada escopo na documentação do Slack.

    • app_mentions:read
    • chat:write
    • im:history
    • im:write
    • users.profile:read
    • users:read(Permite que o agente visualize o perfil dos membros no espaço de trabalho; isso é necessário para que o agente possa ler/exibir os nomes dos membros em vez dos IDs ilegíveis do Slack.)
    • users:read.email(Permite que o agente acesse o endereço de e-mail dos membros quando necessário.)
  7. Clique em Avançar.
  8. Na página Instalar (agente, bot) no Slack, clique em Configurar para instalar o aplicativo Slack em seu workspace. Siga as instruções na tela. Após a conclusão da instalação, clique em Next.
    Observação: se você for um desenvolvedor e não um administrador no espaço de trabalho do Slack, o Slack solicitará que você envie uma solicitação de instalação ao tentar adicionar o aplicativo. Envie a solicitação e aguarde a aprovação do administrador do espaço de trabalho. Após a aprovação do aplicativo, retorne ao fluxo de configuração e siga as mesmas etapas para concluir a instalação.
  9. Na página Configurar agente no Slack, siga as instruções para atualizar as configurações do seu aplicativo Slack. Aplique e salve as alterações recomendadas.
  10. Clique em Finish.
  11. Implemente seu agente e copie o URL do Event URL a partir do resultado da implementação.
  12. Atualize o evento URL nas configurações de assinaturas de eventos do seu aplicativo do Slack.
    Importante: Após implantar seu agente, copie o URL de assinatura de eventos ( URL ) da saída da implantação e atualize-o nas configurações de assinaturas de eventos do seu aplicativo do Slack. O evento URL muda a cada implantação.
  13. Verifique se o seu ambiente de rascunho ou ao vivo está conectado. Faça login no Slack e adicione o aplicativo recém-criado ao seu espaço de trabalho. Você deve ser capaz de se comunicar com o agente através do aplicativo Slack.

Após salvar a integração, você poderá editá-la ou excluí-la a qualquer momento, conforme suas necessidades.

Dica:

Para permitir que seu agente recupere os endereços de e-mail e nomes dos usuários, certifique-se de que as configurações de visibilidade de e-mail e nome estejam ativadas no seu espaço de trabalho do Slack. Para obter mais informações, consulte a seção “Ativar visibilidade de e-mails no Slack”.

Habilitar a visibilidade do e-mail no Slack

O Slack oculta os endereços de e-mail dos usuários se a configuração Exibir e-mail estiver desativada em seu espaço de trabalho. Quando isso ocorre, a users.profile.get API não consegue retornar valores de e-mail. watsonx Orchestrate utiliza o endereço de e-mail do usuário para identificar os participantes e gerenciar variáveis de contexto; portanto, essa configuração deve estar ativada para que a integração funcione corretamente. Para evitar esses problemas, certifique-se de que a configuração “Exibição de e-mail” esteja ativada no seu espaço de trabalho do Slack, para que o agente possa acessar os endereços de e-mail dos usuários por meio da API do Slack. Para ativar a visibilidade do e-mail no Slack:

  1. No Slack, clique no ícone Ferramentas de administração localizado no menu à esquerda e selecione a opção Configurações do espaço de trabalho.

  2. Na página “Configurações e permissões”, localize a seção “Exibição de e-mail” e expanda-a para ver a configuração atual da opção “Quem pode ver os endereços de e-mail dos membros do _[nome do espaço de trabalho]_?”

  3. Selecione uma das opções a seguir:

    • Membros e convidados do _[nome do espaço de trabalho]_

    • Membros e convidados do _[nome do espaço de trabalho]_, além de pessoas de organizações externas com as quais você está conectado

Ao selecionar qualquer uma das opções, o watsonx Orchestrate poderá recuperar os endereços de e-mail dos usuários por meio da API do Slack.

Nota:

Se você deseja que o agente tenha acesso tanto aos endereços de e-mail quanto aos nomes de exibição, certifique-se de que as configurações “Exibição de e-mail” e “Exibição de nome” estejam ativadas na página “Configurações e permissões”.

Habilite a comunicação direta com o aplicativo no Slack

Por padrão, os usuários podem interagir com um aplicativo do Slack somente quando o aplicativo é adicionado a um canal e mencionado explicitamente usando o símbolo @. Para permitir que os usuários se comuniquem diretamente com seu aplicativo Slack, você deve atualizar as permissões e as configurações do aplicativo.

Ativar mensagens diretas com o aplicativo do Slack

  1. Acesse https://api.slack.com/apps e selecione seu aplicativo.

  2. Vá para a página inicial do aplicativo e role até a seção Mostrar guias.

  3. Na guia Mensagens, ative a opção para permitir o envio de mensagens diretas pelo seu aplicativo.

  4. Selecione Permitir que os usuários enviem comandos Slash e mensagens na guia mensagens.

Agora você pode iniciar interações a partir da janela de mensagens do aplicativo.

Ativar interações em tela dividida

Se você deseja que os usuários interajam com seu aplicativo na visualização dividida ↗, configure a seguinte opção:

  1. Acesse https://api.slack.com/apps e selecione seu aplicativo.

  2. Acesse “ OAuth ” (Configurações) e “Permissions” (Permissões) no menu e defina os escopos:

    • assistant:write

  3. Na seção Agentes e aplicativos de IA, localize a opção Agente ou Assistente.

  4. Ative o botão para ativ ar o suporte para conversas em tela dividida.

Agora você deve conseguir se comunicar diretamente com seu aplicativo Slack por meio de mensagens diretas e, se estiver habilitado, interações em tela dividida.

O quê fazer em seguida

Para adicionar variáveis de contexto específicas do canal para o Slack, siga as instruções fornecidas em variáveis de contexto do Slack.

Para obter mais detalhes sobre os aplicativos de IA no Slack, consulte Entenda os aplicativos de IA no Slack ↗.