API do Slack: o que dá para fazer e como usar com agentes de IA
A API do Slack permite criar apps que leem e enviam mensagens, reagem a eventos e interagem com usuários por comandos e botões. É usada por times de engenharia, operações e TI para automações internas e bots. O acesso é feito por apps instalados no workspace com escopos OAuth definidos.
Os grandes recursos da API, em português claro.
Métodos para enviar e editar mensagens, listar canais, buscar usuários e gerenciar conversas.
Eventos enviados ao app quando algo acontece, como nova mensagem, menção ou entrada em canal.
Botões, menus, modais e atalhos que o usuário aciona dentro do Slack.
Comandos personalizados que disparam ações no app.
Upload e leitura de arquivos compartilhados em canais e mensagens diretas.
Como se acessa a API do Slack.
- Com credencial da sua empresaOAuth 2.0: o app é criado no portal de desenvolvedor do Slack e instalado no workspace, gerando tokens de bot ou de usuário com escopos específicos.
- Documentação oficialapi.slack.com
- Os métodos têm limites de taxa por nível; mensagens em massa precisam ser espaçadas.
- Peça só os escopos necessários: ler histórico de todos os canais raramente é preciso.
- Mensagens podem conter dados sensíveis; alinhe com a política de retenção do workspace.
- api slack
- slack api documentação
- slack web api
- slack events api
- bot slack api
- integração api slack
- slack api enviar mensagem
O que um agente do iTeam faz com a API do Slack.
O agente responde dúvidas de RH, TI e políticas em um canal próprio, citando a fonte do documento interno, e abre chamado quando não sabe.
Quando o monitoramento acusa erro, o agente abre o canal do incidente, chama o plantonista e resume logs e últimos deploys.
Pedidos de compra, desconto ou acesso chegam ao gestor como mensagem com botões de aprovar e recusar, e o resultado volta para o sistema de origem.
No fim do dia, o agente resume as decisões e pendências dos canais de projeto para quem não acompanhou.
Da credencial ao agente trabalhando, com aprovação.
Crie o app no Slack
Crie o app no portal do Slack, defina os escopos mínimos necessários e instale no workspace com um administrador.
Cadastre o token no iTeam
O token do bot vai para o cofre do iTeam; você escolhe em quais canais cada agente atua e o que ele pode postar.
Ligue eventos e teste
Ative os eventos de mensagem e menção, teste em um canal piloto e mantenha aprovação humana para ações fora do Slack.
Dúvidas sobre a API do Slack.
A API do Slack é gratuita?
Criar apps e usar a API não tem cobrança separada, mas alguns recursos e limites dependem do plano do workspace. Verifique o plano da sua empresa.
Preciso programar para usar a API do Slack com o iTeam?
Não. O iTeam já se conecta ao Slack e o time de implantação ajuda a criar o app, escolher escopos e definir os canais.
O agente lê todas as mensagens do workspace?
Não. Ele só vê os canais em que foi adicionado e os escopos que você autorizou.
Que tarefas um agente de IA assume dentro do Slack usando a API?
O app do Slack recebe eventos de mensagens e menções e responde em canais ou em conversas diretas, e o agente usa isso para tirar dúvidas, abrir tarefas e resumir um canal. Ele responde a um comando de barra ou ao ser mencionado. No iTeam, o Slack é um dos canais do agente, e as ações sensíveis voltam como pedido de aprovação.
Como instalar um app com agente de IA no Slack e que token ele usa?
Você cria o app no portal de desenvolvedores do Slack, define os escopos e o administrador do workspace o instala, o que gera um token de bot que começa com xoxb. O agente age com a identidade do bot nos canais em que for convidado. Pessoas que não adicionaram o bot a um canal não o veem lá, o que serve de controle de acesso.
O Slack oferece um workspace de teste para desenvolver o agente?
Sim, o programa de desenvolvedores do Slack permite criar um workspace de sandbox gratuito para construir e testar apps. Lá você instala o app, convida o bot e usa comandos sem afetar o time real. Confira na página do programa as condições atuais, porque elas mudaram ao longo do tempo, e só depois instale no workspace de produção.
Como o agente recebe mensagens do Slack: Events API ou Socket Mode?
Na Events API, o Slack envia os eventos a uma URL pública sua, que precisa validar a assinatura de cada pedido. No Socket Mode, o app abre uma conexão e recebe os eventos sem URL pública, o que facilita desenvolvimento e redes fechadas. Para produção em escala, a Events API costuma ser a escolha, e o Socket Mode serve melhor para protótipo.
A API do Slack tem limites de chamadas que afetam o agente?
Tem: os métodos são agrupados em níveis de taxa e, ao excedê-los, o Slack responde com erro e um tempo de espera no cabeçalho. O agente deve respeitar esse tempo e evitar ler o histórico inteiro de canais a toda hora. As regras para apps fora do diretório oficial foram endurecidas para alguns métodos de leitura, então confira os limites vigentes.
O agente de IA lê todas as conversas privadas do Slack?
Não: o bot só enxerga os canais em que foi adicionado e os escopos que o administrador aprovou, e mensagens diretas entre pessoas ficam fora. Para ler canais privados é preciso convidá-lo. Isso permite desenhar o alcance do agente por canal. Mesmo assim, avise o time sobre o que o bot lê, porque o conteúdo do Slack também envolve dados pessoais.
Quanto custa integrar um agente de IA ao Slack?
Criar e instalar um app não tem cobrança de API na documentação do Slack, mas o workspace precisa do plano que a empresa já usa, e alguns recursos dependem do plano. O gasto variável vem do modelo de IA, proporcional ao tamanho e à frequência das conversas. Confira as limitações do seu plano antes de contar com histórico longo ou com certos recursos.
Vale a pena ter o agente no Slack em vez de uma interface própria?
Vale quando o time já trabalha no Slack e o agente precisa estar onde as perguntas aparecem, sem outra aba. Não vale quando o público é externo, como clientes, que pedem WhatsApp ou site. Um mesmo agente pode atender nos dois canais com as mesmas regras, e o histórico fica na memória da empresa em vez de ficar espalhado.
Outras APIs da categoria.
Times de IA prontos que usam Slack.
Suporte ao cliente com IA
Os tickets do Zendesk, Freshdesk ou Movidesk ganham uma primeira resposta certa, tirada da sua base de conhecimento, e os casos difíceis chegam ao ana…
Customer success e pós-venda
Os agentes leem uso, tickets e conversas no HubSpot ou no Salesforce e dizem quem precisa de uma ligação esta semana.
Pesquisa de satisfação
Envia NPS e CSAT pelo WhatsApp ou e-mail, lê os comentários um a um e transforma a nota numa lista de tarefas para cada área.
Relatório gerencial e KPIs
Os números do TOTVS Protheus, do Omie, do HubSpot e das planilhas viram um relatório curto, com o que subiu, o que caiu e por quê.