Simple Agent
Criar meu agente
Docschannels

Slack

Adicione seu AI agent a um workspace Slack — responde em canais, threads e DMs.

Com a integração Slack, seu agent responde perguntas diretamente em canais e DMs do seu workspace. Ideal para equipes internas que precisam de um assistant de knowledge base, suporte técnico ou onboarding de novos colaboradores.

Pré-requisitos

  • Workspace Slack com permissão de administrador (ou aprovação do admin para instalar apps)
  • Plano Simple Agent Growth ou Agency

Configuração

1. Criar o Slack App

  1. Acesse api.slack.com/apps → Create New App → From scratch
  2. Dê um nome (ex: "Simple Agent") e selecione o workspace
  3. Em OAuth & Permissions → Scopes → Bot Token Scopes, adicione:
Scope Finalidade
app_mentions:read Ler quando o bot for mencionado
channels:history Ler mensagens do canal (necessário para contexto de thread)
chat:write Enviar mensagens
im:history Ler DMs
im:read Ver DMs
im:write Responder DMs

2. Instalar o app no workspace

  1. Em OAuth & Permissions → Install to Workspace
  2. Copie o Bot User OAuth Token (xoxb-...)

3. Conectar no Simple Agent

  1. Dashboard → Canais → Slack
  2. Cole o Bot Token
  3. Clique em Salvar e gerar Webhook URL

4. Configurar Event Subscriptions

  1. No app Slack → Event Subscriptions → Enable Events
  2. Cole a URL do Simple Agent no campo Request URL
  3. O Slack envia um challenge — o Simple Agent responde automaticamente
  4. Em Subscribe to bot events, adicione:
    • app_mention — responder quando mencionado
    • message.im — responder DMs

Modos de resposta

Menção em canal

O agent só responde quando mencionado diretamente (@nomedobot). Isso evita responder toda conversa do canal.

@Simple Agent como faço para exportar relatórios?
→ Simple Agent: Você pode exportar em CSV ou PDF em Relatórios → Exportar...

DM direta

O agent responde todas as mensagens enviadas em DM, sem necessidade de menção.

Thread automática

Todas as respostas são enviadas em thread da mensagem original para não poluir o canal.

Configurações avançadas

Opção Descrição
Canais autorizados Restringir a quais canais o agent pode responder
Contexto de thread O agent lê as últimas N mensagens da thread como contexto (padrão: 10)
Emoji de "pensando" Adiciona reação ⏳ enquanto processa — remove após responder
Handoff Se o usuário digitar /humano, abre ticket no seu helpdesk

Casos de uso

Knowledge base interna: Treine o agent com sua documentação interna (Notion, Confluence, Google Drive) e deixe a equipe perguntar em Slack.

Suporte técnico: Treine com runbooks, READMEs e changelogs. O agente responde perguntas de infra sem precisar pingar alguém.

Onboarding: Treine com handbook da empresa, políticas de RH e processos internos. Novos colaboradores tiram dúvidas no próprio Slack.

Troubleshooting

Bot não responde menções:

  • Confirme que o bot foi adicionado ao canal: /invite @nomedobot
  • Verifique se o evento app_mention está subscrito

URL de Request URL falha:

  • O endpoint deve retornar HTTP 200 com o campo challenge no mesmo request. O Simple Agent faz isso automaticamente — se falhar, verifique se há proxy ou firewall na URL.

Erro "not_in_channel":

  • O bot precisa ser membro do canal. Use /invite @nomedobot no canal desejado.

Ver WhatsApp → · Ver Instagram → · API Reference →