Esta página também está emEN
iTeam
API · Comunicação, e-mail e agendaCom credencial da sua empresa

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.

Nina
O que a API do Slack oferece

Os grandes recursos da API, em português claro.

RecursoWeb API

Métodos para enviar e editar mensagens, listar canais, buscar usuários e gerenciar conversas.

RecursoEvents API

Eventos enviados ao app quando algo acontece, como nova mensagem, menção ou entrada em canal.

RecursoInteratividade

Botões, menus, modais e atalhos que o usuário aciona dentro do Slack.

RecursoComandos de barra

Comandos personalizados que disparam ações no app.

RecursoArquivos

Upload e leitura de arquivos compartilhados em canais e mensagens diretas.

Acesso e autenticação

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.
Também buscado como
  • api slack
  • slack api documentação
  • slack web api
  • slack events api
  • bot slack api
  • integração api slack
  • slack api enviar mensagem
Agentes de IA usando a API

O que um agente do iTeam faz com a API do Slack.

Caso de usoAgente de suporte interno

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.

Caso de usoTriagem de incidentes

Quando o monitoramento acusa erro, o agente abre o canal do incidente, chama o plantonista e resume logs e últimos deploys.

Caso de usoAprovações em botão

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.

Caso de usoResumo de canais

No fim do dia, o agente resume as decisões e pendências dos canais de projeto para quem não acompanhou.

Como conectar no iTeam

Da credencial ao agente trabalhando, com aprovação.

Passo 1

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.

Passo 2

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.

Passo 3

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.

Perguntas frequentes

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.

Mais APIs de Comunicação, e-mail e agenda

Outras APIs da categoria.

Próximo passo

Coloque um time de IA para trabalhar esta semana.

Comece grátis com um time pronto, ou fale com a gente e nosso squad coloca a IA em produção com o seu time.

300+integrações
4idiomas
Agentes trabalhando agora