Telegram Bot API українською: інструменти, документація, гайди
Тут зібрано безкоштовні інструменти для розробників Telegram-ботів: тестер усіх 194 методів Bot API 10.5, Swagger-документація у форматі OpenAPI 3.1 і тестер Mini Apps. Усе працює просто в браузері — токен залишається у вас, а запити йдуть напряму на api.telegram.org. Практичні гайди українською допоможуть створити бота, налаштувати вебхук, зробити HTML-віджет і не впертися в ліміти.
Гайди з Telegram Bot API
Покрокові інструкції з готовим кодом на curl, Python і JavaScript: від створення бота в @BotFather до вебхуків, віджетів, лімітів і новинок Bot API 10.5.
Як створити бота в Телеграм: від @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, видалення та типові помилки.
Як дізнатися 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.
Інструменти
Bot API Tester
Усі 194 методи Bot API 10.5 з формами параметрів, long polling для getUpdates з історією апдейтів і перегляд JSON, що згортається. Перевірте токен через getMe за кілька секунд.
Swagger / OpenAPI
Специфікація OpenAPI 3.1 для всіх 194 методів у 20 групах: типи параметрів, обов'язкові поля, посилання на офіційну документацію та запити через Try it out.
Mini App Tester
Перевірка Telegram.WebApp API у звичайному браузері в mock-режимі або всередині Telegram: кнопки, попапи, CloudStorage, сенсори, біометрія та лог понад 45 подій.
Поширені запитання про Telegram Bot API
Що таке Telegram Bot API?
HTTP-інтерфейс, через який ваша програма керує ботом Telegram. Кожен метод викликається запитом до https://api.telegram.org/bot<token>/METHOD_NAME, а відповідь надходить у JSON із полем ok.
З чого почати розробку Telegram-бота?
Створіть бота в @BotFather і отримайте токен, перевірте його методом getMe, напишіть боту й дайте відповідь через sendMessage. Усе це можна зробити за кілька хвилин просто в Bot API Tester.
Чи потрібен сервер, щоб почати працювати з Bot API?
Для перших експериментів — ні: запити можна надсилати з термінала через curl або з браузера. Сервер знадобиться, коли бот має працювати цілодобово або приймати апдейти через вебхук.
Як бот отримує повідомлення користувачів?
Двома способами, що взаємно виключають один одного: бот сам забирає апдейти методом getUpdates (long polling), або Telegram надсилає їх на вашу HTTPS-адресу через вебхук. Недоставлені апдейти зберігаються до 24 годин.
Чи платний Telegram Bot API?
Ні, Bot API безкоштовний. Платними бувають лише окремі можливості, наприклад платні розсилки швидше за 30 повідомлень на секунду за Telegram Stars.