Бот Klaus
Перед использованием
Заголовок раздела «Перед использованием»Klaus помогает открывать диспуты и проверять чеки в главном саппорт-чате перед передачей исполнителю. Также он поддерживает запросы мерчанту, переписку и рассылки. Для сценария с прямой пересылкой чека используйте инструкцию Albert.
Какой бот и какой режим доставки используются на вашей площадке, согласуйте с ответственным за запуск. При переходе на Klaus отдельно проверьте его администраторов, саппортов и рабочие чаты. Списки Albert и Klaus настраиваются в каждом боте отдельно.
| Доступ | За что отвечает |
|---|---|
| Администратор площадки | Управляет кабинетами и настройками Spyder. Права в кабинете описаны в матрице ролей. |
| Администратор Klaus | Настраивает бота и выполняет проверку чеков в главном чате. Первичных администраторов назначает ответственный за запуск, следующих можно добавить командой /add_admin. |
| Администратор Telegram-группы | Управляет самой группой. Для административных команд и проверки чеков его отдельно добавляют в администраторы Klaus. |
| Саппорт в списке Klaus | Получает упоминание при окончательной ошибке автоматического открытия диспута. Это назначение не выдаёт права администратора бота или роль в кабинете Spyder. |
Для работы боту нужен административный API-доступ к нужной площадке. Подключение настраивает ответственный за запуск; секретные токены в общий чат не отправляйте. Убедитесь, что Klaus может отправлять сообщения и файлы во все рабочие чаты.
Настройка рабочих чатов
Заголовок раздела «Настройка рабочих чатов»Команды настройки, управления администраторами и саппортами, а также рассылки выполняет администратор Klaus.
| Команда | Где выполнить и что проверить |
|---|---|
/init ID |
В рабочем чате мерчанта, трейдера или агрегатора. Возьмите ID нужного кабинета из Пользователи и дождитесь подтверждения привязки. Для запросов и переписки нужны привязки обеих сторон. Повторная команда заменяет прежний чат выбранного пользователя. |
/init_support |
В чате, из которого будут открывать диспуты. Разрешает /dispute и запуск ролевых рассылок из этого чата. |
/init_main_support |
В главном саппорт-чате, где администраторы проверяют чеки. Сохраняет этот чат как главный для площадки. |
/enable_autodispute |
В нужном чате после /init_support. Включает автоматическую обработку файлов с UUID в подписи. |
/disable_autodispute |
В чате, где нужно выключить автоматическую обработку. |
/init_wl |
В каждом чате, который должен получать WL-рассылку. |
Например, в рабочем чате пользователя с ID 10:
/init@bot 10В чате для открытия диспутов:
/init_support@bot/enable_autodispute@botВ главном чате проверки:
/init_main_support@botЗамените bot на имя вашего Klaus. Регистрация чата через /init_support, привязка кабинета через /init ID и назначение главного чата — три отдельных действия. Главный чат проверки общий для настроенного процесса площадки; каждый чат открытия диспутов регистрируется отдельно.
Приём чеков из API на внутреннюю проверку подключает ответственный за запуск площадки. Обычные уведомления исполнителю о диспутах учитывают настройки площадки → Telegram. После настройки проверьте весь маршрут на тестовой заявке: открытие диспута, появление чека в главном чате, решение проверяющего и доставку исполнителю.
Администраторы и дежурные саппорты
Заголовок раздела «Администраторы и дежурные саппорты»/add_admin— добавить администратора Klaus. В личном чате выберите пользователя кнопкой Telegram; в группе отправьте команду ответом на сообщение нужного пользователя./remove_adminили/delete_admin— удалить администратора тем же способом. Для удаления администратора, заданного при запуске, обратитесь к ответственному за настройку бота./add_support— добавить саппорта для упоминания при окончательной ошибке автодиспута. В личном чате нажмите ➕ Выбрать саппорта и выберите одного пользователя; в группе отправьте команду ответом на его сообщение./remove_support— удалить саппорта выбором пользователя или ответом на его сообщение. Это действие не меняет административные права./list_support— проверить сохранённый список дежурных.
Команды доступны только администраторам Klaus. Не передавайте username или числовой ID аргументом: используйте выбор Telegram или ответ на сообщение. Бота назначить саппортом нельзя. Для нескольких саппортов повторите добавление для каждого.
Список саппортов общий для рабочих чатов этого Klaus и сохраняется после перезапуска. Сохраняется Telegram ID: пользователь без username тоже может получать упоминание. Повторное добавление обновляет его имя и username без дубликата. Для надёжного упоминания саппорт должен состоять в исходном рабочем чате; за его пределами действуют ограничения Telegram и приватности пользователя.
Открытие диспута
Заголовок раздела «Открытие диспута»Ручная команда
Заголовок раздела «Ручная команда»В зарегистрированном через /init_support чате отправьте:
/dispute@bot ID_заявки Причина диспутаМожно указать внешний ID мерчанта, UUID или внутренний ID заявки. Бот сначала проверяет внешний ID, затем внутренний. Команду можно отправить с вложением либо ответом на сообщение с файлом. Поддерживаются фото, документы, видео, анимации, аудио, голосовые и видеосообщения. Если вложения есть в обоих сообщениях, используется файл самой команды.
Ручной /dispute может открыть диспут и без файла. При наличии чека Klaus отправляет его на внутреннюю проверку в главный чат. Ошибка ручной команды сообщается без упоминания настроенных саппортов.
Автодиспут
Заголовок раздела «Автодиспут»После /init_support и /enable_autodispute отправьте файл и UUID заявки в его подписи одним сообщением. Автоматический разбор ищет UUID; произвольный внешний ID передавайте ручной командой.
- UUID обычным текстом без файла вызывает ответ «Отправьте чек вместе с UUID заявки.»; поиск заявки и открытие диспута не выполняются.
- Файл без UUID в подписи не обрабатывается автоматически.
- Вложение из сообщения, на которое вы ответили, для автодиспута не учитывается. Отправьте файл заново с UUID в подписи либо используйте ручной
/disputeответом на него. - Несколько UUID проверяются по порядку, повторяющиеся — один раз без учёта регистра. Бот останавливается после первого успешного открытия. Для отдельных заявок отправляйте отдельные сообщения с соответствующими чеками.
Если открыть диспут не удалось по всем UUID, Klaus отправляет итоговый ответ с последним UUID, ошибкой и упоминаниями всех саппортов из своего списка. Промежуточная ошибка одного UUID не вызывает упоминаний, пока остаются следующие попытки. Если список пуст или недоступен, ошибка всё равно придёт без упоминаний.
В главный чат поступает одна выбранная карточка чека: по успешно открытой заявке либо по последней найденной заявке с её собственной ошибкой, если все попытки открытия неуспешны. Если не найдена ни одна заявка, карточки не будет. Ошибка доставки чека после успешного открытия сообщается отдельно и не вызывает упоминания по правилу «диспут не открыт».
Внутренняя проверка чека
Заголовок раздела «Внутренняя проверка чека»В главном чате администратор Klaus сверяет чек с заявкой. Карточка показывает UUID, внешний и внутренний ID, ID мерчанта, исполнителя, сумму и валюту, банк и отметку «После истечения». В Telegram-карточке при наличии соответствующих данных также отображаются номер карты, телефона или счёта и ФИО получателя. Отметка истечения относится к моменту получения чека; перед решением откройте актуальную заявку в кабинете.
Все три кнопки проверки доступны только администраторам Klaus:
| Кнопка в главном чате | Результат |
|---|---|
| Подтвердить | Передаёт проверенный файл в привязанный чат исполнителя. Если заявка ещё в диспуте, под файлом появляются действия по диспуту. |
| Отменить | Сообщает мерчанту, что документ по заявке не прошёл внутреннюю проверку. Файл исполнителю не отправляется. |
| Запросить PDF | Отправляет мерчанту запрос PDF-выписки. Карточка остаётся на проверке, кнопки сохраняются; дождитесь документа от мерчанта. |
После успешного подтверждения или отмены проверки её кнопки убираются, в карточке остаются отметки о действии, администраторе и времени МСК. Повторное нажатие на обработанную проверку не отправляет файл или сообщение заново. Строка с мерчантом остаётся в главном чате и исключается из подписи файла для исполнителя.
Если чат исполнителя или мерчанта не привязан либо отправка завершилась ошибкой, проверьте сообщение и привязку через /init ID. При сообщении «Результат доставки неизвестен» сначала проверьте чат получателя, затем решайте о повторной отправке. Если файл уже дошёл, а карточка не обновилась, не пересылайте чек заново только из-за оставшихся кнопок.
Если исходный чек не дошёл в главный чат, ошибка остаётся в чате отправителя. Проверьте настройку главного чата и доступ Klaus, затем при необходимости пришлите чек новым сообщением. Автоматического обхода внутренней проверки нет.
Чеки через API и в кабинете
Заголовок раздела «Чеки через API и в кабинете»При подключённом режиме внутренней проверки чек, переданный при открытии диспута по API, поступает в главный чат. Новое открытие диспута также сопровождается коротким сообщением в главном чате, в том числе без документа. Это сообщение само по себе не является карточкой чека на проверке.
Отдельное прикрепление чека к существующей заявке через операцию передачи документа мерчантом доставляет его исполнителю напрямую, в том числе когда у мерчанта включено открытие диспута по чеку. Порядок передачи материалов описан в тестировании PayIn и работе саппорта с заявкой. Пересылка файла ботом в Telegram не прикрепляет его автоматически в карточку кабинета.
Действия по диспуту у исполнителя
Заголовок раздела «Действия по диспуту у исполнителя»Под уведомлением о диспуте или одобренным чеком у исполнителя доступны действия:
✅ Подтвердить— завершает заявку со статусом Успех; доступно всем пользователям бота, которым доступна карточка, включая пользователей без прав администратора Klaus.❌ Отменить— отменяет заявку; доступно только администраторам Klaus.🎥 Запрос видеои📋 Запрос выписки— отправляют запрос мерчанту, не более двух раз каждый для карточки.✉️ Запросить чек на почту— просит ввести email ответом на сообщение бота, затем отправляет запрос мерчанту. Запрос можно создать один раз.🪓 Разделение платежа— один раз отправляет запрос мерчанту. Само нажатие не делит заявку и не пересчитывает сумму.💬 Написать мерчанту— позволяет передать текст мерчанту и получить его ответ. Для карточки доступен один такой обмен.
Подтвердить и Отменить здесь меняют результат заявки в статусе Диспут. Пользователь, выполняющий действие, должен сверить UUID, сумму, поступление средств и текущий статус в кабинете. Если заявку уже обработали, проверьте актуальный результат вместо повторного решения по старой карточке.
Для запросов и переписки нужны привязанные чаты мерчанта и исполнителя. Ответьте текстом именно на запрос бота в течение 15 минут с аккаунта, который нажал кнопку. Мерчант сначала нажимает кнопку ответа под полученным сообщением и затем отвечает на запрос бота.
Пересчёт суммы выполняется в кабинете Spyder; его условия и права описаны в работе саппорта с заявкой и матрице ролей.
Напоминание о сроке диспута
Заголовок раздела «Напоминание о сроке диспута»Срок задаёт администратор у мерчанта в поле Таймер разрешения диспута (минут) — см. настройки чеков и сроков. Если срок истёк, а заявка остаётся в диспуте, площадка отправляет однократное напоминание в привязанный Telegram-чат исполнителя — трейдера или агрегатора. Напоминание не меняет статус заявки и не завершает проверку чека.
Получателя задаёт привязка кабинета исполнителя через /init ID. Выполните её заранее от имени администратора Klaus в нужном чате по инструкции настройки. Главный чат /init_main_support предназначен для проверки чеков; /init_support регистрирует источник открытия диспутов. Для напоминания используется именно чат, привязанный к исполнителю.
Рассылки
Заголовок раздела «Рассылки»/message_traders Тексти/message_merchants Текст— рассылка в привязанные чаты кабинетов соответствующей роли. Запускается администратором Klaus из чата, зарегистрированного через/init_support./message_wl Текст— рассылка в чаты, добавленные через/init_wl. Регистрация исходного чата через/init_supportдля этой команды не требуется.
Можно приложить фото или другой поддерживаемый файл и написать команду с текстом в подписи либо отправить команду ответом на вложение. Текст обязателен, его оформление и эмодзи сохраняются. Вложение самой команды имеет приоритет над вложением в reply. При тексте длиннее 1024 символов или видеосообщении файл и текст приходят отдельно. Из альбома рассылается одно вложение сообщения с командой.
После рассылки проверьте количество успешных доставок и ошибок. Недоступность одного чата не останавливает остальные отправки.
Если результат не получен
Заголовок раздела «Если результат не получен»Бот помогает команде поддержки, а контроль сроков и ручная обработка остаются за ней. До включения автодиспутов настройте список дежурных через /add_support и проверьте его командой /list_support.
При ошибке сначала откройте заявку в кабинете и сверьте UUID и статус. Затем проверьте нужную настройку: права администратора Klaus, регистрацию исходного чата, включение автодиспута, привязку чатов сторон или главного чата. После таймаута уточните фактическую доставку и результат действия до повтора.
Если проблема связана с отсутствием заявок, используйте проверку трафика. Настройки уведомлений — в настройках площадки, подключение другой площадки — в инструкции по Spyder-ссылке.