Pular para o conteúdo principal

Visão Geral

Permita que seus agentes gerenciem a comunicação da equipe pelo Slack. Envie mensagens, pesquise conversas, gerencie canais e coordene as atividades do time para otimizar os fluxos de colaboração com automação impulsionada por IA.

Pré-requisitos

Antes de usar a integração com o Slack, certifique-se de que você tenha:

Configurando a Integração Slack

1. Conecte seu Workspace do Slack

  1. Acesse CrewAI AMP Integrações
  2. Encontre Slack na seção Integrações de Autenticação
  3. Clique em Conectar e complete o fluxo OAuth
  4. Conceda as permissões necessárias para comunicação em equipe
  5. Copie seu Token Enterprise em Configurações de Integração

2. Instale o Pacote Necessário

3. Configuração de variável de ambiente

Para usar integrações com Agent(apps=[]), você deve definir a variável de ambiente CREWAI_PLATFORM_INTEGRATION_TOKEN com seu Enterprise Token.
Ou adicione ao seu arquivo .env:

Ferramentas Disponíveis

Gerenciamento de Usuários

Descrição: Lista todos os membros de um canal do Slack.Parâmetros:
  • Nenhum parâmetro necessário – recupera todos os membros do canal
Descrição: Encontre um usuário no seu workspace do Slack pelo endereço de e-mail.Parâmetros:
  • email (string, obrigatório): O endereço de e-mail de um usuário do workspace
Descrição: Pesquise usuários pelo nome ou nome de exibição.Parâmetros:
  • name (string, obrigatório): Nome real do usuário para a pesquisa
  • displayName (string, obrigatório): Nome de exibição do usuário para a pesquisa
  • paginationParameters (object, opcional): Configurações de paginação
    • pageCursor (string, opcional): Cursor de página para paginação

Gerenciamento de Canais

Descrição: Lista todos os canais do seu workspace no Slack.Parâmetros:
  • Nenhum parâmetro necessário – recupera todos os canais acessíveis

Mensagens

Descrição: Envie uma mensagem para um canal do Slack.Parâmetros:
  • channel (string, obrigatório): Nome ou ID do canal – Use as Configurações de Workflow do Connect Portal para que usuários selecionem o canal, ou insira o nome do canal para criar um novo
  • message (string, obrigatório): Texto da mensagem a ser enviada
  • botName (string, obrigatório): Nome do bot que enviará a mensagem
  • botIcon (string, obrigatório): Ícone do bot – Pode ser uma URL de imagem ou um emoji (ex.: “:dog:”)
  • blocks (object, opcional): JSON do Slack Block Kit para mensagens ricas com anexos e elementos interativos
  • authenticatedUser (boolean, opcional): Se verdadeiro, a mensagem aparecerá como enviada pelo seu usuário autenticado do Slack ao invés do aplicativo (por padrão é falso)
Descrição: Envie uma mensagem direta para um usuário específico no Slack.Parâmetros:
  • memberId (string, obrigatório): ID do usuário destinatário – Use as Configurações de Workflow do Connect Portal para que usuários selecionem um membro
  • message (string, obrigatório): Texto da mensagem a ser enviada
  • botName (string, obrigatório): Nome do bot que enviará a mensagem
  • botIcon (string, obrigatório): Ícone do bot – Pode ser uma URL de imagem ou um emoji (ex.: “:dog:”)
  • blocks (object, opcional): JSON do Slack Block Kit para formatação rica com anexos e elementos interativos
  • authenticatedUser (boolean, opcional): Se verdadeiro, a mensagem aparecerá como enviada pelo seu usuário autenticado do Slack (padrão é falso)

Pesquisa & Descoberta

Descrição: Procure por mensagens em todo o seu workspace do Slack.Parâmetros:
  • query (string, obrigatório): Consulta de pesquisa usando a sintaxe do Slack para encontrar mensagens que correspondam aos critérios especificados
Exemplos de Consultas de Pesquisa:
  • "project update" – Busca mensagens contendo “project update”
  • from:@john in:#general – Busca mensagens do John no canal #general
  • has:link after:2023-01-01 – Busca mensagens com links após 1º de janeiro de 2023
  • in:@channel before:yesterday – Busca mensagens em um canal específico antes de ontem

Integração com Block Kit

O Block Kit do Slack permite criar mensagens ricas e interativas. Veja alguns exemplos de como usar o parâmetro blocks:

Texto Simples com Anexo

Formatação Rica com Seções

Exemplos de Uso

Configuração Básica de Agente Slack

Filtrando Ferramentas Específicas do Slack

Mensagens Avançadas com Block Kit

Pesquisa de Mensagens e Análises

Fale com o Suporte

Precisa de Ajuda?

Entre em contato com nossa equipe de suporte para obter ajuda na configuração ou solução de problemas da integração com o Slack.