Telegram Bot API полная документация

источник ↗ ·

Официальная HTTP-интерфейсная документация Bot API Telegram с описанием методов, типов объектов, обновлений и всех доступных функций для создания ботов.

telegram bot-api http-api messaging webhook inline-mode payments rich-messages

privacy

Эта заметка участвует в semantic memory.

AI Summary

🚀 TL;DR Полная официальная документация Telegram Bot API: HTTP-интерфейс для создания ботов, поддержка getUpdates/webhooks, отправка сообщений/медиа, inline-режим, платежи, игры, rich messages (с июня 2026), guest mode, managed bots и многое другое.

📖 Что это такое HTTP-based интерфейс, созданный для разработчиков, желающих строить ботов для Telegram. Все запросы идут через HTTPS на https://api.telegram.org/bot/METHOD_NAME. Поддерживаются GET/POST, четыре способа передачи параметров (form-urlencoded, JSON, multipart/form-data). Ответ всегда JSON с полями ok, result/description, error_code.

🔑 Ключевые факты • Токен вида 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11. • Все методы регистронезависимы, кодировка UTF-8. • Локальный Bot API сервер (telegram-bot-api) позволяет: файлы до 2000 МБ, безлимитная загрузка, HTTP webhook, до 100000 подключений. • Обновления хранятся 24 часа. • Новые возможности 2026: Rich Messages (RichText*, RichBlock*, sendRichMessage, sendRichMessageDraft), guest mode (supports_guest_queries, answerGuestQuery), managed bots (can_manage_bots, KeyboardButtonRequestManagedBot), polls с 1 опцией, live photos, bot-to-bot communication, quizzes с несколькими правильными ответами. • Paid Broadcasts: до 1000 сообщ/сек за 0.1 Stars за сообщение (минимум 10 000 Stars). • Inline mode: до 50 результатов, поддержка 20 типов InlineQueryResult. • Payments: Stars (XTR), LabeledPrice, sendInvoice, answerPreCheckoutQuery и т.д. • Ограничения rich messages: 32768 символов, 500 блоков, 16 уровней вложенности, 50 медиа, 20 колонок в таблице.

⚙️ Как это работает / применить

  1. Создать бота через @BotFather → получить токен.
  2. Получать обновления:
    • Long polling: getUpdates (offset, limit, timeout, allowed_updates).
    • Webhook: setWebhook (url, certificate, secret_token, max_connections).
  3. Отправка:
    • Текст: sendMessage (parse_mode MarkdownV2/HTML, entities, link_preview_options).
    • Медиа: sendPhoto, sendDocument, sendMediaGroup и т.д. (file_id, URL или multipart).
    • Rich: sendRichMessage (markdown/html поля).
  4. Редактирование: editMessageText, editMessageMedia, editMessageReplyMarkup (в пределах 48 ч для бизнес-сообщений).
  5. Inline: answerInlineQuery (results, cache_time, is_personal, button).
  6. Платежи: sendInvoice → answerShippingQuery → answerPreCheckoutQuery.
  7. Локальный сервер: собрать telegram-bot-api, запустить, слать запросы на свой хост.

💡 Вывод и значение Единая, постоянно развивающаяся платформа для создания мощных ботов с поддержкой текста, медиа, платежей, игр, rich-форматирования и интеграции с Mini Apps. Документация содержит точные названия всех классов (Message, Update, InlineQueryResult*, RichBlock* и др.), параметров методов и ограничений.

Мои мысли

graph

Карта связей