Боты и продажи
Telegram-бот-магазин: каталог, оплата, выдача и CRM
Бот-магазин должен провести покупателя от выбора до понятного результата заказа. Каталог и кнопка оплаты — часть процесса. До разработки определите источник цены и наличия, способ подтверждения платежа, выдачу или доставку и действия команды при ошибке.
Опубликовано
Статус заказа должен соответствовать факту
| Этап | Что подтверждает результат | Что видит команда |
|---|---|---|
| Заказ создан | Состав и идентификатор сохранены | Заказ ожидает следующего действия |
| Оплата подтверждена | Получено корректное событие платёжной платформы | Платёж связан с нужным заказом |
| Выдача или доставка | Проверено предусмотренное действие исполнения | Результат либо причина остановки |
| Ошибка или возврат | Выполнен согласованный сценарий и сохранён результат | Ответственный и история действий |
Каталог: один источник цены и доступности
Определите, кто меняет товары, варианты и условия покупки. Если каталог ведётся в учётной системе, бот должен получать согласованные сведения оттуда. Перед оплатой нужно повторно проверить состав заказа и возможность исполнения. Отдельно договоритесь, что происходит при изменении цены, отсутствии товара или недоступности источника данных.
- Название, вариант, количество и цена относятся к конкретному заказу.
- Клиент видит итог до перехода к оплате.
- Недоступный товар не превращается в оплаченный заказ, который некому выполнить.
Цифровые и физические товары: разные правила платежей
По актуальной документации Telegram цифровые товары и услуги, продаваемые внутри Telegram, оплачиваются через Telegram Stars с валютой XTR. Для физических товаров и услуг предусмотрен отдельный путь через платёжных провайдеров. Сначала определите тип предложения, затем выбирайте интеграцию. Платёжную схему из старого учебного проекта нельзя автоматически считать подходящей для нового магазина.
Создание заказа и подтверждение оплаты — разные события
Сохраняйте заказ с идентификатором и понятным статусом до оплаты. Для продажи цифрового предложения Telegram отдельно указывает: выдача должна следовать после события successful_payment; подтверждение pre_checkout_query само по себе не означает успешный платёж. Свяжите платёж с заказом и предусмотрите повторное событие. Сотрудник должен видеть, что оплачено, что выдано и что требует разбора.
Выдача, доставка и поддержка после покупки
Для цифрового товара согласуйте, что получает покупатель: файл, доступ или другое предусмотренное действие. Для физического — данные доставки, наличие и ответственного. Отдельно определите, как найти покупку при обращении в поддержку и что делать при ошибке выдачи. Возврат и повторная выдача должны иметь согласованный порядок и отражаться в системе заказа; наличие кнопки оплаты не решает эти вопросы автоматически.
Учебный пример: платёж прошёл, выдача не завершилась
Заказ подтверждён платёжной системой, но внешняя система выдачи временно недоступна. Правильный результат для проверки — сохранить связь платежа с заказом, показать клиенту фактический статус и передать операцию ответственному на восстановление. Повтор не должен списать деньги ещё раз или создать независимый второй заказ. Это учебная ситуация для приёмки, а не описание проекта CRUX с опубликованными показателями.
Что проверить перед запуском магазина
Проверяйте весь путь в предусмотренном тестовом окружении платёжной платформы, затем согласуйте условия рабочего запуска. Результат операции должен совпадать у покупателя, команды и в CRM.
- Изменение каталога между выбором и оплатой.
- Отказ, отмена или незавершённая оплата.
- Повторное событие платежа и повторное нажатие клиента.
- Оплата при недоступной выдаче или CRM.
- Поиск заказа и платежа по обращению в поддержку.
- Проверка предусмотренного сценария возврата и повторного доступа.
Как использовать внешний учебный магазин
В туториале Amvera на Хабре разобраны каталог, администрирование и оплата в Python-боте. Это полезный пример декомпозиции проекта, но его исходники и платёжные решения относятся к конкретному времени и задаче автора. В нашей оценке фиксируются ваши товары, правила платформы, системы учёта и критерии готовности. Бюджет включает согласованную разработку; размещение, платные сервисы и сопровождение обсуждаются отдельно.
Источники
Правила цифровых и физических платежей сверены с официальной документацией Telegram 26 октября 2026 года. Таблица статусов, учебная ошибка выдачи и критерии приёмки подготовлены CRUX. Внешний туториал не является реализованным нами магазином; совместимость и состав подключения подтверждаются отдельно.