Разработка Telegram-ботов и Mini Apps

Разница между ботом и Mini App не косметическая. Бот — это диалог: команды, кнопки, состояния. Он дёшев, быстр, работает на любом телефоне и не требует от клиента ничего, кроме уже установленного Telegram. Mini App — полноценное веб-приложение внутри мессенджера: свой интерфейс, каталог с фильтрами, корзина, карта, личный кабинет, — и всё это открывается без установки и без перехода на сторонний сайт.

Правило, которым мы пользуемся на первой встрече: если сценарий укладывается в семь-десять экранов кнопок — это бот. Если нужны фильтры по каталогу, календарь записи, карта или длинная форма — это Mini App. Чаще всего верна связка: бот отвечает за вход, уведомления и напоминания, Mini App — за витрину и оплату.

• Магазин: каталог, корзина, оплата, статусы заказа, уведомление курьеру
• Запись: клиники, барбершопы, автосервисы — календарь, слоты, напоминания
• Поддержка: первичная сортировка обращений и передача живому оператору
• Уведомления: новая заявка, лид, неудачный платёж, остаток на складе
• Внутренние боты: заявки в IT, согласования, отчёты, заказ пропуска
• Mini App-витрина с оплатой, не выходя из Telegram

Для физических товаров и услуг схема привычная: провайдер подключается в @BotFather, бот получает provider_token, счёт выставляется методом sendInvoice, деньги приходят на расчётный счёт мерчанта в сумах. Сам Telegram за Payments API комиссии не берёт — платите только провайдеру. Иногда мы осознанно выбираем другой путь: генерируем ссылку на checkout Payme или Click и отдаём её кнопкой. Это на один тап дольше, зато возвраты, сверки и рассрочка остаются в кабинете мерчанта, где бухгалтерия умеет с ними работать.

С цифровыми товарами правило принципиально другое, и о нём в Ташкенте узнают, как правило, уже после запуска. Начиная с Bot API 7.4 всё, что продаётся внутри бота как цифровое — доступ к курсу, подписка, платный контент, — проводится исключительно в Telegram Stars: валюта XTR, provider_token пустой. Payme и Click в этом сценарии не подключаются никак. Более того, если тот же курс продаётся у вас на сайте, Telegram требует, чтобы он продавался и за Stars — это прямое следствие правила App Store 3.1.3(b). Stars выводятся через Fragment, то есть у такой модели своя экономика и свой валютный риск. Это нужно закладывать в юнит-экономику до того, как написана первая строка кода, а не после.

Бот без интеграций — это красивая форма обратной связи, и через месяц ей перестают пользоваться. Ценность появляется, когда заказ из Telegram сам становится сделкой в CRM, документом в 1С и задачей у конкретного менеджера. Мы связываем пользователя Telegram с карточкой в системе через диплинк вида t.me/вашбот?start=payload — это надёжнее, чем просить человека вручную назвать номер заказа.

Одно ограничение стоит понять до подписания договора. Telegram не позволяет боту написать первым: пока человек не нажал Start или не открыл диплинк, chat_id просто не существует и отправлять уведомление некуда. Это значит, что задача «разошлём уведомления по нашей базе телефонов» невозможна в принципе — ни за какие деньги. Рабочая схема одна: собрать подписку в момент, когда клиент и так рядом — QR на чеке, кнопка на сайте, ссылка в SMS после оформления заказа.

• amoCRM и Bitrix24 — через webhooks и открытый API
• 1С — через HTTP-сервисы или OData
• Payme и Click — выставление счетов и статусы транзакций
• Google Sheets — когда CRM ещё нет, а порядок уже нужен
• IP-телефония на Asterisk и совместимых АТС
• Собственные учётные системы — по REST, если есть документация

Telegram жёстко ограничивает темп отправки: не больше одного сообщения в секунду в один чат, около 20 сообщений в минуту в группу и примерно 30 сообщений в секунду на всю рассылку целиком. Арифметика из этого следует простая и неприятная: база в 50 000 подписчиков при 30 сообщениях в секунду разойдётся примерно за 28 минут — и это в идеальном случае, без единого повтора. Поэтому рассылка у нас всегда очередь с приоритетами и корректной обработкой ответа 429, а не цикл по списку получателей. Если темп нужен выше, в @BotFather включаются платные рассылки — до 1000 сообщений в секунду, каждое сверх бесплатных тридцати стоит 0,1 Stars.

Остальные ограничения выглядят мелочами ровно до того момента, когда упираются в готовый сценарий. Мы проговариваем их на этапе проектирования, а не на этапе сдачи.

• Своё сообщение бот может удалить только в течение 48 часов — «отзыв» промо надо проектировать заранее
• В группе с включённым privacy mode бот видит лишь адресованные ему команды; отключение режима меняет и приватность, и нагрузку
• Webhook требует HTTPS и один из портов 443, 80, 88 или 8443 — на дешёвом shared-хостинге это обычно и есть блокер
• С 20 июля 2026 методы Mini App работают только с исходного домена приложения: переехать на другой origin без пересборки не выйдет
• Bot API обновляется несколько раз в год (10.0 — май, 10.1 — июнь, 10.2 — июль 2026), и библиотеки за ним поспевают не всегда

Мы пишем ботов на Python с aiogram 3 или на Node.js, данные держим в PostgreSQL, состояния диалогов и очереди рассылок — в Redis, всё упаковано в Docker и работает через webhook за nginx. Разворачиваем на вашем сервере или на нашей площадке — на выбор. Админ-панель делаем всегда, даже в небольших проектах: бот, в котором никто из сотрудников не может поменять текст, цену или расписание, умирает за месяц.

И есть вещь, которую в Ташкенте не предложит ни одна веб-студия. i7 Team занимается и разработкой, и инфраструктурой — сетями, СКУД, видеонаблюдением, POS. Поэтому бот у нас умеет разговаривать не только с CRM, но и с железом: открыть турникет сотруднику по кнопке, прислать кадр с камеры по тревоге, отдать сводку продаж прямо с кассовой системы. Обычно на таком стыке стоят два подрядчика и один спорный вопрос «чья это зона ответственности». Здесь подрядчик один.

• Репозиторий с исходниками и инструкцией по развёртыванию — вам
• Админ-панель для контента, цен, расписаний и рассылок
• Локализация ru / uz / en, выбор языка на /start
• Мониторинг ошибок webhook, очереди рассылок и ответов 429
• Передача владения ботом с проверкой доступов