Бот Albert

Перед использованием

Первичные администраторы задаются в ALLOWED_TELEGRAM_IDS. Затем любой администратор бота может добавлять и удалять других администраторов командами /add_admin и /remove_admin.

Команды

/add_admin — добавляет администратора бота. В личном чате нужно выбрать пользователя кнопкой Telegram, в группе — отправить команду ответом на его сообщение.
/remove_admin или /delete_admin — удаляет администратора тем же способом. Seed-администраторов из конфигурации удалить через бота нельзя.
/init_support — регистрирует текущий чат как разрешённый для открытия диспутов и ролевых рассылок.
/enable_autodispute — включает автооткрытие диспутов в текущем саппорт-чате.
/disable_autodispute — выключает автооткрытие диспутов в текущем чате.
/init_wl — добавляет текущий чат в локальный список WL-рассылки.
/init <trader_id> — сохраняет текущий Telegram chat ID для трейдера с указанным ID на площадке.
/dispute <order_id> [причина] — открывает диспут по внешнему или внутреннему ID заявки.
- Бот сначала ищет внешний order_id; если он не найден, пробует внутренний ID.
- Backend отправляет трейдеру основную нотификацию о диспуте и inline-кнопки.
- Если команда содержит фото, видео, документ или другое поддерживаемое Telegram-медиа либо отправлена ответом на такое сообщение, бот отдельно пересылает чек трейдеру с подписью Order ID, UUID и ID, без кнопок.
- Без приложенного медиа бот ничего дополнительно трейдеру не отправляет.
/document <order_id> — находит заявку и пересылает приложенное медиа в чат трейдера.
/message_traders <сообщение> — отправляет сообщение всем трейдерам с привязанным telegram_chat_id.
/message_merchants <сообщение> — отправляет сообщение всем мерчантам с привязанным telegram_chat_id.
/message_wl <сообщение> — отправляет сообщение во все чаты, зарегистрированные через /init_wl.

Автодиспуты

Администратор сначала регистрирует чат через /init_support, затем включает режим командой /enable_autodispute. После этого бот автоматически находит UUID в обычных сообщениях и подписях к медиа, пробует открыть диспут сначала как по внешнему, затем как по внутреннему ID и останавливается после первого успешного UUID. Команда /dispute повторно автодиспутом не обрабатывается.

Если сообщение содержит медиа, после открытия диспута бот пересылает его трейдеру. /disable_autodispute отключает режим для текущего чата.

Backend отправляет основную нотификацию о диспуте в привязанный чат трейдера, а бот обрабатывает кнопки под ней:

✅ Подтвердить — завершает заявку со статусом SUCCESS;
❌ Отменить — отменяет заявку; доступно только администраторам бота;
🎥 Запрос видео и 📋 Запрос выписки — отправляют запрос мерчанту, не более двух раз каждый;
✉️ Запросить чек на почту и 🪓 Разделение платежа — отправляют запрос мерчанту один раз;
💬 Написать мерчанту — запускает переписку: сообщение уходит мерчанту, а его ответ возвращается трейдеру.

Для запросов и переписки у мерчанта и трейдера должны быть привязаны Telegram-чаты. Ответ на текстовый запрос нужно отправить reply-сообщением в течение 15 минут.

Рассылки

/message_wl <сообщение> рассылает текст во все чаты, добавленные командой /init_wl. Регистрация саппорт-чата для этой рассылки не требуется.
/message_traders <сообщение> и /message_merchants <сообщение> получают с backend чаты соответствующей роли. Их можно запускать только из чата, зарегистрированного через /init_support.

Все команды рассылки доступны только администраторам. После отправки бот показывает количество успешных доставок и ошибок.

Быстрая настройка

Чат с трейдером

/init@bot 10

Здесь 10 — ID трейдера на площадке. После привязки в этот чат будут приходить уведомления и чеки по диспутам.

Чат споров

/init_support@bot
/enable_autodispute@bot
/dispute@bot order123 Причина диспута

В /dispute можно передать внешний или внутренний ID. Чтобы переслать чек, приложите медиа к команде или ответьте командой на сообщение с медиа.

WL-рассылка

/init_wl@bot
/message_wl@bot Текст сообщения

Настройки

BOT_TOKEN — токен бота от @BotFather.
ADMIN_TOKEN — Bearer-токен для API.
API_BASE_URL — базовый URL API, например https://api.example.com.
ALLOWED_TELEGRAM_IDS — Telegram ID администраторов и модераторов через запятую.
DATABASE_URL — строка подключения к PostgreSQL для хранения разрешённых саппорт-чатов.
DB_USER, DB_PASSWORD, DB_NAME — параметры PostgreSQL, если DATABASE_URL формируется через Docker Compose.

Ошибки

❌ Не получилось открыть диспут… — заявка не найдена либо backend отклонил запрос.
Диспут открыт, но чек не отправлен — диспут уже открыт, но бот не смог определить UUID или чат трейдера либо Telegram не принял медиа.

Надеюсь, что данная инструкция помогла вам найти ответы на все ваши вопросы. Инструкция будет дополняться, если вы не нашли ответа на интересующий вас вопрос, обратитесь к Администратору

Всем желаю удачного запуска и стабильной работы 🤗