Integración con Telegram — configuración y uso

Un bot por proyecto. Cada AI worker recibe su propio topic en una Supergroup de Telegram — los mensajes se enrutan automáticamente al worker correcto y la respuesta vuelve al mismo topic.

Cómo se ve en la práctica

Supergroup "My Project"
├── 📌 General          ← chat general (sin vinculación)
├── 🔵 Developer        ← mensajes → worker Developer
└── 🟢 Consultant       ← mensajes → worker Consultant

Escribes en el topic Developer → Arc OS lo procesa con Claude → la respuesta aparece en el mismo topic.

Telegram y el CRM Dashboard son dos canales hacia el mismo worker. Puedes empezar el diálogo en Telegram y continuarlo en el CRM — el contexto se conserva.

Configuración

Paso 1 — Crear el bot en BotFather

1. Abre @BotFather en Telegram
2. Envía /newbot
3. Introduce el nombre del bot (por ejemplo: My Project)
4. Introduce el username — debe terminar en bot (por ejemplo: my_project_arc_bot)
5. BotFather devolverá un token con el formato 123456789:AABBccDDee...

⚠️ Guarda el token — lo necesitarás al configurar el CRM.

Paso 2 — Crear una Supergroup con Topics

2.1 Crear el grupo

Telegram Desktop / Mobile:

1. Pulsa el icono del lápiz → New Group
2. Añade a cualquier participante (puedes eliminarlo después)
3. Da un nombre al grupo → Create

2.2 Activar los Topics

1. Abre la configuración del grupo (pulsa el nombre arriba)
2. Edit → busca la sección Topics
3. Activa el interruptor — Telegram convertirá automáticamente el grupo en una Supergroup

2.3 Averiguar el Supergroup ID

El Supergroup ID siempre empieza por -100.

Opción A — vía @userinfobot:

1. Reenvía cualquier mensaje del grupo al bot @userinfobot
2. El bot devolverá el ID con el formato -1001234567890

Opción B — vía Telegram Web:

1. Abre el grupo en web.telegram.org
2. En la barra de direcciones verás una URL del tipo #-1001234567890
3. Copia el número junto con el signo menos

Paso 3 — Añadir el bot como administrador

1. Abre la configuración del grupo → Administrators
2. Add Admin → en el buscador escribe @username_de_tu_bot (el username completo con @)
3. Elige el bot de la lista → OK
4. Los permisos por defecto son suficientes — déjalos como están

⚠️ El bot no aparecerá en la búsqueda si escribes un username incompleto o sin @. Introduce el @username exacto.

Paso 4 — Crear topics para los workers

En el grupo pulsa + → New Topic:

• Nombra los topics según los workers: Developer, Consultant, o nombres personalizados
• Puedes elegir colores/iconos para mayor comodidad

Paso 5 — Conectar en el CRM

1. Abre arc-os.co → elige el proyecto → Project Settings
2. Busca la sección Channels → pulsa Connect Telegram

5.1 Introducir los datos del bot

Pulsa Verify & get topics.

5.2 Verificación

El CRM comprobará:

• ✅ El token es válido
• ✅ El bot es administrador del grupo
• ✅ La lista de topics se ha cargado

5.3 Vincular topics a workers

Para cada topic elige un worker del desplegable:

Developer  →  [developer     ▾]
Consultant →  [consultant    ▾]
General    →  [(sin vincular)]

Pulsa Save bindings.

Paso 6 — Prueba

1. Escribe cualquier mensaje en el topic Developer
2. El bot responderá en el mismo topic desde el worker Developer
3. Repite con Consultant

Uso diario

Trabajar mediante topics (recomendado)

Simplemente escribe el texto de la tarea en el topic adecuado — no hacen falta prefijos:

[Topic Developer]
Corrige el bug del formulario de login — el campo email no se valida

[Topic Consultant]
Analiza la arquitectura del módulo auth, ¿qué se puede mejorar?

Si un topic no está vinculado a un worker — responde el worker por defecto.

Comandos en el chat privado con el bot

En el chat privado con el bot está disponible el cambio manual de workers mediante prefijos:

Ejemplos:

/c Analiza la arquitectura del módulo auth
/d Corrige el bug en el formulario de login
/w:sentinel Realiza una auditoría de seguridad de los últimos cambios

Un mensaje sin prefijo va al worker activo actual — después de /d Corrige el bug, los mensajes siguientes sin prefijo también irán al Developer.

Botones inline bajo la respuesta

Después de cada respuesta del AI worker aparecen botones de control:

Control del proceso:

Contexto y feedback:

Navegación:

Contexto y memoria

• Cada worker tiene una memoria separada (hasta 50 mensajes)
• Reply a un mensaje → su texto se añade como contexto a la petición
• El Context Router selecciona automáticamente los top-5 skills relevantes para tu mensaje
• El feedback 👎 → el sistema memoriza el error y lo tiene en cuenta en las próximas peticiones

Comandos de control del bot

Conexión con el CRM Dashboard

Topic de Telegram ──┐
                    ├──► Child Bot ──► Claude ──► Respuesta
CRM Dashboard     ──┘                              │
                                                   ▼
                                          Telegram + CRM (a la vez)

• Los mensajes del CRM se procesan cada 500ms
• Las respuestas aparecen en Telegram y en el CRM al mismo tiempo
• Los attachments (imágenes, PDF) se admiten a través del CRM Dashboard
• Puedes empezar el diálogo en Telegram y continuarlo en el CRM — el contexto se conserva

Desconectar el bot

CRM → Project Settings → Channels → Disconnect.

Esto eliminará el token y todas las vinculaciones de topics. El bot permanecerá en el grupo — elimínalo de los administradores manualmente si es necesario.

Solución de problemas