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.
- En Basic Information, copiá el Signing Secret.
- 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.
- Instalá la app en el espacio de trabajo y copiá el Bot User OAuth Token, que empieza con
xoxb-. - 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á:
| Campo | Qué va |
|---|---|
| Bot Token | El token xoxb-… del paso 3 |
| Signing Secret | El 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.

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:
- Activá los eventos y pegá la URL en Request URL. Slack la verifica al instante.
- En Subscribe to bot events, agregá
app_mentionymessage.im. - 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
- Mandale un mensaje directo al bot.
- En un canal, invitalo con
/invite @nombre-de-la-appy 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:
| Revisar | Por qué |
|---|---|
| La URL tiene el tenant y la clave del agente correctos | La verificación de Slack pasa igual con una URL equivocada |
| El Signing Secret es el de esta app | Si no coincide, los mensajes se descartan |
El token es el xoxb- vigente, con chat:write | Sin eso, el agente responde pero el mensaje no sale |
Están suscriptos app_mention y message.im | Sin eventos no llega nada |
| En canales, el mensaje menciona al bot y el bot está invitado | Sin mención no responde |
| En App Home está activada la pestaña Messages | Sin 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.channelssuscripto, 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:readeim:history. - La URL de eventos termina en la clave del agente correcto.
- Los eventos suscriptos son
app_mentionymessage.im, sinmessage.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.