Conectar Slack — Manual del operador | AI Agent Builder

Conectar Slack

Paso a paso para que el equipo de un cliente hable con un agente desde Slack: crear la app, los permisos y eventos, la URL que hay que armar, cómo responde en canales y mensajes directos, y qué hacer cuando no contesta.

5 min de lectura · Actualizado 13 de noviembre de 2026

Esta guía conecta el Slack interno de Clínica del Sol con el Asistente de recepción, para que el personal le haga preguntas sobre agenda y protocolos sin salir de Slack. Cómo arma Slack las conversaciones —por canal, hilo y persona— está en el capítulo Llevarlo a los usuarios.

Los pasos del lado de Slack siguen la consola de Slack al momento de escribir esta guía. Lo que dice del lado de la plataforma está verificado contra el código.

Antes de empezar

  • Una app de Slack, un espacio de trabajo y un agente por tenant. El tenant guarda un solo token y un solo secreto, y una app de Slack tiene una sola URL de eventos, que apunta a un agente.
  • El agente lo decide la URL, como con Twilio: la URL de eventos lleva la clave del agente.
  • El tenant necesita Slack habilitado en sus funcionalidades (capítulo 8).
  • Alguien con permiso para instalar apps en el espacio de trabajo de Slack de la clínica.

La configuración está en Integraciones → Slack.

1. Crear la app en Slack

En api.slack.com/apps, creá una app nueva desde cero y elegí el espacio de trabajo de la clínica. La plataforma no ofrece un manifiesto: la app se arma a mano.

  1. En Basic Information, copiá el Signing Secret.
  2. En OAuth & Permissions, agregá estos permisos del bot (Bot Token Scopes):
    • chat:write, para responder;
    • app_mentions:read, para recibir menciones en canales;
    • im:history, para recibir mensajes directos.
  3. Instalá la app en el espacio de trabajo y copiá el Bot User OAuth Token, que empieza con xoxb-.
  4. En App Home, activá la pestaña Messages para que la gente pueda escribirle al bot por mensaje directo.

2. Cargar las credenciales

En Integraciones → Slack, completá:

CampoQué va
Bot TokenEl token xoxb-… del paso 3
Signing SecretEl secreto del paso 1

Guardar. Los dos se guardan cifrados. La plataforma no prueba el token al guardar: si está mal, lo vas a notar recién cuando el bot no responda.

Slack configurado: estado, token y secreto
Slack configurado: estado, token y secreto

3. La URL de eventos

La pantalla no muestra la URL que hay que darle a Slack. Se arma así:

{URL de la API}/webhook/slack/{tenant}/{agente}

En la instalación de Synaptic Links, para el asistente de recepción de la clínica:

https://ai.synapticlinks.com.ar/api/webhook/slack/clinica-del-sol/recepcion-interna

La clave del agente está en su detalle.

En Slack, en Event Subscriptions:

  1. Activá los eventos y pegá la URL en Request URL. Slack la verifica al instante.
  2. En Subscribe to bot events, agregá app_mention y message.im.
  3. Guardá. Slack puede pedir reinstalar la app.

Que Slack diga "Verified" no prueba que la URL sea correcta. La plataforma responde la verificación antes de mirar el tenant y el agente, así que una URL con un error de tipeo también aparece verificada. La prueba real es el paso siguiente.

No agregues message.channels. Con ese evento y app_mention juntos, cada mención llega dos veces y el agente responde dos veces.

4. Probar

  1. Mandale un mensaje directo al bot.
  2. En un canal, invitalo con /invite @nombre-de-la-app y mencionalo.

Las conversaciones aparecen en Monitoreo → Sesiones. Si el bot no responde, mirá la tabla del final.

Cómo se comporta

  • Mensajes directos: responde a todo.
  • Canales: responde solo a los mensajes que tienen una mención.
  • Hilos: si le escriben dentro de un hilo, responde en el hilo. Una mención suelta en un canal recibe la respuesta en el canal, no en un hilo.
  • Una conversación por canal, hilo y persona. Si otra persona responde en el mismo hilo, para la plataforma es otra conversación.
  • El agente ve la mención en el texto. Recibe algo como <@U0ABC123> ¿quién atiende hoy en Sede Norte?. Conviene que su prompt lo tolere.
  • Formato: negritas, cursivas, tachados y enlaces se convierten al formato de Slack; los títulos se muestran en negrita. Las respuestas largas se dividen en partes de hasta 4.000 caracteres.
  • Solo texto: mensajes editados, archivos y otros tipos de mensaje se ignoran.
  • Sin botones: no hay aprobaciones ni opciones interactivas en Slack.
  • Idioma: responde en el idioma por defecto del tenant.

Cuando el bot no responde

La plataforma le confirma la recepción a Slack antes de procesar el mensaje, así que Slack nunca muestra un error: los problemas solo quedan en los registros del servidor. Revisá en este orden:

RevisarPor qué
La URL tiene el tenant y la clave del agente correctosLa verificación de Slack pasa igual con una URL equivocada
El Signing Secret es el de esta appSi no coincide, los mensajes se descartan
El token es el xoxb- vigente, con chat:writeSin eso, el agente responde pero el mensaje no sale
Están suscriptos app_mention y message.imSin eventos no llega nada
En canales, el mensaje menciona al bot y el bot está invitadoSin mención no responde
En App Home está activada la pestaña MessagesSin ella no se le puede escribir por mensaje directo

Dónde termina

  • Un espacio de trabajo, una app y un agente por tenant.
  • La pantalla no muestra la URL de eventos ni ofrece manifiesto o botón de instalación.
  • No se prueba el token al guardar.
  • "Habilitado" es solo informativo: para apagar Slack, hay que eliminar la configuración.
  • Con message.channels suscripto, cualquier mención cuenta: un mensaje que menciona a otra persona también recibiría respuesta. Por eso no hay que suscribirlo.
  • No hay botones, archivos ni indicador de "escribiendo".
  • La protección contra eventos repetidos es por servidor: con varias instancias, un reintento de Slack podría responderse dos veces.

Para revisar

  • La app tiene los permisos chat:write, app_mentions:read e im:history.
  • La URL de eventos termina en la clave del agente correcto.
  • Los eventos suscriptos son app_mention y message.im, sin message.channels.
  • Un mensaje directo y una mención en un canal reciben respuesta y aparecen en Sesiones.
  • Si hay que apagar Slack, se elimina la configuración, no alcanza con el estado.