Telegram-бот для своих: как уйти от комиссий агрегаторов

Что вы получите от этого урока

Вы научитесь создавать Telegram‑бота, который будет принимать заказы и платежи напрямую от клиентов, обходя комиссии крупных агрегаторов (Яндекс Еда, Delivery Club и т.п.). После практики вы сможете:

• Спроектировать простую, но надёжную архитектуру бота.
• Подключить Telegram Payments API и настроить собственный платёжный шлюз.
• Автоматизировать процесс обработки заказов, уведомления кухни и расчётов с курьерами.
• Сэкономить от 10 % до 30 % прибыли, удерживая всё в своих руках.

1️⃣ Почему стоит «вывести» продажи из агрегаторов

Если вы уже собрали базу постоянных клиентов (например, через Instagram, сайт или личные рекомендации), переход к собственному каналу продаж даст вам полный контроль и сократит издержки.

2️⃣ Основы работы Telegram Bot API

Аналогия: BotFather – это ваш ключ от офиса, а webhook – почтовый ящик, куда приходят все «письма» от клиентов.

Минимальный набор запросов для бота‑магазина

POST https://api.telegram.org/bot<token>/setWebhook
POST https://api.telegram.org/bot<token>/sendMessage
POST https://api.telegram.org/bot<token>/sendInvoice
POST https://api.telegram.org/bot<token>/answerPreCheckoutQuery

3️⃣ Проектирование пользовательского сценария

1. Приветствие – «Добро пожаловать! Что хотите заказать?»
2. Выбор категории – кнопки «Суши», «Роллы», «Салаты».
3. Выбор продукта – карточка с фото, описанием, ценой, кнопка «В корзину».
4. Корзина – список выбранных позиций, кнопка «Оформить заказ».
5. Ввод данных – телефон, адрес (если доставка).
6. Платёж – отправка инвойса через sendInvoice.
7. Подтверждение – «Спасибо! Ваш заказ принят».

Трюк: используйте CallbackQuery вместо обычных сообщений, чтобы не «засорять» чат лишними текстами. Пользователь видит только нужные кнопки, а ваш сервер получает короткий JSON‑payload.

4️⃣ Подключение платёжного шлюза

Telegram поддерживает Stripe, PayPal, YooMoney, а также локальные процессоры (например, Qiwi, Tinkoff). Шаги:

Пример кода (Python + aiogram)

from aiogram import Bot, Dispatcher, types
from aiogram.utils import executor

TOKEN = "123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11"
bot = Bot(token=TOKEN)
dp = Dispatcher(bot)

@dp.message_handler(commands=['start'])
async def start(msg: types.Message):
    await msg.answer(
        "👋 Привет! Выберите категорию:",
        reply_markup=types.InlineKeyboardMarkup().add(
            types.InlineKeyboardButton("Роллы", callback_data="cat_rolls")
        )
    )

@dp.callback_query_handler(lambda c: c.data.startswith('cat_'))
async def show_products(cb: types.CallbackQuery):
    # здесь берём список роллов из БД
    await cb.message.edit_text(
        "🍣 Выберите ролл:",
        reply_markup=types.InlineKeyboardMarkup().add(
            types.InlineKeyboardButton("Калифорния – 350₽", callback_data="prod_california")
        )
    )

@dp.callback_query_handler(lambda c: c.data.startswith('prod_'))
async def add_to_cart(cb: types.CallbackQuery):
    # добавляем в сессию пользователя
    await cb.answer("✅ Добавлено в корзину", show_alert=False)

@dp.message_handler(commands=['checkout'])
async def checkout(msg: types.Message):
    await bot.send_invoice(
        chat_id=msg.chat.id,
        title="Ваш заказ",
        description="2 ролла Калифорния",
        payload="order_12345",
        provider_token="PROVIDER_TOKEN",
        currency="RUB",
        prices=[types.LabeledPrice("Роллы", 70000)]  # в копейках
    )

Важно: цены в LabeledPrice указываются в копейках (1 RUB = 10000).

5️⃣ Хранение и обработка данных

Рекомендация: используйте SQLite для прототипа, а при росте – PostgreSQL + Redis для кэша «корзины».

Транзакция: при получении successfulPayment откройте транзакцию, запишите оплату и сразу измените статус заказа на paid. Это исключит двойные списания.

6️⃣ Автоматизация уведомлений

Трюк: используйте sendPhoto с подписью, чтобы курьер видел фото готового блюда и мог быстро проверить правильность.

7️⃣ Защита от мошенничества

8️⃣ Аналитика и рост

Для простого дашборда достаточно Google Data Studio (подключаем к PostgreSQL) или Grafana с Prometheus‑метриками из вашего сервера.

9️⃣ Масштабирование

1. Веб‑hook вместо getUpdates – позволяет обрабатывать запросы в реальном времени.
2. Пул воркеров (Celery, RQ) – отложенные задачи: отправка писем, расчёт статистики.
3. Docker‑контейнеры – упрощают деплой на VPS или облако (DigitalOcean, Hetzner).
4. Load‑balancer – если планируется более 10 000 активных пользователей, распределяйте запросы между несколькими инстансами бота.

🔧 Практика для закрепления

1. Создайте бота в BotFather, получите токен и установите webhook на ваш локальный сервер (используйте ngrok).
2. Смоделируйте меню из трёх роллов, реализуйте кнопку «В корзину» и вывод текущей корзины.
3. Подключите платежи через тестовый provider_token Stripe. Сформируйте инвойс на 500 RUB и обработайте successfulPayment.
4. Запишите заказ в SQLite‑таблицу orders и отправьте уведомление в отдельный Telegram‑канал (создайте канал и добавьте бота администратором).
5. Проверьте безопасность: попытайтесь отправить два одинаковых successfulPayment с тем же payment_id. Убедитесь, что ваш код отклонит дублирование.

Ответьте на вопросы:

• Какие поля Invoice обязательны, а какие можно опустить?
• Какой механизм Telegram гарантирует, что пользователь действительно оплатил заказ?
• Как вы будете хранить «корзину», если пользователь закрывает чат и открывает его позже?

🎉 Итоги

• Вы построили полностью автономный канал продаж, избавившийся от комиссий агрегаторов.
• Понимаете, как связать Telegram Bot API, Payments API и базу данных.
• Готовы масштабировать решение и получать аналитические данные для роста бизнеса.

Продолжайте экспериментировать, добавляйте новые функции (рекомендации, бонусные баллы, интеграцию с CRM) и ваш Telegram‑бот станет главным драйвером продаж ваших роллов. Удачи!