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

Бот Albert

Albert помогает открывать диспуты, передавать чеки исполнителю, запрашивать материалы у мерчанта и делать рассылки. Для внутренней проверки чека в главном саппорт-чате используйте Klaus.

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

Доступ За что отвечает
Администратор площадки Управляет кабинетами и настройками Spyder. Права в кабинете описаны в матрице ролей.
Администратор Albert Настраивает Albert, управляет его администраторами и саппортами, привязками чатов и рассылками. Это отдельный список Telegram-пользователей.
Администратор Telegram-группы Управляет участниками и правами группы. Для административных команд Albert его нужно отдельно добавить в администраторы бота.
Саппорт в списке Albert Получает упоминания при окончательной ошибке автодиспута. Добавление в этот список не выдаёт права администратора бота или роль в Spyder.

Перед использованием убедитесь, что бот подключён к нужной площадке и может отправлять сообщения и файлы в рабочих чатах. Настройку подключения и первоначальных доступов согласуйте с ответственным за запуск; секретные токены в общий чат не отправляйте.

  1. /add_admin — добавляет администратора бота. В личном чате нужно выбрать пользователя кнопкой Telegram, в группе — отправить команду ответом на его сообщение.

  2. /remove_admin или /delete_admin — удаляет администратора тем же способом. Для удаления администратора, заданного при запуске, обратитесь к ответственному за настройку бота.

  3. /init_support — регистрирует текущий чат как разрешённый для открытия диспутов и ролевых рассылок.

  4. /enable_autodispute — включает автооткрытие диспутов в текущем саппорт-чате.

  5. /disable_autodispute — выключает автооткрытие диспутов в текущем чате.

  6. /init_wl — добавляет текущий чат в локальный список WL-рассылки.

  7. /init <user_id> — привязывает текущий Telegram-чат к пользователю площадки: мерчанту, трейдеру или агрегатору. ID возьмите из раздела Пользователи. Повторная команда заменяет прежний чат выбранного пользователя, поэтому перед привязкой сверьте его ID и роль.

  8. /dispute <order_id> [причина] — открывает диспут по внешнему или внутреннему ID заявки.

    • Бот сначала ищет внешний order_id; если он не найден, пробует внутренний ID.

    • При ошибке ручной команды бот сообщает причину без упоминания саппортов.

    • Чек можно приложить к команде или отправить команду ответом на сообщение с фото, видео, документом либо другим поддерживаемым Telegram-медиа. После открытия диспута чек передаётся в привязанный чат исполнителя — трейдера или агрегатора; проверяйте ответ бота и доставку файла.

    • Без приложенного медиа бот ничего дополнительно трейдеру не отправляет.

  9. /document <order_id> — находит заявку и пересылает приложенное медиа в чат исполнителя. Приложите файл к команде или отправьте её ответом на сообщение с файлом. Команда сама не открывает диспут и не меняет статус заявки.

  10. /message_traders <сообщение> — отправляет сообщение всем трейдерам с привязанным telegram_chat_id.

  11. /message_merchants <сообщение> — отправляет сообщение всем мерчантам с привязанным telegram_chat_id.

  12. /message_wl <сообщение> — отправляет сообщение во все чаты, зарегистрированные через /init_wl.

  13. /add_support — добавляет саппорта, которого бот упомянет, если автоматически открыть диспут не удалось ни по одному UUID из сообщения.

  • В личном чате с ботом отправьте команду без аргументов, нажмите ➕ Выбрать саппорта, выберите одного пользователя Telegram и дождитесь подтверждения сохранения.

  • В группе отправьте команду ответом на сообщение нужного пользователя и дождитесь подтверждения.

  • Для добавления нескольких саппортов повторите команду для каждого. В итоговой ошибке бот упомянет их всех через запятую — это сигнал проверить заявку и обработать ситуацию вручную.

  1. /remove_support — удаляет саппорта: в личном чате отправьте команду без аргументов и выберите пользователя кнопкой Telegram, в группе — отправьте команду ответом на его сообщение. Удаление из саппортов не меняет административные права пользователя.

  2. /list_support — показывает сохранённых саппортов. Выполните команду после настройки и проверьте состав дежурных.

Команды настройки, управления администраторами и саппортами, /document и рассылки доступны только администраторам Albert. /dispute можно отправить в чате, зарегистрированном через /init_support.

Для добавления и удаления администраторов или саппортов не передавайте @username или числовой ID аргументом: используйте выбор пользователя или ответ на его сообщение. Назначить бота саппортом нельзя.

Список общий для всех рабочих чатов конкретного бота и сохраняется после перезапуска. Если вы используете несколько ботов в разных чатах, настройте список в каждом отдельно. Добавление саппорта не выдаёт ему административные права в боте или кабинете Spyder.

Сохраняется постоянный Telegram ID, поэтому пользователь без username тоже может быть саппортом. В упоминании показывается @username, а если его нет — имя или «Пользователь ID». Повторное добавление обновляет имя и username без дубликата. Для надёжного упоминания саппорт должен состоять в исходном рабочем чате; за его пределами действуют ограничения Telegram, предыдущего взаимодействия с ботом и приватности пользователя.

Администратор сначала регистрирует чат через /init_support, затем включает режим командой /enable_autodispute. Бот проверяет уникальные UUID из сообщения по порядку без учёта регистра, пробует открыть диспут сначала как по внешнему, затем как по внутреннему ID и останавливается после первого успешного UUID. Ошибки поиска, HTTP 404/500/502, таймауты и сетевые сбои по одному UUID не мешают попробовать следующий. Команда /dispute повторно автодиспутом не обрабатывается.

Если автоматически открыть диспут не получилось по всем UUID, Albert отправляет отдельный итоговый ответ с последним UUID, ошибкой и упоминаниями всех настроенных саппортов через запятую. Ошибка одного UUID не вызывает упоминаний, пока бот может попробовать следующий. При ошибке ручной команды /dispute саппорты не упоминаются.

Если список саппортов пуст или не удалось его прочитать, бот отправляет сообщение об ошибке без упоминаний. Отсутствие упоминания не подтверждает успешное открытие диспута. Ошибка доставки чека после успешного открытия сообщается отдельно и не вызывает упоминаний по правилу «диспут не открыт».

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

При успешном открытии Albert передаёт приложенный чек непосредственно исполнителю. Без вложения дополнительный файл не отправляется. /disable_autodispute отключает режим для текущего чата.

Под уведомлением о диспуте в привязанном чате исполнителя бот обрабатывает кнопки:

  • ✅ Подтвердить — завершает заявку со статусом SUCCESS; доступно всем пользователям бота, которым доступна карточка, включая пользователей без прав администратора Albert;

  • ❌ Отменить — отменяет заявку; доступно только администраторам бота;

  • 🎥 Запрос видео и 📋 Запрос выписки — отправляют запрос мерчанту, не более двух раз каждый;

  • ✉️ Запросить чек на почту — просит ввести email ответом на сообщение бота, затем отправляет запрос мерчанту; запрос можно создать один раз;

  • 🪓 Разделение платежа — один раз отправляет мерчанту запрос на разделение платежа. Само нажатие не делит заявку и не пересчитывает сумму;

  • 💬 Написать мерчанту — запускает переписку: сообщение уходит мерчанту, а его ответ возвращается трейдеру.

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

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

Пересчёт суммы выполняется в кабинете Spyder. Его условия и права ролей описаны в порядке работы с заявкой и матрице ролей.

Администратор задаёт срок у мерчанта в поле Таймер разрешения диспута (минут) — см. настройки чеков и сроков. Если срок истёк, а заявка остаётся в диспуте, площадка отправляет однократное напоминание в привязанный Telegram-чат исполнителя — трейдера или агрегатора. Статус заявки от этого не меняется.

Заранее привяжите чат исполнителя командой /init ID от имени администратора Albert по порядку настройки рабочих чатов. Регистрация исходного чата через /init_support не задаёт получателя напоминаний.

  • /message_wl <сообщение> рассылает текст во все чаты, добавленные командой /init_wl. Регистрация саппорт-чата для этой рассылки не требуется.

  • /message_traders <сообщение> и /message_merchants <сообщение> отправляют сообщение в привязанные к кабинетам чаты соответствующей роли. Их можно запускать только из чата, зарегистрированного через /init_support.

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

Чтобы разослать картинку с текстом, прикрепите её к сообщению и напишите в подписи /message_wl Текст сообщения либо другую команду рассылки. Можно также отправить команду с текстом ответом на картинку или файл. Поддерживаются фото, документы, видео, анимации, аудио, голосовые и видеосообщения. Если вложение есть и у команды, и у сообщения, на которое вы ответили, используется вложение команды.

Текст после команды обязателен; его форматирование и эмодзи сохраняются. При тексте длиннее 1024 символов или видеосообщении файл и текст приходят отдельно. Команда обрабатывает одно вложение; альбом целиком не рассылается. Если часть доставок завершилась ошибкой, проверьте нужные чаты по итоговому ответу бота.

Чат с мерчантом или исполнителем

/init@bot 10

Здесь 10 — ID нужного пользователя в разделе Пользователи. Выполните команду в чате, который нужно привязать. Для переписки и запросов материалов отдельно привяжите кабинеты мерчанта и исполнителя к их рабочим чатам. Привязанный чат трейдера или агрегатора также используется для напоминания о сроке диспута. В примерах замените bot на имя вашего Albert.

Чат споров

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

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

Регистрация через /init_support разрешает работу с диспутами в текущем чате. Получатели чеков и ролевых рассылок задаются отдельно через /init ID.

WL-рассылка

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

Подключение Albert к площадке и первичный административный доступ настраивает ответственный за запуск. Боту нужен API-доступ пользователя с ролью Администратор на этой площадке. Права администратора Albert управляются отдельно командами бота.

Обычные уведомления о диспутах зависят от настроек площадки → Telegram и привязки чата исполнителя. Если сообщение не пришло, сначала проверьте статус заявки в кабинете, затем настройку уведомлений и привязку. Для проблем с потоком заявок используйте проверку причин отсутствия заявок, для связи двух площадок — подключение по Spyder-ссылке.

  • ❌ Не получилось открыть диспут… — заявка не найдена либо площадка отклонила запрос. Сверьте ID и текущий статус в кабинете.

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

  • Команда недоступна — проверьте права администратора Albert для настройки и рассылок, а для /dispute и ролевых рассылок — регистрацию исходного чата через /init_support.

  • Запрос мерчанту не доставлен — проверьте привязку его чата через /init ID и доступ бота к этому чату. Для ответа исполнителю нужна и его привязка.

Albert — инструмент автоматизации, а не замена человеку в поддержке. Сбой сети, недоступность сервиса, ошибка обработки или неверные данные могут помешать открыть диспут, отправить сообщение или доставить чек. Даже настроенные упоминания не заменяют наблюдение за рабочими чатами и заявками.

При ошибке проверьте UUID и текущий статус заявки в кабинете Spyder. Не считайте сообщение обработанным только потому, что его получил бот, появилась карточка или не пришло упоминание. После сетевого сбоя сначала уточните результат в кабинете, затем при необходимости выполните ручное действие по порядку работы саппорта с заявкой.

Финансовые потери из-за ошибок автооткрытия диспутов самим ботом не возмещаются. Контроль сроков, проверка результата и своевременная ручная обработка остаются задачами команды площадки. До включения автооткрытия назначьте ответственных саппортов и согласуйте, кто принимает ситуацию в работу при ошибке бота.


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

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