Saltar al contenido principal

Conectar y verificar Telegram en JMAX

Guía de verificación del conector de Telegram

JMAX — Asistente autónomo de Autonoomia Global

Comprobación paso a paso de la entrada y salida de mensajes

Versión 1.0 — Agosto de 2026

Alcance: esta guía cubre desde la creación del bot hasta la batería completa de pruebas de entrada, salida y seguridad, con su solución de problemas.

© 2026 Autonoomia Global. Todos los derechos reservados.

Contenido​

Contenido 2

  1. Qué es el conector y qué vas a comprobar 3

  2. Requisitos previos 3

  3. Fase 1 — Crear el bot en Telegram (2 minutos) 3

  4. Fase 2 — Configurar el token en JMAX 3

  5. Fase 3 — Vincular tu chat (quedar como dueño) 4

  6. Fase 4 — Batería de pruebas de verificación 4

Prueba 1 — Estado del conector 4

Prueba 2 — Entrada: pregunta simple desde el móvil 4

Prueba 3 — Entrada: uso de herramientas desde el móvil 4

Prueba 4 — Salida: JMAX te escribe al móvil 4

Prueba 5 — Lectura de lo recibido 5

Prueba 6 — Seguridad: un desconocido no entra 5

Prueba extra — Mensaje largo 5

  1. Solución de problemas 5

7.1 — El estado dice que falta el token 5

7.2 — El bot no contesta al primer mensaje 5

7.3 — Responde en el escritorio pero no llega el envío al móvil 5

7.4 — El dueño vinculado no soy yo 5

7.5 — Acciones que piden confirmación desde el móvil 5

  1. Referencia rápida 6

1. Qué es el conector y qué vas a comprobar​

El conector de Telegram convierte a JMAX en un asistente de bolsillo. Funciona en dos direcciones:

  • Entrada: le escribes a tu bot desde el teléfono y el mensaje entra a JMAX como un turno normal de conversación, con acceso a todas sus herramientas. La respuesta vuelve a Telegram.
  • Salida: JMAX puede enviarte avisos al móvil por iniciativa propia o cuando se lo pidas desde el chat de escritorio (herramienta telegram_send).

Usa la API oficial de bots de Telegram: no requiere escanear códigos QR, no vincula tu cuenta personal y no existe riesgo de bloqueo. Solo necesita un token que se obtiene gratis en dos minutos.

Al terminar esta guía habrás comprobado: el estado del conector, la vinculación de tu chat, la entrada desde el móvil, la salida desde el escritorio, la lectura de mensajes recibidos y la protección frente a desconocidos.

2. Requisitos previos​

Antes de empezar verifica que tienes:

  • JMAX instalado y funcionando en el ordenador (el icono abre y el chat responde).
  • La aplicación de Telegram en tu teléfono, con tu cuenta activa.
  • Conexión a internet en ambos equipos.
  • Acceso al archivo config/settings.json de la carpeta de JMAX (solo para pegar el token una vez).

3. Fase 1 — Crear el bot en Telegram (2 minutos)​

  1. Abre Telegram en tu teléfono y busca el contacto BotFather (con insignia azul de verificado: es el bot oficial de Telegram para crear bots).
  2. Escríbele /newbot y pulsa enviar.
  3. Te pedirá un nombre visible. Escribe por ejemplo: JMAX Asistente.
  4. Te pedirá un nombre de usuario que debe terminar en bot. Ejemplo: jmax_joaris_bot (si está ocupado, prueba variantes).
  5. BotFather responderá con un mensaje que incluye el token de acceso: una cadena parecida a 123456789:AAHfGk...xyz. Mantén ese mensaje a mano y trata el token como una contraseña: quien lo tenga controla el bot.

Resultado esperado de la fase: tienes un bot creado y su token copiado.

4. Fase 2 — Configurar el token en JMAX​

  1. Cierra JMAX si está abierto (clic derecho en el icono, salir).
  2. Abre la carpeta de instalación del proyecto y entra en config. Abre el archivo settings.json con el Bloc de notas.
  3. Añade el bloque de telegram al final del archivo, antes de la última llave de cierre. Debe quedar así (sustituye el valor por TU token):

"telegram": { "token": "123456789:AAHfGk...xyz" }

  1. Atención a las comas: si el bloque anterior termina en llave, añade una coma antes de pegar este bloque. Un JSON mal cerrado impide arrancar la configuración.
  2. Guarda el archivo y vuelve a abrir JMAX.

Comprobación: escribe en el chat de JMAX la frase revisa el estado del conector de telegram. Debe responder que el token está configurado y el puente escuchando, pero sin dueño vinculado todavía. Si dice que falta el token, revisa la fase 2 desde el paso 3.

5. Fase 3 — Vincular tu chat (quedar como dueño)​

  1. En Telegram, abre el chat con tu bot (búscalo por el nombre de usuario que creaste, por ejemplo jmax_joaris_bot).
  2. Pulsa Iniciar (o escribe /start) y envíale cualquier mensaje, por ejemplo: hola.
  3. Respuesta esperada en menos de un minuto: Hola [tu nombre], soy JMAX. Este chat queda vinculado como tu canal: escríbeme y te respondo desde tu propio equipo.

Importante: el PRIMER humano que escriba al bot queda fijado como dueño único. Hazlo tú antes de compartir el nombre del bot con nadie. Cualquier otra persona que le escriba después será ignorada en silencio.

6. Fase 4 — Batería de pruebas de verificación​

Ejecuta las seis pruebas en orden. Cada una tiene su resultado esperado; si alguna falla, ve directo a la sección 7 (Solución de problemas).

Prueba 1 — Estado del conector​

Dónde: chat de JMAX en el ordenador (texto o voz). Di: revisa el estado del conector de telegram.

Esperado: Token configurado. Puente: escuchando. Dueño vinculado: [tu nombre] (chat [número]).

Prueba 2 — Entrada: pregunta simple desde el móvil​

Dónde: Telegram, chat con tu bot. Escribe: ¿cuánto es 15 por 8?

Esperado: responde 120 en pocos segundos. Esto confirma que el mensaje entra a JMAX y la respuesta vuelve.

Prueba 3 — Entrada: uso de herramientas desde el móvil​

Dónde: Telegram. Escribe: busca en internet el precio actual del dólar en Colombia y resúmelo.

Esperado: una respuesta corta con el dato real. Esto confirma que desde el móvil se activan las mismas herramientas (búsqueda web, documentos, tareas) que en el escritorio.

Prueba 4 — Salida: JMAX te escribe al móvil​

Dónde: chat de JMAX en el ordenador. Di: envíame un mensaje de prueba por telegram que diga CONECTOR OK.

Esperado: JMAX pide confirmación en pantalla (el envío es una acción con efecto externo); al autorizar, el mensaje CONECTOR OK llega a tu Telegram en segundos.

Prueba 5 — Lectura de lo recibido​

Dónde: chat de JMAX en el ordenador. Di: ¿qué mensajes me han llegado por telegram?

Esperado: lista con los mensajes que enviaste en las pruebas 2 y 3, con tu nombre.

Prueba 6 — Seguridad: un desconocido no entra​

Dónde: pide a otra persona (u otra cuenta tuya de Telegram) que le escriba al bot.

Esperado: silencio absoluto. El bot no responde a nadie que no sea el dueño vinculado. Si respondiera, detén JMAX y revisa la sección 7.4.

Prueba extra — Mensaje largo​

Desde el móvil pide: explícame en detalle qué herramientas tienes. Telegram corta los mensajes en 4.096 caracteres; JMAX trocea la respuesta en varios mensajes seguidos automáticamente. Esperado: la respuesta llega completa, en uno o varios mensajes, sin errores.

7. Solución de problemas​

7.1 — El estado dice que falta el token​

El bloque de telegram no está en settings.json, tiene una errata o el JSON quedó mal cerrado. Ábrelo de nuevo, valida las comas y llaves, guarda y reinicia JMAX. El token no debe llevar espacios y conserva los dos puntos del medio.

7.2 — El bot no contesta al primer mensaje​

Comprueba en orden: 1) JMAX está abierto (el puente vive dentro de JMAX: sin app no hay respuestas); 2) en el chat de escritorio pide el estado del conector y verifica que diga escuchando; 3) si aparece un último error de red, espera un minuto: el puente reintenta solo; 4) verifica que el token pegado corresponde al bot al que escribes.

7.3 — Responde en el escritorio pero no llega el envío al móvil​

La causa más común: la confirmación quedó sin autorizar en la pantalla del ordenador. Repite la prueba 4 y pulsa Autorizar en el diálogo. Si no hay chat vinculado aún, JMAX lo dirá: escribe al bot desde tu móvil primero (fase 3).

7.4 — El dueño vinculado no soy yo​

Alguien escribió al bot antes que tú. Cierra JMAX, abre config/settings.json, borra dentro del bloque telegram las claves chat_id y dueno (deja solo el token), guarda y reinicia. Escribe tú el primer mensaje esta vez. Considera además regenerar el token con BotFather (/revoke) si el nombre del bot se difundió.

7.5 — Acciones que piden confirmación desde el móvil​

Por diseño, las acciones sensibles (enviar correos, borrar archivos, ejecutar comandos) requieren confirmación en la pantalla del ordenador. Desde Telegram esas acciones se deniegan educadamente: es la protección para que nadie con tu teléfono pueda disparar acciones peligrosas sin estar frente al equipo.

8. Referencia rápida​

Herramientas del conector disponibles en el chat de JMAX:

  • telegram_estado — diagnóstico: token, puente y dueño vinculado.
  • telegram_send — envía un mensaje a tu móvil (pide confirmación).
  • telegram_leer — muestra los últimos mensajes recibidos por el bot.

Archivos relevantes: config/settings.json (token y dueño vinculado) y jmax/tools/native/telegram.py (código del conector).

Guía elaborada por JMAX para Autonoomia Global. Si una prueba falla de forma repetida, pide en el chat: revisa el estado del conector de telegram y pega aquí el resultado.