Токен бота Telegram: як отримати, де знайти, як перевірити й відкликати
Токен бота Телеграм видає @BotFather: для нового бота він приходить одразу після команди /newbot, а в наявного його можна подивитися в меню /mybots → бот → API Token. Це рядок вигляду 123456789:AAEexampleTokenReplaceWithYours, який слугує боту і логіном, і паролем до Bot API. Нижче — як отримати токен, де знайти його у вже створеного бота, як перевірити через getMe, що робити в разі витоку і як безпечно передавати токен у n8n та ШІ-асистенти.
Що таке токен бота і який він має вигляд
Токен — унікальний ключ, який Telegram видає кожному боту під час створення. Приклад з офіційної документації: 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11. Він складається з двох частин:
- до двокрапки — числовий id бота, той самий, що повертає
getMeу поліid. Це не секрет, але й не chat id: не підставляйте це число вchat_id; - після двокрапки — секретна частина з латинських літер, цифр,
_і-.
Токен передається просто в адресі запиту, одразу після слова bot: https://api.telegram.org/bot<token>/getMe. Окремих прав у токена немає — він дає повний доступ до бота: хто знає токен, той отримує вхідні повідомлення, пише від імені бота й змінює його налаштування. Не плутайте його з api_id і api_hash — це облікові дані для застосунків на MTProto API, а не для ботів.
Як отримати токен бота в @BotFather
- Відкрийте @BotFather і надішліть
/newbot. - Введіть ім'я бота — його бачать користувачі, згодом його можна змінити.
- Введіть username: 5–32 символи, латиниця, цифри й підкреслення, закінчення
bot(наприклад,shop_helper_bot). - У відповідь BotFather надішле посилання на бота й токен. Скопіюйте його повністю, без пробілів і переносів рядка.
Докладно про створення бота, перші запити й команди — у гайді як створити бота в Телеграм.
Де знайти токен уже створеного бота
- Надішліть @BotFather команду
/mybots. - Виберіть бота зі списку.
- Натисніть API Token — BotFather покаже поточний токен.
Не використовуйте для цього команду /token: вона не показує поточний токен, а генерує новий. Вона доречна, коли старий токен втрачено або скомпрометовано, і після неї токен доведеться оновити всюди, де працює бот.
BotFather показує лише ботів, створених із вашого акаунта. Якщо бота робив підрядник чи колега, попросіть передати його вам: /mybots → бот → Transfer ownership. Передати бота можна лише користувачеві, який хоча б раз із ним спілкувався.
Як перевірити токен бота через getMe
getMe — найпростіший спосіб перевірити токен: метод без параметрів повертає інформацію про бота.
curl -s "https://api.telegram.org/bot123456789:AAEexampleTokenReplaceWithYours/getMe"
Робочий токен (відповідь скорочено):
{
"ok": true,
"result": {
"id": 123456789,
"is_bot": true,
"first_name": "Помічник магазину",
"username": "shop_helper_bot",
"can_join_groups": true,
"can_read_all_group_messages": false,
"supports_inline_queries": false
}
}
Звірте username та id: так легко переконатися, що токен від потрібного бота, а не від тестового. Неправильний або відкликаний токен:
{"ok": false, "error_code": 401, "description": "Unauthorized"}
Помилка 401 Unauthorized майже завжди означає одне з трьох: під час копіювання загубився символ або додався пробіл, токен уже перевипущено через /revoke чи /token, або це токен бота з тестового середовища Telegram — такі боти працюють лише з адресою вигляду https://api.telegram.org/bot<token>/test/METHOD_NAME. Якщо ж приходить 404 Not Found, неправильна сама адреса: наприклад, перед токеном немає слова bot.
Перевірка в коді, наприклад перед запуском бота:
import os
import requests
token = os.environ["BOT_TOKEN"].strip()
data = requests.get(f"https://api.telegram.org/bot{token}/getMe", timeout=10).json()
if data["ok"]:
print("Токен робочий, бот @" + data["result"]["username"])
else:
print("Помилка", data["error_code"], data["description"])const token = process.env.BOT_TOKEN.trim();
const data = await (await fetch(`https://api.telegram.org/bot${token}/getMe`,
{ signal: AbortSignal.timeout(10_000) })).json();
if (data.ok) {
console.log("Токен робочий, бот @" + data.result.username);
} else {
console.log("Помилка", data.error_code, data.description);
}Якщо токен вводять користувачі, наприклад у формі вашого сервісу, відсіюйте явні помилки ще до запиту до API. Регулярний вираз перевіряє лише формат — чи робочий токен, скаже тільки getMe:
const looksLikeToken = (value) => /^\d+:[A-Za-z0-9_-]+$/.test(value.trim());
looksLikeToken('123456789:AAEexampleTokenReplaceWithYours'); // true
looksLikeToken('bot123456789:AAEexampleTokenReplaceWithYours'); // false: префікс bot потрібен лише в URL
Без термінала: відкрийте getMe у Bot API Tester, вставте токен і натисніть Ctrl+Enter. Токен зберігається лише в localStorage вашого браузера, запити йдуть напряму на api.telegram.org.
Як відкликати токен, якщо він витік
Вважайте токен скомпрометованим, якщо він потрапив до публічного репозиторію, чату, на скриншот, у лог або в клієнтський код. Ще одна тривожна ознака — getWebhookInfo показує чужу адресу в полі url: отже, хтось інший уже перенаправив апдейти бота до себе.
- Надішліть @BotFather
/revokeі виберіть бота. Інший шлях —/mybots→ бот → API Token → Revoke current token. - BotFather видасть новий токен, старий одразу перестане працювати.
- Оновіть токен усюди: змінні середовища на сервері, секрети CI/CD, облікові дані в n8n та інших сервісах.
- Перезапустіть бота й перевірте
getWebhookInfo. Якщо адреса вебхука не ваша, встановіть свою знову черезsetWebhook.
Видалити токен з історії git теж корисно, але це не заміна відкликанню: усе, що хоч раз було опубліковано, вважайте таким, що витекло.
Як зберігати токен бота
- Лише на сервері. Ніколи не вбудовуйте токен у фронтенд, мобільний застосунок чи розширення браузера — звідти його легко дістати.
- У змінних середовища, а не в коді. Файл
.envдодайте до.gitignoreще до першого коміту. - Не логуйте URL запитів. Токен входить в адресу, тому легко опиняється в логах HTTP-клієнта й текстах винятків.
- Різні боти для розробки й продакшену. Для експериментів заведіть окремого тестового бота з власним токеном.
# .env — цей файл не повинен потрапити до репозиторію
BOT_TOKEN=123456789:AAEexampleTokenReplaceWithYours
// Node.js 20.6+: node --env-file=.env bot.js
const token = process.env.BOT_TOKEN;
if (!token) throw new Error('Не задано змінну середовища BOT_TOKEN');
Токен бота для n8n і ШІ-асистентів
Сервіси автоматизації на кшталт n8n (Telegram node) і ШІ-асистенти, що підключаються до Telegram (наприклад, OpenClaw), майже завжди просять два значення: токен бота і chat id. Токен дає сервісу право діяти від імені бота, а chat id каже, куди писати: у ваш особистий чат, групу чи канал. Як дізнатися chat id, докладно розібрано в гайді як дізнатися chat id у Telegram.
- Створіть для кожної інтеграції окремого бота: у разі витоку ви відкличете один токен, а не зламаєте все одразу.
- Перевірте токен через
getMe, перш ніж вставляти його в сервіс, — так ви одразу відрізните друкарську помилку від проблем на боці інтеграції. - Один токен — один отримувач апдейтів. Якщо сервіс приймає апдейти через вебхук, а ваш скрипт із тим самим токеном викликає
getUpdates, скрипт отримає409 Conflict. Докладніше — у гайді вебхук для телеграм-бота.
Типові помилки з токеном
| Помилка | Причина | Що робити |
|---|---|---|
401 Unauthorized | Друкарська помилка, зайвий пробіл, відкликаний токен | Скопіюйте токен знову з /mybots → бот → API Token і перевірте через getMe |
404 Not Found | Неправильна адреса: немає bot перед токеном або помилка в назві методу | Складіть адресу за шаблоном https://api.telegram.org/bot<token>/getMe |
409 Conflict | Встановлено вебхук або токен використовують два процеси | Залиште один екземпляр бота або викличте deleteWebhook |
400 Bad Request: chat not found під час перевірки пари токен + chat id | Токен від іншого бота: цей бот не є учасником чату, або користувач його не запускав | Звірте username у відповіді getMe і напишіть потрібному боту або додайте його в чат |
| Бот працював і раптом почав отримувати 401 | Токен перевипустили через /revoke або /token | Візьміть актуальний токен у /mybots і оновіть його в усіх сервісах |
Поширені запитання
Де взяти токен бота Телеграм?
У @BotFather: для нового бота токен приходить після команди /newbot, для вже створеного — відкрийте /mybots, виберіть бота й натисніть API Token.
Чи показує команда /token поточний токен?
Ні. /token генерує новий токен — вона потрібна, якщо старий втрачено або скомпрометовано. Щоб подивитися поточний токен, використовуйте /mybots → бот → API Token.
Як перевірити, чи робочий токен бота?
Викличте https://api.telegram.org/bot<token>/getMe. Відповідь "ok": true з даними бота означає, що токен робочий, а 401 Unauthorized — що він неправильний або відкликаний.
Що може зробити людина, яка має токен бота?
Усе, що може сам бот: отримувати вхідні повідомлення, писати від його імені, змінювати вебхук, команди й опис. Тому в разі витоку токен треба негайно відкликати.
Чи можна повернути токен після відкликання?
Ні. Після /revoke старий токен перестає працювати назавжди, і всі програми та сервіси треба перевести на новий.
Навіщо n8n і ШІ-асистентам токен і chat id?
Токен дає сервісу право діяти від імені бота, а chat id вказує, у який чат писати. Для кожної інтеграції краще створити окремого бота, щоб у разі витоку відкликати лише його токен.
Читайте також
Як створити бота в Телеграм: від @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.
Вебхук для телеграм-бота: налаштування setWebhook, перевірка та видалення
Як налаштувати вебхук телеграм-бота: вимоги до HTTPS і портів, setWebhook із secret_token, перевірка через getWebhookInfo, видалення та типові помилки.
Як дізнатися chat id у Телеграм: користувач, група, канал і тема форуму
Як дізнатися chat id у Телеграм через getUpdates: особистий чат, група, супергрупа, канал і тема форуму. Формати id з -100 і що робити з порожнім result.
Тестовий сервер 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.