Slack
Descripción general
La integración con Slack permite que un agente de ElevenLabs envíe y reciba mensajes en Slack. Una vez conectado, el agente responde en un hilo cuando se le menciona en un canal y mantiene un contexto de conversación independiente para cada hilo.
Funcionalidades
Configuración
La integración ofrece dos formas de conectarse:
- OAuth: instala la app compartida de Slack de ElevenLabs en tu espacio de trabajo. Un espacio de trabajo de Slack se asigna a una única conexión de ElevenLabs. Es la configuración más rápida y no requiere gestionar una app de Slack.
- Usa tu propia app: conéctate con una app de Slack que crees y sea de tu propiedad. Úsala si necesitas que el bot aparezca con tu marca o si las políticas de tu espacio de trabajo requieren que un administrador instale las apps.
Opción A: OAuth
El usuario que instale la app debe tener permiso para añadir apps al espacio de trabajo de Slack de destino.
Abre la página de integraciones
En el panel de ElevenLabs, ve a Agentes > Integraciones y selecciona Slack.
Opción B: Usa tu propia app de Slack
Usa esta opción si quieres que el bot aparezca con el nombre y el icono de tu propia app, o si tu espacio de trabajo requiere que el administrador revise e instale las apps.
Crea una app de Slack
Ve a Slack API: Your Apps y haz clic en Create New App > From scratch. Asigna un nombre a la app y elige el espacio de trabajo de Slack donde instalarla.
Añade ámbitos del bot
Abre OAuth & Permissions y añade los siguientes ámbitos de token del bot:
app_mentions:read, channels:history, channels:join, channels:manage, chat:write, files:read, groups:history, groups:write, im:history, reactions:write.
Después, haz clic en Install to Workspace y aprueba la instalación. Copia el Bot User OAuth Token (empieza por xoxb-).
Crea la conexión en ElevenLabs
En el panel de ElevenLabs, ve a Integraciones, haz clic en el botón Añadir integración y elige Slack. Selecciona la credencial Usa tu propia app. Pega el token del bot y el secreto de firma y, después, guarda. ElevenLabs verifica el token con Slack y registra el ID de tu espacio de trabajo.
Una vez creada la conexión, su página muestra dos URL de webhook derivadas de la identidad de tu app de Slack. La misma app de Slack, reconectada desde el mismo espacio de trabajo de ElevenLabs, siempre genera las mismas URL, por lo que puedes eliminar y volver a crear la conexión sin tener que actualizar de nuevo la configuración de tu app de Slack. Mantén esa página abierta para los siguientes pasos.
Configura las suscripciones a eventos
En tu app de Slack, abre Event Subscriptions, activa los eventos y pega la URL de eventos de la página de conexión de ElevenLabs en Request URL. Slack verificará la URL mediante el secreto de firma que proporcionaste.
Suscríbete a eventos del bot según cómo quieras que se comporte el agente en los canales:
- Solo menciones: suscríbete a
app_mention. El agente responde únicamente cuando un usuario menciona al bot con@. - Todos los mensajes: suscríbete a
message.channelsymessage.groups. El agente responde a todos los mensajes de los canales donde está el bot, sin necesidad de mención.
Si utilizas el activador SlackDirectMessage, suscríbete también a message.im.
No te suscribas a la vez a app_mention y a los eventos de canal message.*, salvo que quieras gestionar entregas duplicadas. Cuando un usuario menciona al bot con @, Slack puede enviar un evento app_mention y un evento message para el mismo mensaje, lo que hace que el agente responda dos veces.
Un espacio de trabajo de Slack solo se puede conectar una vez mediante la app compartida de OAuth de ElevenLabs. Al reinstalarla
desde otro espacio de trabajo de ElevenLabs aparece un error duplicate Slack workspace: elimina primero la
conexión existente. Las conexiones con tu propia app son independientes y no entran en conflicto.
Ámbitos de OAuth
La app de Slack de ElevenLabs solicita los siguientes ámbitos:
Herramientas del agente
Al añadir herramientas de Slack a un agente, estarán disponibles las siguientes herramientas integradas:
Eliminar la conexión
Al eliminar la conexión desde la página Integraciones, se desinstala la app de Slack de ElevenLabs del espacio de trabajo de Slack. Tras eliminarla, el bot deja de estar presente en todos los canales.
En conexiones con tu propia app, ElevenLabs no puede desinstalar una app que no posee: al eliminar la conexión solo se elimina la asignación local. Para eliminar por completo el bot de tu espacio de trabajo de Slack, desinstala la app desde la configuración de administración de Slack.
Configura el activador
La integración expone un único activador, SlackMessage. Se activa cuando el bot detecta un nuevo mensaje de usuario en un canal configurado.
Añade un activador SlackMessage
En la página de configuración de tu agente, añade un nuevo activador y selecciona SlackMessage.
Slack no permite que las apps se unan automáticamente a canales privados. Para un canal privado, ejecuta /invite @Eleven en ese canal después de guardar el activador para que el bot pueda ver los mensajes.
Solo se permite un activador por cada par (Slack workspace, channel). Edita el activador existente
en lugar de crear uno duplicado.
Configura el activador de mensajes directos
El activador SlackDirectMessage permite que cualquier usuario de Slack chatee con el agente enviando un mensaje directo al bot. A diferencia del activador de canal, no hace falta mencionar con @: se procesa cada mensaje que un usuario envía en un mensaje directo con el bot.
Para apps propias, asegúrate de haberte suscrito al evento del bot message.im y de haber añadido el
ámbito de bot im:history. Reinstala la app si se te solicita después de añadirlos.
Solo se permite un activador de mensajes directos por conexión de Slack. Para cambiar el agente, edita el activador existente.
Hablar con el bot en Slack
Cuando el activador esté activo y el bot esté en el canal, inicia una conversación en un hilo de canal. La forma de continuar el hilo depende de las suscripciones a eventos de tu app de Slack (OAuth utiliza el comportamiento de solo menciones).
Solo menciones (app_mention)
Todos los mensajes (message.channels, message.groups)
Mientras el bot genera una respuesta, añade una reacción :eyes: al mensaje del usuario que activó la interacción y la elimina una vez publicada la respuesta.
El ajuste Responder a mensajes de del activador de mensajes de canal controla quién puede activar el agente:
- Solo personas (predeterminado): se ignoran los mensajes de otros bots y de workflows de Slack. Es la opción predeterminada segura y conserva el comportamiento de los activadores existentes.
- Personas y bots: los mensajes de otros bots y los mensajes publicados por workflows (incluidos los eventos heredados
bot_message) también activan el agente.
El bot siempre ignora sus propios mensajes, utilizando la identidad de usuario del bot y de la app en el webhook firmado de Slack, con cualquiera de las dos opciones, por lo que nunca se responde a sí mismo aunque se mencione. También sigue ignorando los mensajes editados (message_changed) y eliminados (message_deleted). Gestiona los eventos message y app_mention, y funciona tanto en canales públicos como privados.
Los eventos de bots heredados que solo contienen un bot_id identifican al remitente, pero no a la app receptora. Se
tratan como mensajes de otro bot; la detección de bucles propios para esta app de Slack usa la identidad del usuario del bot
o de la app incluida en las cargas útiles de eventos modernos de Slack.
Si tu app de Slack está suscrita tanto a app_mention como a message.channels / message.groups, una sola
mención con @ puede activar dos respuestas del agente. Suscríbete a un modo u otro.
Modelo de conversación
El ID de conversación es determinista para cada (agent_id, channel_id, thread_ts):
- Un nuevo hilo de Slack se asigna a una nueva conversación de ElevenLabs.
- Continuar el mismo hilo continúa la misma conversación, incluidos el historial de transcripción y las variables dinámicas.
Al construir el historial de chat, el bot lee directamente el hilo de Slack. Los mensajes de miembros de Slack y de otros bots se tratan como turnos de usuario, mientras que los mensajes del propio bot se tratan como turnos del agente. Las menciones al usuario del bot (<@BOT_USER_ID>) se reescriben como @<agent_name> antes de que el agente las procese.
Variables dinámicas
Cuando un agente se ejecuta desde Slack, las siguientes variables dinámicas están disponibles en prompts y herramientas:
Consulta variables dinámicas para saber cómo usarlas en prompts y llamadas a herramientas.
Solución de problemas
Los archivos adjuntos no funcionan
Si un usuario adjunta una imagen o un PDF en Slack, pero el agente no lo procesa (o se comporta como si no se hubiera enviado ningún archivo), sigue las comprobaciones siguientes.
Confirma que la app de Slack tiene files:read
El bot necesita el ámbito de bot files:read para descargar adjuntos de Slack.
- Usa tu propia app: abre tu app en Slack API: Your Apps, ve a OAuth & Permissions y verifica que
files:readaparece en Bot Token Scopes. Si lo añadiste recientemente, reinstala la app en tu espacio de trabajo para que el token adopte el nuevo ámbito.
Confirma que el modelo del agente admite archivos como entrada
Los archivos adjuntos solo se reenvían cuando el LLM del agente admite entrada multimodal: entrada de imágenes o de documentos (PDF), según el tipo de archivo. En la configuración del agente, abre la pestaña Agente y revisa el modelo seleccionado. Si el modelo no admite el tipo de archivo adjunto, cambia a uno que sí lo admita.
Activa Permitir archivos adjuntos en la configuración del agente
En la página de configuración del agente, abre Configuración > Avanzado. En Entrada multimodal, activa Permitir archivos adjuntos. Guarda el agente. Sin este ajuste, los adjuntos de Slack se ignoran incluso cuando la app de Slack y el modelo admiten archivos.