Перейти к содержимому

Бот 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, поступает в главный чат. Новое открытие диспута также сопровождается коротким сообщением в главном чате, в том числе без документа. Это сообщение само по себе не является карточкой чека на проверке.

Отдельное прикрепление чека к существующей заявке через операцию передачи документа мерчантом доставляет его исполнителю напрямую, в том числе когда у мерчанта включено открытие диспута по чеку. Порядок передачи материалов описан в тестировании 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-ссылке.