Telegram Bot API

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

· 7 хв читання

Токен бота Телеграм видає @BotFather: для нового бота він приходить одразу після команди /newbot, а в наявного його можна подивитися в меню /mybots → бот → API Token. Це рядок вигляду 123456789:AAEexampleTokenReplaceWithYours, який слугує боту і логіном, і паролем до Bot API. Нижче — як отримати токен, де знайти його у вже створеного бота, як перевірити через getMe, що робити в разі витоку і як безпечно передавати токен у n8n та ШІ-асистенти.

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

Токен — унікальний ключ, який Telegram видає кожному боту під час створення. Приклад з офіційної документації: 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11. Він складається з двох частин:

Токен передається просто в адресі запиту, одразу після слова bot: https://api.telegram.org/bot<token>/getMe. Окремих прав у токена немає — він дає повний доступ до бота: хто знає токен, той отримує вхідні повідомлення, пише від імені бота й змінює його налаштування. Не плутайте його з api_id і api_hash — це облікові дані для застосунків на MTProto API, а не для ботів.

Як отримати токен бота в @BotFather

  1. Відкрийте @BotFather і надішліть /newbot.
  2. Введіть ім'я бота — його бачать користувачі, згодом його можна змінити.
  3. Введіть username: 5–32 символи, латиниця, цифри й підкреслення, закінчення bot (наприклад, shop_helper_bot).
  4. У відповідь BotFather надішле посилання на бота й токен. Скопіюйте його повністю, без пробілів і переносів рядка.

Докладно про створення бота, перші запити й команди — у гайді як створити бота в Телеграм.

Де знайти токен уже створеного бота

  1. Надішліть @BotFather команду /mybots.
  2. Виберіть бота зі списку.
  3. Натисніть 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: отже, хтось інший уже перенаправив апдейти бота до себе.

  1. Надішліть @BotFather /revoke і виберіть бота. Інший шлях — /mybots → бот → API Token → Revoke current token.
  2. BotFather видасть новий токен, старий одразу перестане працювати.
  3. Оновіть токен усюди: змінні середовища на сервері, секрети CI/CD, облікові дані в n8n та інших сервісах.
  4. Перезапустіть бота й перевірте getWebhookInfo. Якщо адреса вебхука не ваша, встановіть свою знову через setWebhook.

Видалити токен з історії git теж корисно, але це не заміна відкликанню: усе, що хоч раз було опубліковано, вважайте таким, що витекло.

Як зберігати токен бота

# .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.

Типові помилки з токеном

ПомилкаПричинаЩо робити
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.