Slack

Conecte um app do Slack ao Aillom MEX para atender mensagens diretas (DMs) e menções em canais automaticamente com IA, usando a Events API do Slack.

Pré-requisito: Permissão para criar um app no workspace do Slack em api.slack.com/apps.

1. Criar o App no Slack

1. Acesse api.slack.com/apps → Create New App → From scratch
2. Dê um nome ao app e selecione o workspace

2. Configurar Escopos e Eventos

Bot Token Scopes

Em OAuth & Permissions → Scopes → Bot Token Scopes, adicione:

Event Subscriptions

Em Event Subscriptions, habilite os eventos e informe a Request URL:

Em Subscribe to bot events, inscreva os eventos:

• message.im — mensagens diretas (DMs)
• message.channels — mensagens em canais
• app_mention — menções ao bot

Handshake: ao salvar a Request URL, o Slack envia um desafio url_verification. O MEX responde automaticamente a esse desafio — você verá o status mudar para Verified.

Instalar e copiar os tokens

1. Vá em Install App → Install to Workspace e autorize
2. Copie o Bot User OAuth Token (começa com xoxb-)
3. Copie o Signing Secret em Basic Information → App Credentials

3. Conectar pelo Painel

No painel do MEX, vá em Canais → Novo Canal → Slack e informe:

• Bot Token (xoxb-...)
• Signing Secret
• O Agente que vai responder neste canal

4. Fluxo de Mensagens

Quando uma mensagem é recebida:

1. O Slack faz um POST (JSON) para https://mex.aillom.com.br/api/webhook/slack
2. O MEX valida a assinatura X-Slack-Signature (HMAC-SHA256 com o Signing Secret) e identifica o canal e o Agente vinculado
3. A IA processa a mensagem com contexto, histórico e conversation_vars
4. A resposta é enviada via chat.postMessage, mantendo a thread quando aplicável

Onde o Bot Responde

Recursos Suportados