Integraciones

Conecta tus agentes a plataformas de mensajeria para que las personas puedan hablar con ellos fuera del dashboard. Autonomis soporta Discord, Telegram, Slack y WhatsApp.

Como Funcionan las Integraciones

Cada integracion conecta una plataforma de mensajeria a uno o mas de tus agentes. Cuando alguien envia un mensaje en esa plataforma (ej., un mensaje de Discord o un DM de Telegram), tu agente lo recibe, lo procesa y responde — todo automaticamente.

La configuracion de cada plataforma sigue el mismo patron:

1. Crea un bot/app en la plataforma externa
2. Pega el token del bot (y a veces el token de app) en Autonomis
3. Configura que agente maneja que canal
4. Activa — tu agente ahora esta en vivo en esa plataforma

Todos los tokens de bot se almacenan como Secretos encriptados usando Vault Transit (AES-256-GCM).

El Centro de Integraciones

Haz clic en "Integraciones" en la barra lateral para ver el centro principal. Veras cuatro tarjetas de plataforma:

• Discord — Integracion de bot via la API de Discord
• Telegram — Integracion de bot via la API de Telegram Bot
• Slack — Integracion de bot via Slack Socket Mode
• WhatsApp — Integracion via WhatsApp Business

Cada tarjeta muestra una insignia de estado de conexion: "Conectado" o "No conectado". Haz clic en una tarjeta para abrir su asistente de configuracion.

Discord

La integracion de Discord permite que las personas en tu servidor de Discord hablen con tus agentes via canales. Cada canal puede mapearse a un agente diferente.

Pasos de Configuracion

1. Crea un Bot de Discord — Ve al Portal de Desarrolladores de Discord, haz clic en "New Application", dale un nombre, ve a la pestaña "Bot" y haz clic en "Reset Token" para obtener tu token de bot.
2. Habilita los Intents Requeridos — En la configuracion del Bot, habilita Message Content Intent, Server Members Intent y Presence Intent. Estos son requeridos para que el bot lea mensajes.
3. Pega el Token del Bot — De vuelta en Autonomis, pega tu token de bot en el campo de token.
4. Invita al Bot a tu Servidor — Ingresa tu Application ID (encontrado en el Portal de Desarrolladores bajo "General Information"). Autonomis genera una URL de invitacion con los permisos correctos. Haz clic para agregar el bot a tu servidor.
5. Mapea Canales a Agentes — Ingresa tu Server ID de Discord y mapea cada canal a un agente. Puedes encontrar los IDs de canal habilitando el Modo Desarrollador en la configuracion de Discord, luego haciendo clic derecho en un canal y seleccionando "Copiar ID del Canal".
6. Requerir @mencion (opcional) — Activa esto si quieres que el bot solo responda cuando alguien lo @mencione. De lo contrario, responde a cada mensaje en los canales mapeados.

Telegram

La integracion de Telegram permite que las personas chateen con tus agentes via DMs de Telegram o chats grupales. Puedes controlar quien tiene acceso y como se comporta el bot en diferentes contextos.

Pasos de Configuracion

1. Crea un Bot de Telegram — Abre Telegram, busca @BotFather, envia /newbot, sigue las instrucciones (elige un nombre y nombre de usuario) y copia el token del bot.
2. Pega el Token del Bot — Ingresa el token en Autonomis.
3. Elige un Agente — Selecciona que agente maneja los mensajes de Telegram.
4. Configura el Acceso por DM — Elige quien puede enviar DMs al bot:
   • Abierto — Cualquiera puede enviar mensajes al bot
   • Emparejamiento — Los usuarios deben emparejarse primero (el bot envia un codigo)
   • Lista permitida — Solo IDs de Usuario de Telegram especificos pueden enviar mensajes
   • Deshabilitado — Sin DMs permitidos (solo grupos)
5. Configura el Acceso a Grupos — Elige como se comporta el bot en chats grupales:
   • Cualquiera — El bot responde en cualquier grupo al que se agregue
   • Lista permitida — Solo responde en IDs de Chat de Grupo especificos
   • Deshabilitado — Sin soporte de chat grupal
6. Requerir @mencion en Grupos (opcional) — Activa esto si quieres que el bot solo responda cuando lo @mencionen en grupos.
7. Activar — Revisa tu configuracion y haz clic en "Activar". El contenedor se reinicia para conectar el bot.

Slack

La integracion de Slack usa Socket Mode para comunicacion en tiempo real — no se requiere URL publica. Tus agentes aparecen como usuarios bot en tu workspace de Slack.

Pasos de Configuracion

1. Crea una App de Slack — Ve a api.slack.com/apps, haz clic en "Create New App", elige "From scratch", dale un nombre y selecciona tu workspace.
2. Habilita Socket Mode — Ve a "Socket Mode" en la barra lateral y habilitalo. Esto genera un App-Level Token (empieza con xapp-). Copialo.
3. Agrega Scopes del Bot — Ve a "OAuth & Permissions" y agrega estos scopes de token del bot: app_mentions:read, channels:history, chat:write, groups:history, im:history, mpim:history
4. Instala en el Workspace — Haz clic en "Install to Workspace" y autoriza. Copia el Bot User OAuth Token (empieza con xoxb-).
5. Suscribete a Eventos — Ve a "Event Subscriptions", habilita eventos y suscribete a: message.channels, message.groups, message.im, message.mpim, app_mention
6. Pega los Tokens en Autonomis — Ingresa tanto el Bot User OAuth Token como el App-Level Token.
7. Mapea Canales a Agentes — Ingresa los IDs de Canal de Slack y mapea cada uno a un agente.
8. Requerir @mencion (opcional) — Activa esto si quieres que el bot solo responda cuando lo @mencionen en los canales.

WhatsApp

La integracion de WhatsApp conecta tus agentes a WhatsApp usando la plataforma WhatsApp Business. Las personas pueden enviar mensajes a tu agente como a cualquier otro contacto de WhatsApp.

Pasos de Configuracion

1. Configura WhatsApp Business — Necesitas una cuenta de WhatsApp Business. El asistente de configuracion te guia a traves del proceso de inicio de sesion y autenticacion.
2. Emparejamiento de Dispositivo — Vincula tu cuenta de WhatsApp a Autonomis. El asistente maneja el proceso de emparejamiento con tu dispositivo.
3. Configura Contactos — Gestiona que contactos pueden comunicarse con tus agentes.
4. Configura Webhooks — Configura endpoints de webhook para que los mensajes se enruten a los agentes correctos.
5. Activar — Una vez que todo esta configurado, activa la integracion. El contenedor se reinicia para establecer la conexion.

Mapeo de Canal a Agente

Para Discord, Telegram y Slack, puedes mapear canales especificos a agentes especificos. Esto significa:

• Canal A → tu agente researcher
• Canal B → tu agente writer
• Por defecto → tu agente manager (maneja canales no mapeados)

Esto te permite crear canales dedicados para diferentes tareas y tener al agente especialista correcto manejando cada uno.

Desconectar una Integracion

Para desconectar una integracion:

1. Ve a la pagina de configuracion de la integracion (haz clic en la tarjeta de la plataforma en el centro de Integraciones)
2. En la parte superior, veras un banner de exito con un boton "Desconectar"
3. Haz clic en "Desconectar" — el bot se elimina de la plataforma y todos los tokens almacenados se borran

Despues de desconectar, el contenedor se reinicia para eliminar la integracion. Puedes reconectar en cualquier momento repitiendo el asistente de configuracion.

El Toggle de @mencion

La mayoria de las integraciones tienen un toggle de "Requerir @mencion". Cuando esta habilitado:

• El bot solo responde cuando alguien lo @menciona por nombre
• Otros mensajes en el canal se ignoran
• Esto es util en canales concurridos donde no quieres que el bot responda a cada mensaje

Cuando esta deshabilitado, el bot responde a todos los mensajes en los canales mapeados.

Seguridad

Todos los tokens de integracion (tokens de bot, tokens OAuth, tokens de nivel de app) se encriptan con AES-256-GCM via Vault Transit antes de almacenarse. Nunca se almacenan como texto plano y solo se desencriptan dentro del contenedor en tiempo de ejecucion.

Siguientes Pasos

• → Agrega claves API y secretos necesarios por integraciones
• → Instala habilidades para mejorar las capacidades del agente
• → Prueba tus agentes con el Chat integrado