Telegram Bot API бесплатно: короткий ответ
Да. Во введении в ботов Telegram пишет, что платформа ботов бесплатна и для пользователей, и для разработчиков, а в FAQ по ботам уточняет: по умолчанию бот может писать своим пользователям без оплаты. Ключ API покупать не нужно, а тарифов или цены за запрос в документации нет.
Деньги могут понадобиться в двух случаях:
- Платная рассылка, если она вам нужна. Бот, которому надо отправлять массовые сообщения быстрее примерно 30 в секунду, может включить платные рассылки и платить 0,1 Telegram Stars за каждое сообщение сверх бесплатного объёма.
- Всё, что вокруг API. Код должен где-то работать, обычно рядом с базой данных и часто со сторонними сервисами. Эти счета выставляют другие компании, а не Telegram.
Все цифры ниже взяты из документации Telegram на момент написания статьи. Telegram предупреждает, что лимиты могут измениться, поэтому перед расчётами сверьтесь с FAQ по ботам и справочником Bot API.
Что входит бесплатно
Бесплатно не только отправлять текст. По документации, цены нет ни у одного из этих пунктов:
- Создание бота. Вы пишете @BotFather, регистрируете бота и получаете токен. Бот — особый аккаунт, которому не нужен номер телефона.
- Отправка сообщений. В личные чаты, группы и каналы, в пределах лимитов из следующего раздела.
- Получение обновлений. Способов два, long polling и вебхуки, и ни один не тарифицируется.
- Файлы. Отправка и скачивание фото, видео и документов в пределах ограничений по размеру.
- Платёжная платформа. Telegram называет Bot Payments бесплатной и открытой платформой для приёма платежей от пользователей.
- Сам сервер Bot API. Его исходный код опубликован, и можно запустить собственную копию.
Одно ограничение с деньгами не связано: бот не может начать диалог первым. Человек должен сам написать боту или добавить его в группу, поэтому бот пишет только тем, кто им уже пользуется.
Лимиты Telegram Bot API
Бесплатно не значит без ограничений. Вот лимиты, в которые растущий бот упирается раньше всего.
| Лимит | Значение | Страница-источник |
|---|---|---|
| Сообщения в один чат | Не чаще одного в секунду; короткие всплески могут пройти | Bots FAQ |
| Сообщения в группу | Не больше 20 в минуту | Bots FAQ |
| Массовые уведомления | Около 30 сообщений в секунду | Bots FAQ, Bot API |
| Скачивание файла | До 20 МБ | Bots FAQ, Bot API |
| Загрузка нового файла | 10 МБ для фото, 50 МБ для остальных файлов | Bot API |
| Отправка файла по ссылке | 5 МБ для фото, 20 МБ для остального | Bot API |
| Повторная отправка по file_id | Без ограничений | Bot API |
Значения приведены по документации Telegram на момент написания.
Если бот превышает лимит отправки, API начинает отвечать ошибкой 429. Для массовых уведомлений в FAQ есть бесплатный выход: растянуть рассылку на более долгий срок, например на 8–12 часов.
Для планирования: при скорости около 30 сообщений в секунду уведомление для 100 000 человек займёт 100 000 ÷ 30 ≈ 3 333 секунды, чуть меньше часа.
Платная рассылка в Telegram: за что берёт деньги сам Telegram
Единственная цена за отправку сообщений в документации Bot API относится к платным рассылкам. По умолчанию любой бот может рассылать до 30 сообщений в секунду. Разработчик может включить Paid Broadcasts в @BotFather, и тогда бот сможет рассылать до 1000 сообщений в секунду.
- Цена: каждое сообщение сверх бесплатных 30 в секунду стоит 0,1 Telegram Stars, они списываются с баланса бота.
- Как это включается в коде: методы отправки принимают параметр allow_paid_broadcast. Значение True разрешает до 1000 сообщений в секунду за эту плату.
- За что списывают: только за сообщения, которые успешно отправлены.
Требования на двух страницах расходятся. На момент написания в справочнике Bot API сказано, что на балансе бота должно быть не меньше 10 000 Stars. В FAQ по ботам — не меньше 100 000 Stars на балансе и не меньше 100 000 активных пользователей в месяц. Актуальное условие проверьте в @BotFather, прежде чем на него рассчитывать.
Пример расчёта
Это пример с круглыми числами, а не прайс. Допустим, 200 000 сообщений рассылки ушли сверх бесплатной скорости: 200 000 × 0,1 = 20 000 Stars. Та же рассылка на бесплатной скорости не стоит ничего, но идёт дольше.
В доллары мы Stars здесь не переводим: на странице Telegram о платежах в Stars сказано, что суммы различаются от пользователя к пользователю из-за НДС и других сборов.
Локальный сервер Bot API: большие файлы
Ограничения на файлы выше действуют для официального сервера api.telegram.org. Telegram публикует исходный код сервера Bot API: его можно запустить у себя и слать запросы на свою копию. В документации два варианта сравниваются так:
| Параметр | Официальный сервер | Локальный сервер |
|---|---|---|
| Максимальный размер скачиваемого файла | 20 МБ | Без ограничений |
| Максимальный размер загружаемого файла | 50 МБ | 2000 МБ |
| Адрес вебхука | HTTPS | HTTP |
| Порт вебхука | 443, 80, 88, 8443 | Любой |
| Максимум соединений вебхука | 1–100 | 1–100000 |
Платы за локальный сервер в документации нет, но работает он на вашем железе и увеличивает счёт за хостинг. Перед переключением запросов на него вызовите метод logOut.
Сколько стоит телеграм-бот в работе
На вопрос, сколько стоит телеграм-бот, отвечает не Telegram. В документации сказано, что бот подключён к серверу владельца, который обрабатывает действия и запросы пользователей. Этот сервер обеспечиваете вы.
- Хостинг. Бот должен отвечать в любое время. Руководство Telegram советует арендовать VPS или похожий сервис.
- База данных. Telegram не хранит за вас базу обновлений: обработанное обновление больше недоступно. Списки пользователей, настройки и историю хранит разработчик.
- Сторонние API. Языковые модели, распознавание речи, карты и подобные сервисы обычно берут плату за использование.
- Сертификат для вебхуков. Вебхукам нужен действующий SSL-сертификат; самоподписанный тоже подойдёт.
Цен мы не называем: они целиком зависят от выбранных провайдеров. Важна закономерность: пока бот маленький, расходы малы, и они растут с каждым активным пользователем, особенно когда каждый запрос обращается к платному внешнему сервису.
Как бот окупает себя
Telegram Stars и инструменты самого Telegram
Если бот продаёт цифровые товары или услуги, оплата должна идти в Telegram Stars, валюта в счёте — XTR. Пользователи получают Stars через встроенные покупки Apple и Google или через @PremiumBot. Кроме разовых продаж в документации названы платные фото и видео и платные подписки.
Полученные Stars бот может потратить на повышение лимитов сообщений, подарки пользователям, размещение в Telegram Ads или получить вознаграждение в Toncoin. Возвраты и платёжные споры разбирает владелец бота.
Реклама через рекламную сеть
Бот с бесплатным сервисом может вместо этого показывать рекламу. HiViews — рекламная сеть в Telegram-ботах, и владельцу бота она платит так:
- Приветственный показ: реклама приходит сразу после /start, до приветствия самого бота. $4,80 за 1000 показов.
- Обычный показ: бот запрашивает рекламу после того, как выдал свой результат, и она оказывается последним сообщением в чате. $2,40 за 1000 показов.
- Переходы: $0,04 за клик по объявлениям с оплатой за переходы.
- С токеном BotFather: один вызов API, рекламу отправляет сам HiViews, оплачиваются каждый показ и клики по ставкам выше.
- Без токена: бот сам запрашивает готовый пост и отправляет его. Оплачиваются клики и каждый показ, отправку которого подтвердил Telegram; ставка за показ ниже.
- Выплаты: заработок становится доступен к выводу через 7 дней, вывод от $50 в USDT (TRC20).
Пример, а не прогноз. Бот, подключённый с токеном, за месяц показал 10 000 приветственных и 20 000 обычных показов: 10 000 ÷ 1000 × $4,80 = $48 и 20 000 ÷ 1000 × $2,40 = $48, вместе $96. Реальные числа зависят от аудитории бота и от кампаний, которые идут в сети.
Подробности — в статьях Как монетизировать Telegram-бота и Сколько зарабатывает Telegram-бот. Если не хотите передавать токен, прочитайте про монетизацию бота без токена. Вызов API описан в документации.
Частые вопросы
Есть ли у Bot API платный тариф?
Нет. В документации Telegram описан один Bot API и сказано, что платформа ботов бесплатна для пользователей и разработчиков. Подписки или платы за запрос там нет. Единственная платная опция на страницах, которые мы читали, — платная рассылка, она поднимает лимит массовой отправки.
Нужно ли платить за каждое сообщение?
По умолчанию нет: бот пишет своим пользователям бесплатно, в пределах лимитов. Платить придётся, только если включить платные рассылки в @BotFather и отправлять с параметром allow_paid_broadcast. Тогда каждое сообщение сверх бесплатных 30 в секунду стоит 0,1 Telegram Stars с баланса бота, и списание идёт только за успешно отправленные сообщения.
Локальный сервер Bot API бесплатный?
Его исходный код открыт, и платы за использование в документации Telegram нет. Запускается он на вашей машине, так что платите вы за неё. Взамен бот скачивает файлы без ограничения размера и загружает файлы до 2000 МБ.
Нужен ли боту сервер?
Да. По документации Telegram, бот подключён к серверу владельца, который обрабатывает действия и запросы пользователей. Базу обновлений Telegram за вас тоже не хранит, поэтому списки пользователей и настройки лежат на вашей стороне.
Может ли бот зарабатывать?
Да. Бот может продавать цифровые товары, платные медиа и подписки за Telegram Stars, участвовать в разделе дохода от Telegram Ads или показывать рекламу через рекламную сеть. Дохода это не гарантирует: он зависит от того, сколько людей пользуется ботом и что он им даёт.