Полное руководство по Telegram-ботам: настройка бота магазина, бота обменника и системного админ-бота.
1. Обзор системы ботов
На маркете работают три типа Telegram-ботов:
- Бот магазина — полноценный интерактивный бот для покупателей: каталог, покупки, пополнение, регистрация
- Бот обменника — бот для уведомлений владельца обменника о заявках
- Админ-бот — системный бот для уведомления администрации о важных событиях
2. Бот магазина — настройка
Создание бота
- Откройте Telegram и найдите @BotFather
- Отправьте команду /newbot
- Введите имя бота (отображаемое название)
- Введите username бота (должен оканчиваться на «bot»)
- BotFather выдаст токен — скопируйте его
Подключение к магазину
- Перейдите в управление магазином → «Настройки»
- В разделе «Telegram-бот» вставьте токен в поле
- Нажмите «Добавить бота»
- Система проверит токен через Telegram API
- Если токен верный — бот появится в списке с зелёным индикатором
- Бот сразу начнёт работать (long-polling)
Можно подключить несколько ботов к одному магазину. Каждый бот можно включить/выключить или удалить.
Добавление получателей уведомлений
Ниже списка ботов — раздел «Получатели уведомлений»:
- Введите Telegram ID пользователя (число, можно узнать через @userinfobot)
- Укажите описание (необязательно, например: «Владелец», «Менеджер»)
- Нажмите «Добавить»
Для каждого получателя можно:
- 🔔 Включить / выключить уведомления (кнопка колокольчика)
- 🗑 Удалить получателя
Бонус: если Telegram ID получателя совпадает с владельцем — бот автоматически пропускает капчу при команде /start.
3. Команды бота магазина
Покупатели взаимодействуют с ботом магазина через следующие команды:
Основные команды:
/start — Начало работы с ботом (капча при первом запуске) /catalog — Каталог товаров магазина /account — Информация об аккаунте или вход /balance — Баланс крипто-кошельков /register — Регистрация нового аккаунта /info — Информация о магазине /exchange — Пополнение с банковской карты /complaint — Открыть жалобу (перенаправляет на сайт)
Что может покупатель через бота:
Каталог и покупки:
- Просмотр категорий и товаров с фото
- Выбор варианта (город, количество, цена)
- Выбор криптовалюты для оплаты (BTC, LTC, XMR, USDT)
- Проверка баланса и оплата
- Получение содержимого заказа (адрес, фото) прямо в бот
Кошелёк:
- Просмотр баланса по всем 4 криптовалютам
- Получение адреса для пополнения
- Пополнение с карты через обменник
Аккаунт:
- Регистрация нового аккаунта (логин → имя → пароль → правила)
- Вход в существующий аккаунт (логин + пароль)
- Просмотр количества завершённых заказов
Обмен (пополнение картой):
- Выбор обменника из списка (с рейтингом и количеством сделок)
- Выбор криптовалюты
- Ввод суммы в фиате
- Подтверждение и оплата по реквизитам
- Отмена заказа
Информация:
- Описание магазина, рейтинг, количество сделок
- Пользовательские страницы магазина (если настроены)
- Правила площадки
- Ссылки на clearnet и onion версии
Капча
При первом обращении к боту покупатель проходит капчу:
- Математический пример или символы с картинки (зависит от настроек)
- Капча действительна 24 часа
- Владельцы (Telegram-получатели) проходят без капчи
4. Уведомления владельцу магазина
Все получатели с включёнными уведомлениями получают сообщения о следующих событиях:
Событие │ Содержание ─────────────────────────────┼────────────────────────────── Новая продажа │ ID заказа, товар, сумма, крипта Холд снят (заказ завершён) │ ID заказа, сумма, крипта Новая жалоба │ ID жалобы, ID заказа Сообщение в жалобе │ ID жалобы Жалоба решена │ ID жалобы, вердикт, комментарий
Уведомления приходят в формате HTML и отправляются через бот магазина.
5. Бот обменника
Бот обменника работает только для уведомлений — у него нет интерактивных команд для клиентов.
Настройка
Аналогично боту магазина:
- Создайте бота через @BotFather
- В управлении обменником → «Настройки» → вставьте токен
- Добавьте получателей уведомлений (Telegram ID + описание)
Уведомления владельцу обменника
Событие │ Содержание ─────────────────────────────┼────────────────────────────── Новая заявка на обмен │ ID заказа, сумма в фиате, сумма в крипте Обмен завершён │ ID заказа, сумма крипты Новая жалоба │ ID жалобы, ID обмена Сообщение в жалобе │ ID жалобы Жалоба решена │ ID жалобы, вердикт, комментарий
6. Уведомления покупателям
Покупатели, которые пользуются ботом магазина, также получают уведомления:
- Новая переписка — когда магазин начинает переписку с покупателем (приходит название магазина и ссылки)
- Заявка истекла — если покупатель не успел оплатить обмен в течение окна оплаты (30 минут)
7. Системный админ-бот
Админ-бот — единый бот для всей платформы, который уведомляет администрацию о важных событиях. Настраивается администратором в системных настройках.
Привязка аккаунта к админ-боту
- В профиле администратора на маркете сгенерируйте код привязки
- Код действует 5 минут
- Откройте админ-бота в Telegram
- Отправьте команду /start КОД
- Бот подтвердит привязку: «Аккаунт {имя} успешно привязан\!»
Привязать аккаунт могут только пользователи с ролями: администратор, главный модератор, модератор, главный арбитр.
Уведомления админ-бота
Каждое уведомление отправляется определённым ролям:
Событие │ Кому уходит │ Содержание ───────────────────────┼────────────────────────────────────┼───────────────────────── Новая жалоба │ Админ, гл.мод, мод, гл.арбитр │ ID, тип, автор, магазин Арбитр назначен │ Админ, гл.арбитр │ ID жалобы, имя арбитра Эскалация жалобы │ Админ, гл.арбитр │ ID жалобы Жалоба решена │ Админ, гл.мод, гл.арбитр │ ID, вердикт, комментарий Новый абьюз-репорт │ Админ, гл.мод, мод │ ID, автор, цель, описание Новая подписка │ Админ, гл.мод, мод │ Тип, название, план, юзер Баг-репорт │ Админ │ Заголовок, автор
Зачем это нужно:
- Оперативное реагирование на жалобы — модераторы и арбитры сразу видят новые кейсы
- Контроль подписок — админы знают о новых магазинах/обменниках, ожидающих модерации
- Мониторинг абьюзов — быстрое выявление нарушителей
- Отслеживание арбитража — главный арбитр видит назначения и эскалации
8. Рассылка (broadcast) для магазинов
Владелец магазина может отправить массовое сообщение всем пользователям, которые взаимодействовали с ботом:
- Перейдите в «Настройки» → «Telegram-бот»
- В разделе рассылки введите текст сообщения
- Нажмите «Отправить»
- Система покажет количество доставленных сообщений
Примечание: рассылка может быть платной — информация о стоимости отображается в форме (если настроено администрацией).
9. Сравнение ботов
Возможность │ Бот магазина │ Бот обменника │ Админ-бот ─────────────────────────┼─────────────┼───────────────┼────────── Интерактивные команды │ ✓ │ ✗ │ ✗ Каталог и покупки │ ✓ │ ✗ │ ✗ Регистрация/вход │ ✓ │ ✗ │ ✗ Пополнение баланса │ ✓ │ ✗ │ ✗ Обмен с карты │ ✓ │ ✗ │ ✗ Уведомления владельцу │ ✓ │ ✓ │ ✗ Уведомления покупателю │ ✓ │ ✗ │ ✗ Уведомления админам │ ✗ │ ✗ │ ✓ Рассылка │ ✓ │ ✗ │ ✗ Привязка по коду │ ✗ │ ✗ │ ✓ Несколько экземпляров │ ✓ │ ✓ │ ✗
По всем вопросам обращайтесь к администрации маркета.
