Usando no Slack

Guia

Dica

O Prodgy se integra ao Slack via Event API. Os usuários conversam com o bot em canais ou DMs e recebem respostas da Knowledge Base do workspace.

Pré-requisitos

• Workspace Slack com permissão para instalar apps
• Produto cadastrado no Prodgy com Knowledge Base configurada
• Organização com modelo de IA (LLM) configurado
• API do Prodgy acessível publicamente via HTTPS

---

Configuração

1. Criar o Slack App

1. Acesse api.slack.com/apps

2. Clique Create New App > From scratch

3. Preencha:

   Campo	Valor
   App Name	Ex: Prodgy Bot
   Workspace	Selecione o workspace desejado

2. Configurar Permissões

1. Vá em OAuth & Permissions > Bot Token Scopes

2. Adicione os scopes:

   Scope	Uso
   chat:write	Enviar mensagens
   chat:write.public	Enviar em canais sem ser membro
   channels:history	Ler mensagens de canais
   groups:history	Ler mensagens de grupos privados
   im:history	Ler DMs
   users:read	Obter informações de usuários

3. Clique Install to Workspace e autorize

4. Anote o Bot User OAuth Token (começa com xoxb-)

3. Criar a Integração no Prodgy

1. No Prodgy, acesse Integrações

2. Adicione uma nova integração do tipo Slack (classificação: comunicador)

3. Preencha as credenciais:

   Campo	Valor
   Bot Token	Bot User OAuth Token (xoxb-...)
   Signing Secret	Signing Secret da página Basic Information

4. Exportar o Produto

1. Acesse o Playground do workspace desejado
2. Clique em Exportar e selecione a integração Slack
3. Opcionalmente, informe um Channel ID para criar mapeamento automático
4. O sistema gera a Webhook URL

5. Configurar Event Subscriptions

1. No Slack App, vá em Event Subscriptions

2. Ative Enable Events

3. Cole a Webhook URL no campo Request URL:

   https://<sua-api>/api/communicator/webhook/<integration_base_id>

   O Slack faz uma verificação automática (URL Verification) — o endpoint já suporta isso.

4. Em Subscribe to bot events, adicione:

   • message.channels
   • message.groups
   • message.im

6. Configurar Slash Command (opcional)

Para habilitar o comando /prodgy no Slack:

1. Vá em Slash Commands no Slack App

2. Crie um novo comando:

   Campo	Valor
   Command	/prodgy
   Request URL	https://<sua-api>/api/communicator/slash/<integration_base_id>
   Description	Prodgy Bot — Interaja com seus workspaces
   Usage Hint	[login | list | link <slug> | clear | help]

---

Testando

DM com o Bot

1. No Slack, encontre o bot em Apps na barra lateral
2. Envie uma mensagem direta para testar

Em um Canal

1. Convide o bot para o canal: /invite @ProdgyBot
2. Envie uma mensagem no canal — o bot responde automaticamente

Primeiro uso

1. Digite /prodgy login para vincular sua conta Prodgy
2. Clique no link e autentique pelo navegador
3. Use /prodgy list para ver os workspaces
4. Use /prodgy link <slug> para selecionar um workspace
5. Envie suas perguntas normalmente

---

Comportamento

Indicador de Processamento

1. O bot envia “Pensando…” imediatamente
2. O Agentic processa a mensagem
3. A mensagem “Pensando…” é atualizada com a resposta final (via chat.update)

Formatação

O adapter converte automaticamente o Markdown da LLM para o formato do Slack:

Markdown	Slack
**negrito**	*negrito*
*itálico*	_itálico_
[texto](url)	<url|texto>
# Título	*Título*
- item	• item

Prevenção de Loop

O bot ignora automaticamente mensagens enviadas por outros bots (detecta bot_id no payload), evitando loops infinitos.

---

Multi-Produto

• Cada usuário seleciona seu workspace ativo via /prodgy link <slug>
• Canais podem ser mapeados a produtos específicos (ex: #suporte → produto Suporte)
• Se não houver mapeamento nem seleção, o bot usa o primeiro workspace acessível ao usuário

---

Troubleshooting

Bot não responde

• Verifique se Event Subscriptions está ativo e a Request URL está verificada (check verde)
• Verifique se o bot foi convidado para o canal (/invite @BotName)
• Verifique se o Bot Token está correto nas credenciais da integração

Erro “missing_scope”

• Adicione os scopes necessários em OAuth & Permissions
• Após adicionar scopes, reinstale a app no workspace

Mensagens duplicadas

• Verifique se não há dois Event Subscriptions apontando para o mesmo endpoint
• O adapter ignora mensagens de bot automaticamente, mas confirme que o bot_id está presente no payload

Resposta demora muito

• O timeout padrão é 30 segundos
• Reduza maxIterations nas configurações avançadas do comunicador
• Verifique a latência do serviço Agentic

Nota

A validação de assinatura do Slack (Signing Secret) requer acesso ao raw body da requisição. Em alguns ambientes, pode ser necessário configurar o proxy para preservar o raw body.