Telegram Bot API

Як дізнатися chat id у Телеграм: користувач, група, канал і тема форуму

· 8 хв читання

Щоб дізнатися chat id у Телеграм, напишіть будь-що своєму боту й викличте метод getUpdates: ідентифікатор чату міститься в полі message.chat.id. З групою те саме, тільки бота спершу треба додати в чат, а в каналі — зробити адміністратором. Нижче — покроково для особистого чату, групи, супергрупи, каналу й теми форуму, а також що робити, якщо getUpdates повертає порожній result або 409 Conflict.

Що таке chat id і який він має вигляд

chat_id — унікальний ідентифікатор чату, обов'язковий параметр sendMessage і майже всіх методів надсилання. За знаком і префіксом одразу видно тип чату:

Чатchat.typeПриклад id
Особистий чат із користувачемprivate123456789 — додатний, збігається з id користувача
Звичайна групаgroup-987654321 — від'ємний
Супергрупа, зокрема форумsupergroup-1001234567890
Каналchannel-1009876543210

Як дізнатися chat id телеграм-бота в особистому чаті

  1. Відкрийте свого бота й натисніть «Почати» або надішліть будь-яке повідомлення.
  2. Викличте getUpdates — через curl або в Bot API Tester на методі getUpdates.
  3. Знайдіть у відповіді message.chat.id.
export BOT_TOKEN="123456789:AAEexampleTokenReplaceWithYours"

curl -s "https://api.telegram.org/bot$BOT_TOKEN/getUpdates"
{
  "ok": true,
  "result": [
    {
      "update_id": 851234567,
      "message": {
        "message_id": 15,
        "from": {"id": 123456789, "is_bot": false, "first_name": "Олена", "username": "olena_dev"},
        "chat": {"id": 123456789, "first_name": "Олена", "username": "olena_dev", "type": "private"},
        "date": 1793275200,
        "text": "привіт"
      }
    }
  ]
}

В особистому чаті chat.id збігається з from.id. Якщо апдейтів багато, зручніше одразу вивести список чатів. З утилітою jq це один рядок:

curl -s "https://api.telegram.org/bot$BOT_TOKEN/getUpdates" \
  | jq '.result[] | (.message // .channel_post // .my_chat_member // empty) | .chat | {id, type, title, username}'

Те саме на Python або JavaScript:

import os
import requests

token = os.environ["BOT_TOKEN"]
updates = requests.get(f"https://api.telegram.org/bot{token}/getUpdates", timeout=10).json()["result"]

for update in updates:
    item = update.get("message") or update.get("channel_post") or update.get("my_chat_member") or {}
    chat = item.get("chat")
    if chat:
        print(chat["id"], chat["type"], chat.get("title") or chat.get("first_name"))
const token = process.env.BOT_TOKEN;
const updates = (await (await fetch(`https://api.telegram.org/bot${token}/getUpdates`,
  { signal: AbortSignal.timeout(10_000) })).json()).result;

for (const update of updates) {
  const item = update.message || update.channel_post || update.my_chat_member || {};
  const chat = item.chat;
  if (chat) {
    console.log(chat.id, chat.type, chat.title || chat.first_name);
  }
}

Як дізнатися chat id групи

  1. Додайте бота в групу як звичайного учасника. Якщо бот не знаходиться або не додається, перевірте /setjoingroups в @BotFather.
  2. Надішліть у групі команду з username бота: /start@your_bot.
  3. Викличте getUpdates і візьміть message.chat.id — від'ємне число, а chat.title підкаже, чи це та група.

Чому саме команда з @username: за замовчуванням у ботів увімкнено privacy mode. У групі бот отримує лише адресовані йому команди (/command@your_bot), відповіді на свої повідомлення, повідомлення, надіслані через нього, і службові повідомлення. Звичайне «привіт» у групі до бота не дійде. Службові повідомлення приходять завжди, тому id часто видно одразу після додавання бота: в апдейті my_chat_member і в повідомленні з new_chat_members.

Чи ввімкнено privacy mode, видно у відповіді getMe: "can_read_all_group_messages": false означає, що ввімкнено. Щоб бот бачив усі повідомлення, зробіть його адміністратором групи або вимкніть режим командою /setprivacy — після цього бота треба видалити з групи й додати знову.

Група стала супергрупою. Telegram перетворює звичайну групу на супергрупу під час деяких змін налаштувань, наприклад коли вмикають теми. Id при цьому змінюється: бот отримає службове повідомлення з migrate_to_chat_id, а надсилання за старим id поверне помилку з новим id у parameters:

{
  "ok": false,
  "error_code": 400,
  "description": "Bad Request: group chat was upgraded to a supergroup chat",
  "parameters": {"migrate_to_chat_id": -1001234567890}
}

Chat id каналу: публічного й приватного

Публічний канал. Числовий id можна взагалі не шукати: у chat_id підходить @channelusername. Публікувати повідомлення бот однаково зможе, лише якщо він адміністратор каналу з правом публікації. Якщо для інтеграції потрібне саме число, викличте getChat:

curl -s "https://api.telegram.org/bot$BOT_TOKEN/getChat?chat_id=@my_channel"
# у відповіді: "result": {"id": -1001234567890, "title": "...", "type": "channel", ...}

Приватний канал.

  1. Додайте бота до адміністраторів каналу.
  2. Опублікуйте в каналі будь-який пост.
  3. Викличте getUpdates — прийде апдейт channel_post, id каналу в channel_post.chat.id.
{
  "update_id": 851234570,
  "channel_post": {
    "message_id": 7,
    "sender_chat": {"id": -1009876543210, "title": "Закритий канал", "type": "channel"},
    "chat": {"id": -1009876543210, "title": "Закритий канал", "type": "channel"},
    "date": 1793275500,
    "text": "Тестовий пост"
  }
}

Альтернатива — перешліть будь-який пост із каналу боту в особистий чат: в апдейті буде message.forward_origin з типом channel, а id каналу — у forward_origin.chat.id. Ще один спосіб: скопіюйте посилання на пост вигляду https://t.me/c/1234567890/15 і допишіть -100 перед числом після /c/ — вийде -1001234567890.

Теми форуму: message_thread_id

У супергрупі з темами ("is_forum": true) chat id один на весь форум, а конкретну тему задає message_thread_id. Щоб його дізнатися, надішліть у потрібній темі команду /start@your_bot і викличте getUpdates: у повідомлення будуть поля message_thread_id і "is_topic_message": true. Якщо тему створює сам бот методом createForumTopic, id прийде у відповіді в полі message_thread_id.

curl -s -X POST "https://api.telegram.org/bot$BOT_TOKEN/sendMessage" \
  -H "Content-Type: application/json" \
  -d '{"chat_id": -1001234567890, "message_thread_id": 42, "text": "Повідомлення в потрібну тему"}'

Порожній result і 409 Conflict: що робити

Відповідь {"ok": true, "result": []} — запит пройшов, але нових апдейтів немає. Причини:

Помилка 409 Conflict: can't use getUpdates method while webhook is active; use deleteWebhook to delete the webhook first — у бота встановлено вебхук, наприклад його поставив n8n або фреймворк. Поки вебхук активний, getUpdates не працює. Видаліть вебхук — без drop_pending_updates накопичені апдейти збережуться:

curl -s "https://api.telegram.org/bot$BOT_TOKEN/deleteWebhook"

Якщо бот у продакшені працює на вебхуку, після цього встановіть його знову. У Bot API Tester запуск long polling у панелі оновлень сам викликає deleteWebhook, а нові апдейти одразу з'являються в історії.

Помилка 409 Conflict: terminated by other getUpdates request — той самий токен одночасно опитують два процеси. Залиште один.

Де знадобиться chat id

curl -s "https://api.telegram.org/bot$BOT_TOKEN/sendMessage" \
  -d chat_id=123456789 \
  --data-urlencode "text=Деплой успішно завершено"

Токен для таких інтеграцій — у гайді як отримати токен бота, а форматування, кнопки й розбір помилок надсилання — у гайді як надіслати повідомлення через бота. Якщо бота ще не створено, почніть з інструкції як створити бота в Телеграм.

Поширені запитання

Чому chat id групи від'ємний?

Так Bot API відрізняє чати від користувачів: у користувачів id додатний, у звичайних груп — від'ємний, а в супергруп і каналів починається з -100. Мінус і -100 — частина id, передавайте число повністю.

Чи можна дізнатися chat id користувача за username?

Ні. @username у chat_id працює лише для публічних каналів і супергруп. Числовий id користувача бот дізнається, коли той сам йому пише: він приходить у message.from.id і message.chat.id.

Чому getUpdates повертає порожній result?

Нових апдейтів немає: боту нічого не писали, апдейти старші за 24 години видалено або їх уже забрав інший процес із тим самим токеном. Якщо встановлено вебхук, замість порожнього списку прийде 409 Conflict — спочатку викличте deleteWebhook.

Як дізнатися chat id приватного каналу?

Додайте бота в канал адміністратором, опублікуйте пост і викличте getUpdates: id буде в channel_post.chat.id і почнеться з -100. Інший спосіб — переслати пост із каналу боту й узяти forward_origin.chat.id.

Чи може chat id групи змінитися?

Так, коли звичайну групу перетворюють на супергрупу. Новий id вигляду -100… приходить у полі migrate_to_chat_id, а старий перестає працювати.

У якому типі даних зберігати chat id?

У 64-бітному цілому (BIGINT, int64). Id може займати понад 32 біти, але не більше 52 значущих, тому int32 не підходить, а int64 і double — підходять.

Як створити бота в Телеграм: від @BotFather до першого повідомлення

Як створити бота в Телеграм: реєстрація в @BotFather, токен, перевірка через getMe, перше повідомлення на curl і Python, команди та опис бота.

Що нового в Telegram Bot API 10.0–10.5: налаштування бота, віджети, rich-повідомлення, ефемерні повідомлення й гостьовий режим

Що нового в Telegram Bot API 10.0–10.5: setMySettings і BotFullInfo, HTML-віджети, rich- та ефемерні повідомлення, гостьовий режим — з прикладами.

Ліміти Telegram Bot API: повідомлення на секунду, помилка 429 і розміри файлів

Ліміти Telegram Bot API в одному місці: повідомлення на секунду, помилка 429 і retry_after, платні розсилки, розміри файлів, довжина тексту й підпису.

Як надіслати повідомлення через бота Telegram: sendMessage, розмітка й кнопки

Як надіслати повідомлення через бота телеграм: sendMessage на curl, Python і JavaScript, parse_mode HTML і MarkdownV2, кнопки та помилки 400, 403, 429.

Токен бота Telegram: як отримати, де знайти, як перевірити й відкликати

Токен бота Телеграм: як отримати його в @BotFather, де знайти токен наявного бота, як перевірити через getMe і що робити, якщо токен витік.

Вебхук для телеграм-бота: налаштування setWebhook, перевірка та видалення

Як налаштувати вебхук телеграм-бота: вимоги до HTTPS і портів, setWebhook із secret_token, перевірка через getWebhookInfo, видалення та типові помилки.

Тестовий сервер Telegram: як тестувати бота в тестовому середовищі

Тестовий сервер Telegram для ботів: вхід у тестове середовище, створення тестового бота, запити до Bot API через /test/ і перемикач TEST у тестері.

Віджети Telegram для сайту: вхід через Telegram, вбудовування постів, коментарі й кнопка «Поділитися»

Вхід через Telegram на сайті: новий Telegram Login (OIDC), старий Login Widget із перевіркою hash, вбудовування постів, коментарі та кнопка «Поділитися».

TelegramWidget JavaScript API: властивості, події, коди помилок і ліміти

Довідник TelegramWidget API: властивості, request(), події, коди помилок, CSS-змінні, widget_query та answerWidgetQuery, а також усі ліміти віджетів.

Приклади віджетів Telegram: готовий HTML і код бота на Python

Робочі приклади віджетів Telegram із повним кодом: картка замовлення, лічильник із запитами widget_query, спільне живе опитування та прев'ю в браузері.

Віджети Telegram: інтерактивний HTML просто в повідомленнях бота

Віджети Telegram у Bot API 10.4: що це, як працюють sendWidget, chat_data і public_data, де віджети доступні зараз і чим вони відрізняються від Mini Apps.

Тестування Telegram Mini App: від браузера до налагодження на телефоні

Тестування Telegram Mini App крок за кроком: mock-режим у браузері, HTTPS-тунель для localhost, тестове середовище, DevTools на телефоні та initData.