Як дізнатися chat id у Телеграм: користувач, група, канал і тема форуму
Щоб дізнатися chat id у Телеграм, напишіть будь-що своєму боту й викличте метод getUpdates: ідентифікатор чату міститься в полі message.chat.id. З групою те саме, тільки бота спершу треба додати в чат, а в каналі — зробити адміністратором. Нижче — покроково для особистого чату, групи, супергрупи, каналу й теми форуму, а також що робити, якщо getUpdates повертає порожній result або 409 Conflict.
Що таке chat id і який він має вигляд
chat_id — унікальний ідентифікатор чату, обов'язковий параметр sendMessage і майже всіх методів надсилання. За знаком і префіксом одразу видно тип чату:
| Чат | chat.type | Приклад id |
|---|---|---|
| Особистий чат із користувачем | private | 123456789 — додатний, збігається з id користувача |
| Звичайна група | group | -987654321 — від'ємний |
| Супергрупа, зокрема форум | supergroup | -1001234567890 |
| Канал | channel | -1009876543210 |
- Мінус і префікс
-100— частина id. Якщо їх відрізати, API відповість400 Bad Request: chat not found. - Id буває довшим за 32 біти: зберігайте його в BIGINT або int64.
- Для публічних каналів і супергруп замість числа можна передати
@username. Для користувачів так не можна — лише числовий id. - Число до двокрапки в токені — це id самого бота, а не ваш chat id.
Як дізнатися chat id телеграм-бота в особистому чаті
- Відкрийте свого бота й натисніть «Почати» або надішліть будь-яке повідомлення.
- Викличте
getUpdates— через curl або в Bot API Tester на методі getUpdates. - Знайдіть у відповіді
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 групи
- Додайте бота в групу як звичайного учасника. Якщо бот не знаходиться або не додається, перевірте
/setjoingroupsв @BotFather. - Надішліть у групі команду з username бота:
/start@your_bot. - Викличте
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", ...}
Приватний канал.
- Додайте бота до адміністраторів каналу.
- Опублікуйте в каналі будь-який пост.
- Викличте
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": []} — запит пройшов, але нових апдейтів немає. Причини:
- боту нічого не писали після останньої перевірки — у групі пам'ятайте про privacy mode і пишіть команду з
@username; - повідомленню понад 24 години — Telegram зберігає апдейти не довше доби;
- апдейти вже забрав інший процес із тим самим токеном — ваш запущений бот, n8n або старий скрипт підтвердив їх через
offset. Зупиніть його або шукайте chat id у його логах.
Помилка 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
- Сповіщення зі скриптів, CI/CD і моніторингу: один виклик
sendMessageз вашим chat id. - n8n та інші сервіси автоматизації: щоб надіслати повідомлення, потрібен chat id чату або каналу.
- ШІ-асистенти, підключені до Telegram (наприклад, OpenClaw), зазвичай просять токен бота й 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.