Инструкция администратора

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

Вход и навигация

Откройте личный диалог с ботом и отправьте /start.
Откройте /admin или «⚙️ Админ панель».
Используйте разделы «Розыгрыши», «Победители», «Участники», «Пользователи», «Рассылки», «Статистика» и «Настройки».
/cancel отменяет текущий ввод. После отмены откройте нужный раздел заново. Уже сохранённые операции эта команда не отменяет.

Эта инструкция доступна по /admin_help и кнопке «Инструкция администратора». Инструкция по кассовым операциям — /cashier_help.

Работа с пользователями

Попросите клиента выполнить /start, затем пройти «Регистрация»: указать данные, которые запрашивает бот. Карта вводится цифрами; допустимы и три, и четыре цифры, ведущие нули сохраняются. Если карта заранее привязана к этому же клиенту, он может завершить регистрацию с ней. При ошибке номера или телефона можно повторить ввод на текущем шаге.
Откройте «Пользователи» и найдите клиента по точному Telegram ID, клубной карте или username. При нескольких совпадениях сверяйте профиль и карту.
Проверьте регистрацию, клубную карту, связанные счета и участия. Введённая пользователем карта сама по себе не доказывает право владения: сверяйте её по принятой в вашей организации процедуре.
Для привязки счёта используйте /add_account КАРТА СЧЁТ, например /add_account 2223 11-22-33-44-55-66-77. Затем выберите розыгрыш, если нужно добавить участие.
Для деактивации ошибочного счёта: /remove_account 11-22-33-44-55-66-77. Если счёт уже включён в открытый розыгрыш, отдельно проверьте и исправьте участие в разделе «Участники».

Карту, телефон и код получения приза обсуждайте в личном диалоге с клиентом. Общий чат распространяет сообщения другим участникам.

Подготовка розыгрыша

«Розыгрыши» → «Создать».
Введите название, описание (или - для пропуска) и призы, каждый с новой строки. Порядок призов соответствует местам.
Проверьте итоговый экран и нажмите «Создать».
В «Список всех» откройте карточку, запишите ID розыгрыша и передайте его кассирам вместе с правилами участия.
До начала проведения исправьте название, описание или призы через «Редактировать».

Созданный розыгрыш принимает участников. Завершённый розыгрыш не принимает новые участия.

Добавление и проверка участников

«Участники» → «Добавить»: выберите розыгрыш и введите Telegram ID или username согласно подсказке.
«Участники» → «Массовые операции» → «Добавление по счетам»: выберите розыгрыш и передайте номера в формате 11-22-33-44-55-66-77.
Кассир добавляет счета через /cashier только в формате КАРТА СЧЁТ; карта обязательна в каждой строке. Все сотрудники работают с общей базой, каждый ведёт собственный диалог ввода.
Перед проведением проверьте «По розыгрышам» / «Отчёт»: состав, количество участников, отсутствие ошибочно добавленных счетов.
Ошибочное участие удаляйте через «Удалить» либо соответствующую массовую операцию до проведения розыгрыша. Повторное добавление того же счёта в один розыгрыш не создаёт второй билет.

Для быстрого добавления отправьте в личный диалог КАРТА СЧЁТ, например 0007 11-22-33-44-55-66-77, затем «Добавить в розыгрыш» и нужный розыгрыш. Если карта известна боту, новый счёт будет привязан к клиенту одновременно с добавлением участия. Ведущие нули карты сохраняются. Если счёт уже принадлежит другому клиенту или деактивирован, бот откажет в добавлении. Повторное добавление покажет пропуск без создания второго билета.

Бот поддерживает участие по пользователю и по счёту. Используйте способ, соответствующий опубликованным правилам. Счёт без указания карты может участвовать без связанного профиля; в этом случае автоматическое личное уведомление владельцу невозможно до установления связи.

Для восстановления связи ранее добавленного счёта в открытом розыгрыше отправьте его повторно с правильной картой. Бот привяжет существующее участие без создания второго билета. Перепривязка участия другого владельца отклоняется. Через кассу добавление без карты запрещено.

Проведение и выдача призов

Проверьте призы, состав участников и выбранный розыгрыш. Если использовались ручные назначения победителей, проверьте их до запуска: они учитываются при проведении.
«Розыгрыши» → «Провести розыгрыш» → нужный розыгрыш. Выполняйте подтверждения, показанные ботом.
Проверьте сохранённый результат в «Победители» → «Список победителей». Проведение закрывает розыгрыш для новых участников.
Передайте кассиру ID розыгрыша. Статус выдачи: /winner_status ID, подтверждение по личному коду клиента: /verify_winner КОД ID.
При сетевой ошибке сначала проверьте сохранённый результат или статус выдачи. Повторный запуск не должен использоваться для «исправления» недоставленного уведомления.

«Завершить» закрывает розыгрыш; «Удалить» удаляет его данные. Не используйте удаление для архивирования результатов. Ручные изменения и повторные розыгрыши применяйте только по правилам вашего мероприятия.

Рассылки и чат

«Рассылки» → выберите отправку в личные сообщения либо настроенный канал/группу.
Отправьте готовое сообщение. После отправки текста/медиа рассылка запускается сразу.
Во время рассылки можно открыть /admin и продолжить работу. Одновременно выполняются до двух рассылок, по одной от администратора.
Дождитесь отчёта с количеством доставленных и недоставленных сообщений. Недоступный получатель не останавливает остальных. Долгое ожидание Telegram или ошибка сообщения учитываются как неудачная доставка.
Если рассылка прервана, часть получателей уже могла получить сообщение. Проверьте журнал и результат перед повтором. После перезапуска бота незавершённые фоновые рассылки автоматически не возобновляются.

Премиум-эмодзи и форматирование сохраняются при копировании исходного сообщения в пределах возможностей Telegram. Ошибка отдельного эмодзи не помечает пользователя как заблокировавшего бот.

/chat включает общий чат, /exit выходит из него. Для модерации используйте административные разделы сообщений и чата. Не отправляйте служебные коды и данные клиентов в общий чат.

Если действие не сработало

«Недостаточно прав»: обратитесь к системному администратору; кассиру административная панель недоступна.
Бот ждёт другой ввод: /cancel, затем нужная команда.
Нет активного розыгрыша: проверьте статус и ID в «Список всех».
Нет ответа: проверьте /start; сообщите системному администратору время, действие и ID розыгрыша. Не повторяйте выдачу приза, пока не проверен /winner_status.

12 KiB Raw Blame History Unescape Escape