Configuracao do Bot no Slack

Conecte seu agente de IA Claw Buff a um workspace do Slack. Seu bot respondera a DMs, mencoes e ao comando slash /claw. A configuracao leva cerca de 10 minutos.

Pre-requisitos

• Um workspace do Slack onde voce tenha privilegios de administrador (ou permissao para instalar apps)
• Um agente Claw Buff implantado (Primeiros Passos)

Passo 1: Crie um App no Slack

{
  "display_information": {
    "name": "Claw Buff",
    "description": "AI agent powered by Claw Buff"
  },
  "features": {
    "bot_user": {
      "display_name": "Claw Buff",
      "always_online": false
    },
    "assistant_view": {
      "assistant_description": "AI agent powered by Claw Buff"
    },
    "app_home": {
      "messages_tab_enabled": true,
      "messages_tab_read_only_enabled": false
    }
  },
  "oauth_config": {
    "scopes": {
      "bot": [
        "chat:write",
        "channels:history",
        "channels:read",
        "groups:history",
        "im:history",
        "im:read",
        "im:write",
        "users:read",
        "app_mentions:read",
        "assistant:write"
      ]
    }
  },
  "settings": {
    "event_subscriptions": {
      "bot_events": [
        "app_mention",
        "assistant_thread_started",
        "message.im"
      ]
    },
    "socket_mode_enabled": true
  }
}

Passo 2: Conecte ao Claw Buff

1. Abra o Console do Claw Buff → pagina de Canais
2. Encontre o card do Slack e clique em Connect
3. Cole ambos os tokens:
   • Token do Bot (xoxb-...)
   • Token do App (xapp-...)
4. Clique em Save & Activate

Seu bot se conectara via Socket Mode — nenhuma URL publica ou webhook necessario.

Passo 3: Pareie Sua Conta

Antes que o bot responda, voce precisa parear sua conta do Slack:

1. Envie uma DM ao bot — Encontre seu bot na barra lateral do Slack em Apps e envie qualquer mensagem (ex.: "ola")
2. O bot respondera com um codigo de pareamento (ex.: 7EPLYS7R)
3. Va para o Console do Claw Buff → pagina de Canais
4. Voce vera uma secao de Solicitacoes de Pareamento Pendentes — clique em Approve ao lado do codigo

Uma vez aprovado, o bot respondera suas mensagens imediatamente.

Passo 4: Habilite Canais (Opcional)

Por padrao, o bot so funciona em DMs. Para usa-lo em canais do Slack:

1. No Slack, clique com o botao direito no nome do canal → Ver detalhes do canal → copie o ID do Canal na parte inferior do painel

2. No Console, va para Canais → clique em Manage no card do Slack
3. Em Canais Autorizados, cole o ID do Canal e clique em Add
4. No Slack, convide o bot para o canal: digite /invite @NomeDoSeuBot

O bot agora respondera a @mencoes nesse canal. Voce pode adicionar varios canais.

Passo 5: Comece a Conversar

• Envie uma DM ao bot — Encontre seu bot na barra lateral do Slack em Apps
• Mencione em um canal — Digite @NomeDoSeuBot seguido da sua mensagem
• App Home — Abra a aba App Home do bot para uma interface de chat dedicada

Recursos

Perguntas Frequentes

1. Bot nao responde?

• Verifique ambos os tokens — Voce precisa do Token do Bot (xoxb-) e do Token do App (xapp-)
• Verifique o Socket Mode — Certifique-se de que o Socket Mode esta habilitado nas configuracoes do seu app no Slack
• Verifique o Console — A pagina de Canais mostra o status da conexao e logs de erro

2. Bot nao responde a DMs?

Certifique-se de que estes escopos estao presentes: im:history, im:read, im:write. Se voce usou o manifesto acima, eles ja estao incluidos.

3. Bot nao responde a mencoes em canais?

• O bot precisa ser convidado para o canal primeiro (digite /invite @Claw Buff)
• Certifique-se de que os escopos app_mentions:read e channels:history estao presentes

4. Erro "not_allowed_token_type"?

Voce pode ter trocado o Token do Bot e o Token do App. O Token do Bot comeca com xoxb- e o Token do App comeca com xapp-.