Slack

Suma un agente de Pepe a tu espacio de Slack para que la gente pueda hablarle desde canales y mensajes directos.

Slack

Al conectar Slack, cualquiera dentro de tu espacio de trabajo puede hablar directamente con el agente. Slack le entrega los mensajes a Pepe a través de su Events API.

Paso a paso

Crear la app. En api.slack.com/apps → “Create New App” → elige “Blank app” (las otras opciones, como “AI agent”, traen su propio armazón de agente de Slack, que acá no hace falta - el agente es Pepe). Elige tu espacio de trabajo.
Dar permisos al bot. En OAuth & Permissions → Scopes → Bot Token Scopes, agrega chat:write, app_mentions:read, channels:history e im:history. Agrega también files:read si la gente va a enviar imágenes o archivos (sin él el bot no puede abrirlos), files:write para que el bot pueda enviar archivos de vuelta, reactions:write para marcar con un 👀 el mensaje en el que está trabajando, y reactions:read para que un 👍 o ❤️ en uno de sus mensajes cuente como feedback. Para esto último suscríbete también al evento de bot reaction_added. Agrega además channels:read (y groups:read para canales privados) para que la página Channels muestre el nombre de cada canal en lugar de su id, y users:read para que las personas que escriben aparezcan por su nombre al elegir quién puede entrenar.
Instalar la app. Sigue en OAuth & Permissions, hace clic en “Install to Workspace” y copia el Bot User OAuth Token (xoxb-...).
Conseguir el signing secret. En Basic Information → App Credentials, copia el Signing Secret.
Registrar la conexión en Pepe:
```
pepe setup
```
Elige la opción de canal, selecciona Slack y el agente, e ingresa las credenciales (cualquier secreto acepta una referencia ${ENV_VAR}). Pepe imprime la URL de callback que hay que registrar:
```
https://YOUR_HOST/webhooks/root/slack/<slug>
```
Cambia YOUR_HOST por el dominio donde tu servidor realmente responde (el dominio real en producción; mix pepe serve --tunnel si solo estás probando en local).
Activar los eventos en Slack. En la app → Event Subscriptions → Enable Events → pega la URL del paso anterior (Slack dispara un handshake de url_verification al instante, y Pepe lo responde solo, sin ningún paso manual). En “Subscribe to bot events”, agrega message.channels, app_mention y message.im (este último es el que hace que un mensaje directo funcione).
Apagar el Socket Mode. Las apps nuevas de Slack suelen venir con esto activado por defecto: barra lateral → Socket Mode. Mientras esté activo, Slack envía los eventos por WebSocket en vez de golpear tu Request URL - y Pepe solo entiende el webhook HTTP clásico, así que nada llega, en silencio, aunque todo lo demás esté bien configurado. Déjalo apagado.
Guardar. En la página de Event Subscriptions, hace clic en “Save Changes” al pie antes de salir - pegar la URL y salir sin guardar descarta todo.
Si Slack lo pide, reinstala la app en el espacio de trabajo (los scopes y eventos nuevos lo exigen).
Probarlo: invita al bot a un canal (/invite @tu-bot) y menciónalo, o mándale un mensaje directo.

Campos de la conexión

El config de una conexión guarda:

bot_token: el token OAuth del usuario bot (xoxb-...), que se usa como bearer al responder.
signing_secret: sirve para verificar el X-Slack-Signature de las solicitudes entrantes.

Las respuestas se publican mediante chat.postMessage.

Revisa Webhooks para conocer los campos que comparte toda conexión (agent, mode, trainers, session_ttl_min, ephemeral, commands) y cómo funciona por dentro la ruta genérica.

Mensajes de otras apps

Un canal que recibe su trabajo de otro sistema (un help desk que publica cada ticket nuevo, una alerta de monitoreo) recibe mensajes escritos por una app, y no por una persona. Pepe los ignora por defecto, para que el bot nunca se responda a sí mismo ni a otros bots. Para responder a uno, indica el id del bot (B...) o de la app (A...) en el campo Responder a estos bots y apps de la conexión (accept_bots, separados por comas). Cada mensaje ignorado queda en el log con sus ids, así que copias el correcto del log en lugar de adivinar. A una app de la lista se le contesta sin que la mencionen, así que no necesitas /mention off en ese canal: las personas que escriben ahí siguen teniendo que mencionar al bot, y solo pasa por sí sola la app que indicaste.

Las integraciones suelen poner todo el mensaje en el adjunto con la barra de color, y no en el texto. Pepe lee el título, el cuerpo y los campos del adjunto como el mensaje. Los mensajes del propio bot nunca se responden, aunque su id esté en la lista.

Para que un canal así siga escuchando sin @mención, envía /mention off una vez en él. Sigue activo después de /new y de reiniciar, hasta que alguien envíe /mention on.

Cambiar de modelo

Con los comandos /model y /models, cualquiera puede consultar o cambiar qué modelo de IA le está respondiendo. Ambos solo funcionan en una conexión con modo admin y commands habilitado; en modo support se tratan como texto normal, sin más. /models lista los modelos disponibles para el proyecto de esa conexión; /model muestra el actual, o lo cambia:

/model openrouter               # pregunta si cambiar solo este chat o todos
/model openrouter session       # cambia el modelo solo para esta conversación
/model openrouter global        # cambia el modelo para todos los que hablan por esta conexión

Cualquier persona dentro de una conversación permitida puede cambiar el modelo de su propia conversación. Cambiarlo de forma global, para todos los que hablan a través de esa conexión, queda reservado a los entrenadores, la misma lista de confianza que controla la memoria. Define model_switch_locked: true en la conexión si quieres desactivar por completo el cambio de modelo para quien no sea entrenador.

← WhatsApp Discord →