Configuración de Telegram

Usa esta guía para conectar Clark a Telegram y verificar que el bot pueda leer los chats correctos.

Chat privado

1. Abre Telegram y busca @xdocai_bot.
2. Pulsa Start o envía /start.
3. Envía /help para ver los comandos disponibles.
4. Haz una pregunta sencilla, por ejemplo: Clark, ¿en qué puedes ayudar?

En un chat privado, Clark responde a mensajes normales porque la conversación es directamente con el bot.

Chat de grupo

1. Abre tu grupo de Telegram.
2. Añade @xdocai_bot como miembro.
3. Da permiso al bot para leer mensajes.
4. Vincula el grupo a tu workspace:

/link tu-tenant-id

Envíalo como un mensaje normal en el grupo. No necesitas mencionar a Clark ni etiquetar al bot. Si Telegram muestra el comando como /link@xdocai_bot tu-tenant-id, ese formato también funciona.

Si el grupo estaba vinculado a otro workspace, Clark moverá el chat al nuevo Tenant ID y mostrará una confirmación.

5. Envía un mensaje que mencione a Clark por nombre, por ejemplo: Clark, resume lo que discutimos hoy.

En chats de grupo, Clark conserva contexto en silencio y responde solo cuando se le menciona, se le etiqueta o alguien responde al bot. Esto evita interrumpir la conversación normal del equipo.

Comandos comunes

Comando	Resultado
/help	Muestra comandos disponibles.
/link <tenant_id>	Vincula o vuelve a vincular este chat de Telegram a un workspace.
/link_admin <tenant_id>	Convierte este chat de Telegram en el único Admin / Master Chat.
/docs	Muestra historial de documentos procesados.
/templates	Muestra plantillas de documentos subidas.
/memory	Muestra entidades y hechos recordados.
/task Prepare report @anna by 15.04 !high	Crea una tarea.
/tasks	Lista tareas en el chat actual.
/sum	Crea un resumen del chat actual.
/sum all	Crea un resumen de chats conectados desde el master chat.

Resúmenes automáticos

Los administradores pueden activar resúmenes automáticos en la configuración del chat del panel. Clark crea un /sum diario de lunes a jueves al final del día local, pero solo si hubo mensajes en las últimas 24 horas. Cada lunes a las 10:00 en la zona horaria del CEO/administrador, Clark crea /sum_week para la semana anterior. Los resúmenes se envían a Telegram o, si está configurado, en privado al CEO/administrador, y se guardan en Memory para contexto futuro.

Documentos en Telegram

Puedes enviar PDF, DOCX, XLSX, CSV, TXT e imágenes. Añade una descripción si quieres una acción específica:

Clark, encuentra el valor del contrato en este archivo

template Sales proposal

Clark procesará el archivo y lo hará visible en las secciones Documents o Templates del panel.

Master chat

El master chat es la conversación administrativa usada para resúmenes entre chats y revisión de tareas. Puede ser un chat privado con el bot o un grupo admin dedicado. Se configura con /link_admin <tenant_id>. Solo puede haber un master chat por workspace; al vincular uno nuevo, Clark quita el acceso master del anterior. Úsalo para:

• /link_admin <tenant_id>
• /sum all
• /tasks all
• revisiones semanales
• preguntar qué cambió en los chats conectados del equipo

Solo administradores aprobados del workspace deberían usar este flujo. Los comandos con all se aceptan solo desde el Admin / Master Chat.

Solución de problemas

Problema	Qué comprobar
El bot no responde en un grupo	Menciona Clark, etiqueta al bot o responde a un mensaje del bot.
El bot no ve mensajes	Revisa permisos del grupo de Telegram y ajustes de privacidad.
Los documentos no aparecen	Espera el procesamiento y actualiza la pestaña Documents del panel.
Los comandos se ignoran	Confirma que el comando se envió en un chat conectado y que el workspace está activo.
/link recibe una respuesta de IA	Envía /link <tenant_id> otra vez después de añadir Clark al grupo; no hace falta mencionar a Clark.