Cómo obtener el chat id de Telegram: usuarios, grupos, canales y temas

Actualizado: 29 de octubre de 2026 · 6 min de lectura

El chat id es el número que identifica un chat en la Bot API: es lo que pasas en el parámetro chat_id para enviar mensajes. Para obtener el chat id en Telegram, escríbele a tu bot, llama a getUpdates y lee message.chat.id en la respuesta. Abajo verás cómo hacerlo para usuarios, grupos, canales y temas de foro.

Qué es el chat_id y qué formatos tiene

El -100 forma parte del id: cópialo completo, con el signo menos. Guarda los ids como enteros de 64 bits, porque pueden superar los 32 bits. Y no confundas el chat id con el número del inicio del token: ese es el id del bot.

Si un grupo básico se convierte en supergrupo, su id cambia. La API te avisa con el error Bad Request: group chat was upgraded to a supergroup chat y el id nuevo en parameters.migrate_to_chat_id.

Método 1: obtener tu chat id con getUpdates

1. Abre el chat con tu bot y pulsa Iniciar o envíale cualquier mensaje. Si aún no tienes bot, primero crea uno con BotFather.
2. Llama a getUpdates con tu token: abre la URL en el navegador, usa curl o ejecuta getUpdates en Bot API Tester, que muestra el JSON de forma navegable.
3. Busca el objeto chat dentro de message y copia su id.

curl "https://api.telegram.org/bot123456789:AAEexampleTokenReplaceWithYours/getUpdates"

{
  "ok": true,
  "result": [{
    "update_id": 850000001,
    "message": {
      "message_id": 1,
      "from": {"id": 123456789, "is_bot": false, "first_name": "Ana"},
      "chat": {"id": 123456789, "first_name": "Ana", "type": "private"},
      "date": 1793232000,
      "text": "/start"
    }
  }]
}

En un chat privado, chat.id coincide con el id del usuario (from.id). Este script en Python lista todos los chats que aparecen en las actualizaciones, incluidos grupos y canales:

import requests

TOKEN = "123456789:AAEexampleTokenReplaceWithYours"
data = requests.get(f"https://api.telegram.org/bot{TOKEN}/getUpdates", timeout=10).json()

for upd in data["result"]:
    item = upd.get("message") or upd.get("channel_post") or upd.get("my_chat_member")
    if item:
        chat = item["chat"]
        print(chat["id"], chat["type"], chat.get("title") or chat.get("first_name"))

Cómo obtener el chat id de un grupo

1. Añade el bot al grupo.
2. Envía en el grupo /start@tu_bot, con el username de tu bot. Con el modo de privacidad, activo por defecto, el bot solo recibe en grupos los comandos dirigidos a él, las respuestas a sus mensajes y los mensajes de servicio.
3. Llama a getUpdates y busca un chat con "type": "group" o "supergroup". Su id es negativo.

Al añadir el bot también llega una actualización my_chat_member con el mismo chat.id, así que a veces el id aparece incluso antes de enviar el comando. Si necesitas que el bot lea todos los mensajes del grupo, desactiva la privacidad con /setprivacy en @BotFather (y vuelve a añadirlo al grupo) o hazlo administrador.

Chat id de un canal

• Canal público: puedes usar directamente @nombredelcanal como chat_id.
• Canal privado: añade el bot como administrador con permiso para publicar, publica algo en el canal y llama a getUpdates. El id está en channel_post.chat.id y empieza por -100.

{
  "update_id": 850000002,
  "channel_post": {
    "message_id": 7,
    "chat": {"id": -1001234567890, "title": "Avisos", "type": "channel"},
    "date": 1793232000,
    "text": "Hola, canal"
  }
}

Temas de un foro: message_thread_id

En los supergrupos con temas, todos los temas comparten el mismo chat.id; lo que cambia es message_thread_id. Escribe algo dentro del tema, léelo en message.message_thread_id y pásalo junto con el chat_id:

{"chat_id": -1001234567890, "message_thread_id": 42, "text": "Aviso para este tema"}

Problemas: result vacío, 409 Conflict y chat not found

• "result": []: no hay actualizaciones nuevas. Envía otro mensaje al bot. Telegram guarda las actualizaciones como máximo 24 horas, y las que ya se confirmaron con offset (por ejemplo, porque tu bot o una librería ya está corriendo) no vuelven a aparecer.
• En el grupo no aparece nada: el modo de privacidad filtró el mensaje. Usa un comando con @tu_bot.
• 409 Conflict: el bot tiene un webhook activo (n8n y muchas plataformas lo configuran solas) y getUpdates no funciona mientras exista. Revísalo con getWebhookInfo. Si lo eliminas con deleteWebhook, la integración que lo usaba dejará de recibir mensajes hasta que lo vuelvas a configurar; más detalles en la guía de webhook.
• 400 Bad Request: chat not found al enviar: el id es incorrecto (¿falta el -100?), el bot no está en ese grupo o canal, o el usuario nunca inició el bot.

Dónde vas a usar el chat id

El chat id es el destino de cualquier notificación automática: alertas de un servidor, avisos de una tienda en línea, flujos de n8n o asistentes de IA como OpenClaw que te escriben por Telegram. Casi siempre te pedirán el par token + chat id: el token lo consigues con la guía del token del bot, y para probar el envío usa sendMessage paso a paso.