К основному содержанию
T TON Adoption
EN
← Словарь
NODE/03 · Term

Telegram Bot API

HTTP-API Telegram для разработчиков ботов и mini-apps. Позволяет получать сообщения, отправлять ответы, управлять кнопками, запускать веб-приложения и интегрировать TON-платежи через TON Connect или Telegram Stars.

Синонимы: bot api, telegram bot api, тг бот api

Telegram Bot API — официальный HTTP-интерфейс Telegram для разработки ботов и мини-приложений. Через него бот получает сообщения от пользователей и отправляет ответы; этот же API даёт хуки для запуска mini-apps, управления интерфейсом, обработки платежей.

Что доступно

Базовый набор:

  • Сообщения. Получение входящих, отправка исходящих, редактирование, удаление.
  • Кнопки. Inline-keyboard под сообщением, reply-keyboard в чате, callback-queries.
  • Mini-apps. Кнопки запуска WebApp с передачей пользовательского initData.
  • Webhooks или long-polling. Бот может либо «вебхукать» на свой сервер, либо опрашивать API.
  • Платежи. Проведение Telegram-нативных платежей через провайдеров (Stripe, ЮKassa) и Telegram Stars.
  • Файлы. Загрузка / скачивание файлов до 50 МБ через сам Bot API, до 2 ГБ через MTProto.

Связь с TON

Bot API сам по себе не работает с TON напрямую — это HTTP-интерфейс Telegram. Но именно через него реализуются все TON-mini-apps:

  1. Бот регистрирует mini-app через setMenuButton / setMainMenuButton.
  2. Пользователь жмёт кнопку, открывается WebView mini-app.
  3. Mini-app внутри использует TON Connect SDK для работы с кошельком — это уже не Bot API, а отдельный стандарт.
  4. Платёж в Stars — через Bot API. Платёж в TON — через TON Connect.

То есть Bot API — это «оболочка» в Telegram, через которую TON-приложения становятся доступными миллионам пользователей.

Архитектурная роль для TON

Без Bot API не было бы Notcoin, Hamster Kombat, Catizen и десятков других массовых TON-проектов. Mini-app — это и есть запуск веб-приложения через Bot API, и уже внутри mini-app начинается «настоящая» TON-логика.

Ограничения

  • Rate limits — бот не может слать сообщения чаще определённой частоты (около 30/сек на чат, выше для каналов).
  • No spam. Telegram банит ботов за рассылку. Это ограничивает «маркетинговые» сценарии.
  • Privacy mode. В групповых чатах бот по умолчанию не видит сообщения, не адресованные ему напрямую — нужно явно отключать privacy mode.
  • Не вся функциональность. Полный доступ ко всем фичам Telegram даёт MTProto API (через TDLib), но это другая, существенно сложнее интеграция, не для большинства сценариев.

Документация

Официальный референс: core.telegram.org/bots/api. Поддерживаемые методы — десятки, регулярно расширяются с каждым релизом Telegram. Для mini-apps документация на core.telegram.org/bots/webapps.

См. также