Volver a documentosIntegraciones

Telegram

Trae tu bot de Telegram, ligado a un agente, para DMs y grupos.

Última actualización: 27 de mayo de 2026 · 3 min read

Telegram es el canal adecuado cuando Slack no es una opción — estás fuera del tenant de Slack del espacio de trabajo, colaboras con un grupo que vive en Telegram, o quieres un canal móvil ligero de DM con Zero separado del Slack de tu equipo.

Traes tu propio bot. Cada bot de Telegram está ligado a un único agente en tu espacio de trabajo de VM0, así que un bot personal y un bot de equipo pueden enrutar a agentes distintos con habilidades distintas.

Conexión

  1. Habla con @BotFather en Telegram. Ejecuta /newbot, dale un nombre a tu bot y copia el token que BotFather te dé.
  2. En VM0, abre Dónde funciona Zero y elige Telegram.
  3. Pega el token del bot. Elige a qué agente debe enrutar el bot.
  4. (Para uso en grupos) Desactiva el modo privacidad del bot en BotFather: /setprivacy → elige tu bot → Disable. Sin esto, el bot solo puede ver mensajes que le @mencionen directamente; con él desactivado, el bot lee el contexto del grupo alrededor de las menciones y las respuestas.
  5. Abre Telegram y manda un mensaje al bot. El primer mensaje inicia una sesión enlazada en VM0.

Cómo usar Zero en Telegram

Dos patrones principales:

DM al bot. Se comporta como un chat privado con Zero. Mensajes, archivos, fotos — Zero los ve todos. Cada hilo de DM se mapea a una sesión en VM0.

Añade el bot a un grupo. Con el modo privacidad desactivado, el bot lee los mensajes alrededor de las menciones y respuestas. @menciona al bot o responde a sus mensajes para mantener un flujo. Los demás miembros del grupo nunca ven el razonamiento de Zero, solo el resultado que el bot publica.

Flujos comunes en Telegram

  • Triaje de bandeja móvil. En el tren, manda un DM a tu bot: "resume mis Slack no leídos de #cs." Zero responde en segundos.
  • Grupos con proveedores o partners. Añade el bot a un grupo con gente externa a tu empresa. El bot gestiona la agenda, los recordatorios o las traducciones sin exponer tu Slack interno.
  • Bots por agente. Liga un bot de investigación a tu agente de investigación y un bot personal a tu agente personal. La misma app de Telegram, bots distintos, agentes distintos.

Enrutado por agente

Cada token de bot está ligado a exactamente un agente. Si quieres que responda un agente distinto, crea un segundo bot en BotFather y lígalo. Es así por diseño: la identidad del bot de Telegram es la identidad del agente en esa superficie.

Soporte de archivos

Telegram soporta fotos, notas de voz, documentos y PDFs. Zero los ingiere todos como entradas de sesión. Los archivos salientes (artefactos que Zero produce) se devuelven como documentos o imágenes de Telegram en línea.

Errores comunes

  • El bot no responde en un grupo. El modo privacidad sigue activo. Vuelve a ejecutar /setprivacy en BotFather → Disable, luego quita y vuelve a añadir el bot al grupo.
  • Responde el agente equivocado. El token del bot está ligado a un único agente. Para cambiarlo, cambia la vinculación en Dónde funciona Zero, o usa un bot separado.
  • Token del bot filtrado. Rótalo en BotFather (/revoke), luego actualiza el token en VM0. El token antiguo deja de funcionar de inmediato.

Qué sigue

  • Consulta Habilidades para capturar flujos móviles recurrentes.
  • Consulta Permisos para ver qué puede y qué no puede hacer Zero a través de tu bot.