Slack

2 min de lectura

Slack conecta un bot con los canales y mensajes directos donde está presente. Puede responder en hilos, intercambiar archivos y presentar aprobaciones; Slack valida cada evento antes de que llegue a Kujira mediante la URL de eventos y el secreto de firma.

Preparar la aplicación

Crea una aplicación de Slack

Desde Your Apps, crea una aplicación para el workspace correcto y añade un bot.

Configura los permisos mínimos

En OAuth & Permissions, añade los scopes que correspondan a los espacios donde trabajará: lectura de historial para canales, grupos privados, mensajes directos o grupos de mensajes directos; chat:write para responder; y files:read solo si debe procesar archivos.

Instala la aplicación

Instálala en el workspace y guarda el Bot User OAuth Token y el Signing Secret de la aplicación. El token permite operar como el bot; el secreto permite validar que las peticiones proceden de Slack.

Crea el canal en Kujira

En Canales del agente, añade Slack e introduce ambos valores. Kujira mostrará una URL de entrada para los eventos.

No reutilices el token de otro bot

Cada aplicación y workspace debe tener sus propias credenciales. Guarda el token y el Signing Secret solo en Kujira o en un gestor de secretos autorizado.

Configurar eventos e interacciones

En Event Subscriptions, activa los eventos y pega la URL de entrada de Kujira como Request URL. Slack verificará la URL antes de permitir guardar la configuración. Suscribe únicamente los eventos necesarios para los tipos de conversación que atenderá el agente.

Para las aprobaciones y otros botones, activa Interactivity & Shortcuts y utiliza la misma URL con el sufijo /interactive. Tras modificar scopes o eventos, reinstala la aplicación en el workspace cuando Slack lo solicite.

Consulta la relación entre eventos, scopes y bots en la documentación de Slack.

El acceso depende del canal

Slack solo entrega al bot la actividad que este puede ver. Invitarlo a un workspace no lo incorpora automáticamente a todos los canales; añádelo de forma explícita a cada canal público o privado donde deba trabajar y autoriza esos identificadores también en Kujira.

Canales públicos

Añade el bot al canal, suscribe los eventos de mensajes adecuados y conserva la regla de mención cuando comparta el canal con el equipo.

Canales privados y mensajes directos

Invita el bot expresamente y concede solo los scopes de historial imprescindibles. Revisa con más cuidado la lista de permitidos.

Comprobar la integración

1. Comprueba que Slack ha aceptado la Request URL.
2. Invita el bot a un canal autorizado y envíale una mención.
3. Verifica que puede responder en el mismo hilo o canal.
4. Si no llega el mensaje, revisa los eventos suscritos, el scope de historial correspondiente, la pertenencia del bot y la lista de permitidos.
5. Si llega pero no puede responder, revisa chat:write y los permisos del canal.

La lista de permitidos vacía bloquea los mensajes entrantes. Las conversaciones externas se administran desde Agent Desk.