Principal FUNÇÕES COMO CRIAR UMA FUNÇÃO INTEGRADA AO SLACK NO TOOLZZ AI?

COMO CRIAR UMA FUNÇÃO INTEGRADA AO SLACK NO TOOLZZ AI?

Última atualização em Apr 24, 2026

Sobre

Aprenda neste artigo como configurar seu agente e integrar seu App Bot do Slack em seu agente de Inteligência Artificial Toolzz AI, permitindo que seu agente responda automaticamente os usuários.

Pré-requisitos:

  • Possuir um plano ativo no Toolzz AI

  • Possuir um agente criado (visite nosso tutorial para criação de agente!)

  • Possuir o recurso "Funções" habilitado em "Recursos do agente" (presente da etapa "Agente" no fluxo de criação do agente)

  • Possuir um Workspace criado dentro da uma conta no Slack

Primeiro passo: Criando um app no Slack

  1. Acesse o portal de apps do Slack: api.slack.com/apps

  2. Clique em "Create An App"

  3. Escolha a opção "From scratch"

  4. Insira o nome que deseja para criação do app

  5. Escolha um Workspace

Segundo passo: Copiando o Signing Secret

  1. No menu esquerdo clique em: Basic Information

  2. Em App Credentials ao encontrar o Signing Secret clique em "show"

  3. Copie o Signing Secret (guarde porque será usado dentro da função Toolzz AI).

Terceiro passo: Adicione os OAuth Scope

  1. No menu esquerdo vá em OAuth & Permissions

  2. Desça a página até encontrar Escopos e adicione os seguintes escopos:

channels:history channels:read chat:write app_mentions:read assistant:write files:read im:history
im:read im:write groups:history groups:read mpim:history mpim:read

🚨Atenção: Sempre que alterar um escopo no app seja excluindo ou adicionando um novo escopo em bot token escope, é necessário reinstalar o app

Quarto passo: Copie o Bot User OAuth Token

  1. Clique novamente em OAuth & Permissions

  2. E clique no botão "Install to [Workspace]"

  3. Irá aparecer uma tela de permissão, clique em "permitir"

  4. Agora copie o Bot User Oauth Token

  5. Copie o Bot User OAuth Token, cole no Toolzz AI e valide!

Quinto passo:  Ative o modo de eventos (Event Subscriptions)

  1. No menu esquerdo vá em Event Subscription

  2. Habilite o modo em "Enable Events"

  3. Vá para a função Slack Bot no Toolzz AI copie a Request URL

  4. De volta no Slack API, ainda em Event Subscription cole a Request URL copiada do Toolzz AI

  5. Vá em Subscribe to bot events e adicione os seguintes escopos presentes da imagem:

🚨Importante: Sem esses escopos adicionados (tanto do de events quanto de token de bot), o agente não irá funcionar!!!

Sexto passo: Adicionando o app no canal do slack

  1. Dentro do Workspace do Slack, clique em [ ⋮ ] presente ao lado da lupa no canto superior direito

  2. Selecione a opção "Editar configurações"

  3. Clique em Adicione um app

  4. Selecione o App criado anteriormente (ex: Toolzz AI)

  5. Após ser adicionado aparecerá a seguinte mensagem em seu canal no chat do Slack

Sétimo passo: Configurando integração dentro do Toolzz AI

Selecione a Integração

  1. Após habilitar as funções, avance para etapa "Funções"

  2. Clique em "Criar função" dentro da etapa Funções no setup mágico

  3. Em "Integração" selecione a opção "Slack Bot" e clique em "usar"

Configurando a integração

  1. Nome da integração: Insira um nome para melhor identificação dentro da plataforma

  2. Bot User Oauth Token: Insira o Token copiado anteriormente no passo quatro

  3. Signing Secret: Insira o Secret copiado anteriormente no segundo passo

  4. Event Subscription: Webhook de eventos para ser inserido dentro do Slack API durante a configuração do app

Comportamento do Bot

Defina quando que seu Agente poderá responder dentro do Slack

  1. Responder apenas quando mencionado: Reponde apenas se o usuário mencionar o agente (@nome_agente). Caso essa opção esteja desativada o agente responderá todas as mensagens enviadas no canal

  2. Responder em DMs: O agente responder apenas caso chamado em uma mensagem privada (necessário configuração prévia, mais informações em "Modo de resposta")

  3. Responder em Thread: Permite que o agente responda em tópicos de forma "privada" evitando muitas resposta dentro do canal

  4. Canais (opcional): Aqui será listado os canais de sua workspace no Slack e você poderá selecionar em quais canais seu agente poderá se comunicar com os usuários. Não selecionando nenhuma, o seu agente irá conversar em todos os canais existentes na workspace em que o app esta adicionado

Modo de resposta

Modo 1: Responder quando mencionado

Digite @nome_do_app e escreva ao lado a mensagem que deseja enviar para o seu agente!

Modo 2: Responder via DM

Se você desejar que o seu agente responda também via DM realize os seguintes passos:

  1. App home no Slack API

  2. Desça ao final da página até Chat Tab

  3. Marque a opção no checkbox "Allow users to send Slash commands and messages from the chat tab"

Após realizar a configuração, volte à plataforma do Slack e vá em Apps, selecione o seu App e envie a mensagem privada.

Atenção: Caso não apareça a opção de chat para enviar a mensagem, necessário recarregar a página do navegador (F5)

Modo 3: Responder no canal via Threads (tópicos)

Na resposta via threads, o seu agente poderá responder em tópicos dentro de um canal do slack.

Para visualizar a resposta do agente, clique na resposta e será exibido um modal lateral da conversa com a resposta do seu agente de IA

✨ Clique em "Criar integração" e pronto! Agente integrado com sucesso!