Telegram Bot API

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

  1. 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.
  2. 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.
  3. Pulsa Buscar chat ID. La tabla lista cada chat con su nombre, tipo, chat_id y, para los temas del foro, el message_thread_id. Usa Copiar junto al ID.
  4. Para un canal o supergrupo público puedes saltarte las actualizaciones y escribir su @username en 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

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