Buscador de chat ID de Telegram
Este buscador de chat ID de Telegram muestra el chat_id de cada chat privado, grupo, supergrupo, canal y tema del foro del que tu bot recibió actualizaciones recientemente: pega el token del bot, envíale un mensaje al bot y pulsa un botón.
El token se queda en tu navegador (localStorage) y solo se envía a api.telegram.org.
Envía cualquier mensaje a tu bot (o agrégalo a un grupo o canal y publica ahí) y luego pulsa el botón.
Las actualizaciones se leen sin offset, así que quedan sin confirmar y tu bot las sigue recibiendo.
Cómo obtener el chat ID de Telegram
- Pega el token de tu bot (dónde encontrarlo: /es/guides/telegram-bot-token.html). Marca Servidor de pruebas solo si el bot está en el entorno de pruebas.
- Escríbele cualquier cosa al bot en un chat privado. Para un grupo, agrega el bot y envía
/start@your_bot: con el modo de privacidad activado, el bot solo ve los comandos dirigidos a él. Para un canal, agrega el bot como administrador y publica una entrada. - Pulsa Buscar chat ID. La tabla lista cada chat con su nombre, tipo,
chat_idy, para los temas del foro, elmessage_thread_id. Usa Copiar junto al ID. - Para un canal o supergrupo público puedes saltarte las actualizaciones y escribir su
@usernameen el campo de búsqueda.
Qué pasa por dentro
Primero la herramienta llama a getMe para comprobar el token y mostrar qué bot estás usando. Después llama a getUpdates con limit 100 y timeout 0, y sin offset. Sin offset, Telegram no confirma las actualizaciones, así que tu bot (o la siguiente ejecución de la herramienta) las sigue recibiendo.
Los chats se recopilan de mensajes y mensajes editados, publicaciones de canales, mensajes de empresa, callback queries, cambios de my_chat_member y chat_member, solicitudes de unión, reacciones y boosts. Por eso, muchas veces basta con agregar el bot a un grupo o canal para que el chat aparezca.
La búsqueda por @username llama a getChat. La Bot API acepta un username solo para supergrupos y canales públicos; a los usuarios no se les puede buscar por username.
Si no aparece ningún chat
- Lista vacía: no hay actualizaciones recientes. Telegram guarda las actualizaciones hasta 24 horas, y un bot que funciona con Long Polling las confirma casi al instante. Detén el bot un momento, envía un mensaje nuevo y vuelve a intentarlo.
- 409 Conflict: hay un webhook configurado y
getUpdatesestá desactivado. La herramienta ofrece Eliminar webhook (condrop_pending_updates=false, así que las actualizaciones en cola se conservan) y vuelve a intentarlo. Después configura de nuevo el webhook: /es/guides/telegram-bot-webhook.html. - Falta un grupo: el modo de privacidad oculta los mensajes normales; envía un comando dirigido al bot.
Privacidad
El token se guarda solo en el localStorage de tu navegador, y las solicitudes van directamente de tu navegador a api.telegram.org. Nada pasa por nuestro servidor. Puedes repetir la misma llamada a mano en /es/telegram-bot-api-tester.html#getUpdates. Para ver cada tipo de chat en detalle, lee /es/guides/telegram-chat-id.html, y para enviar el primer mensaje al ID que encontraste, consulta /es/guides/telegram-bot-send-message.html.
Preguntas frecuentes
¿Cómo encuentro mi chat ID de Telegram?
Envía cualquier mensaje a tu bot, pega el token del bot en la herramienta de arriba y pulsa Buscar chat ID. La tabla muestra el chat_id; en un chat privado con el bot coincide con tu ID de usuario.
¿Por qué la herramienta no encuentra ningún chat?
No hay actualizaciones sin confirmar: nadie le escribió al bot en las últimas 24 horas, o tu bot en ejecución ya las confirmó con offset. Si hay un webhook configurado, getUpdates devuelve 409 Conflict; la herramienta ofrece eliminar el webhook.
¿La herramienta le quita actualizaciones a mi bot?
No. getUpdates se llama sin offset, así que Telegram no marca las actualizaciones como confirmadas y tu bot las sigue recibiendo.
¿Por qué el ID de un grupo o canal empieza con -100?
Los supergrupos y canales tienen IDs como -1001234567890, los grupos básicos tienen IDs negativos y los usuarios, positivos. Pasa siempre el número completo, incluidos el signo menos y el -100.
¿Es seguro pegar aquí el token de mi bot?
El token se queda en el localStorage de tu navegador y solo se envía a api.telegram.org, no a nuestro servidor. Si alguna vez se filtra un token, revócalo con /revoke en @BotFather.
Otras utilidades
Escapador de MarkdownV2 y HTMLValidador de initData de Mini AppVerificador de webhookBot API Tester