Токен бота Telegram: як отримати, знайти й уберегти

Коротко. Токен бота Telegram видає @BotFather: надішліть /newbot, виберіть ім’я та юзернейм, що закінчується на bot, — і токен прийде: 110201543:AAHdq…. Загубили? /mybots → ваш бот → API Token. Витік? Відкличте його там само, і старий перестане працювати. Перевірити будь-який токен можна методом getMe — або в безкоштовній перевірці токена, яка заодно покаже chat ID чатів вашого бота. І для Bot API більше нічого не треба: api_id / api_hash з my.telegram.org — для застосунків, які працюють із Telegram через MTProto.

Токен — єдине, що просить кожна інтеграція з ботом Telegram, від скрипта на п’ять рядків до сервісу автоматизації чи ШІ-агента. Отримати його — справа хвилини; більшість клопоту починається потім: знайти його знову, відрізнити від інших облікових даних Telegram і знати, що робити того дня, коли він опиниться там, де не мав би.

Покроково: як отримати токен у BotFather

1. Відкрийте @BotFather — власного бота Telegram для створення ботів і керування ними — і натисніть «Почати».
2. Надішліть /newbot.
3. Надішліть ім’я, яке показуватиметься людям. Його видно в чатах і контактах, і його можна змінити пізніше.
4. Надішліть юзернейм. Він має закінчуватися на bot (tetris_bot, TetrisBot), мати 5–32 символи — латинські літери, цифри й підкреслення, — і — на відміну від імені — змінити його пізніше не вийде. Швидко дізнатися, чи ім’я вільне, можна в перевірці юзернейму.
5. BotFather відповідає токеном.

Токен виглядає так: 110201543:AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw — цифри, двокрапка, а далі довгий ряд літер, цифр, дефісів і підкреслень. Кожен запит до Bot API несе його в адресі, після слова bot: https://api.telegram.org/bot<token>/getMe.

Ще в BotFather є Mini App, який робить усе це кнопками замість команд, — результат той самий, токен той самий.

Як знайти токен бота, який у вас уже є

Надішліть /mybots у @BotFather, виберіть бота й відкрийте API Token. Це єдине місце, де Telegram його показує: ні в профілі бота, ні в чаті з ним, ні в налаштуваннях Telegram його немає. Якщо ви створили бота давно й не пам’ятаєте, якому акаунту він належить, — це той акаунт, у чиєму чаті з BotFather бот з’являється в /mybots.

Як перевірити, що токен працює

У Bot API є метод, створений саме для цього: getMe, «простий метод для перевірки токена автентифікації вашого бота». Коли токен правильний, він відповідає ім’ям, юзернеймом та ID бота. Викликати його можна двома способами:

• відкрити https://api.telegram.org/bot<token>/getMe у браузері, підставивши свій токен замість <token>;
• вставити токен у перевірку токена бота, яка надсилає той самий запит прямо з вашого браузера на api.telegram.org, а потім читає нещодавні оновлення бота й показує кожен чат із його chat ID.

Що означають відповіді:

Що відповідає Telegram	Що це означає
ім’я, юзернейм та ID бота	токен працює
Unauthorized (401)	у токені помилка, або його відкликали й замінили в BotFather
Not Found (404)	в адресі взагалі немає токена — бракує двокрапки або слова bot перед ним

Токен витік: відкличте його зараз

Хто має токен, той керує ботом: читає, що йому надсилають, пише від його імені, змінює його налаштування. Посібник Telegram каже поводитися з токеном як із паролем і нагадує, що його будь-коли можна відкликати через @BotFather.

Якщо токен опинився в публічному репозиторії, на скриншоті, у спільному документі чи в чаті, якому ви не довіряєте, відкличте його: @BotFather → /mybots → ваш бот → API Token. Бот отримає новий токен, а старий перестане працювати — усе, що працювало на старому токені, відключиться, зокрема й ваш власний код, тож одразу після цього вставте новий токен туди, де працює ваш бот.

А де тримати його від самого початку? Посібник Telegram радить файл налаштувань або змінні середовища, а не сам код. Кодом діляться, його форкають і вставляють у запитання; зі змінною середовища на сервері такого не стається.

Токен — це не API ID і не hash

Поширена плутанина: my.telegram.org видає api_id і api_hash у розділі «API development tools». Вони ідентифікують застосунок, який працює з Telegram через MTProto API, — здебільшого власні клієнти, що входять як акаунт користувача, а також MTProto-бібліотеки для ботів і власний сервер Bot API: їм ці значення потрібні на додачу до токена. Звичайний Bot API на api.telegram.org — те, чим користується більшість сервісів для ботів і автоматизацій, — приймає токен від BotFather і більше нічого.

Чи треба взагалі копіювати токен?

Не завжди. Telegram дозволяє одному боту створювати інших і керувати ними — це керовані боти (managed bots): застосунок надсилає вам посилання, Telegram показує вікно з ім’ям і юзернеймом нового бота, ви підтверджуєте, і застосунок отримує токен бота від самого Telegram. Токен ніколи не потрапляє у ваш буфер обміну, тож нема чого вставляти й нема чому витекти. Так AdminHub підключає бота каналу — посібник зі створення бота для каналу показує обидва шляхи, а створення бота без програмування розповідає, що запустити за ним.

Що робити з токеном далі

Більшість інтеграцій просить два значення: токен і chat ID — куди бот має публікувати. Посібник про chat ID охоплює всі види чатів; перевірка токена знаходить ID чатів, з якими ваш бот уже спілкується.

---

Джерела, перевірено в жовтні 2026 року: довідник Telegram Bot API — розділ про авторизацію бота (формат токена й адреса запиту), метод getMe; можливості ботів — BotFather (/newbot, правила юзернейму, генерація нового токена, Mini App BotFather), керовані боти; посібник для розробників ботів — відкликання токена, поводження з ним як із паролем, зберігання поза кодом; отримання api_id — для чого потрібні api_id та api_hash.