Партнеры, экспорт и чат заявки
Этот раздел описывает связанные функции, которые часто участвуют в вопросах клиентов и поддержки: партнерская программа, реферальные логи, партнерские баннеры, экспорт курсов и данных, чат в заявке и общий центр чатов.
Для подробного запуска и диагностики именно партнерской программы используйте отдельную страницу Партнерская программа.
Для чего нужен раздел
Раздел нужен, чтобы GitBook AI мог отвечать не только “где включить партнерку”, но и “почему бонус не начислился”, “почему направление не попало в XML”, “почему ручная пара скрылась из файла курсов”, “как оператору запросить чек в чате”, “как закрыть чат для клиента”.
Когда использовать
Партнер не получил бонус
Партнеры, реферальные логи
Программа, процент, тип начисления, заявка, trace
Клиент не привязался к партнеру
Реферальная программа и cookie
Включена ли партнерка, срок cookie, событие client_attached
Партнер не может запросить выплату
Настройки партнерской системы
Минимальная выплата и баланс
Нужно добавить баннер партнера
Partner banners
Название, ссылка, логотип, локали
Мониторинг не видит XML
Export rates
Статус файла, доступность, исключенные направления
Направление пропало из XML
Export rates и статус оператора
Offline operator, резерв, исключения, ручной режим
Нужно выгрузить данные из админки
Export data
Тип выгрузки, период, права доступа
Клиент прислал чек или спорит по реквизитам
Чат заявки
Сообщения, файлы, запрос полей, история клиента
В чатах много непрочитанных
Order chats center
Фильтр, поиск, отметить прочитанным
Основные возможности
Включить реферальную программу
Разрешить начислять партнерам бонусы
При запуске партнерки
Программа по умолчанию
Какой процент назначать новым партнерам
Чтобы новые партнеры не оставались без программы
Тип вознаграждения
От чего считать бонус: суммы обмена или прибыли
Чтобы управлять экономикой партнерки
Срок жизни cookie
Как долго клиент помнит партнера
Для правил атрибуции
Реферальные логи
История событий партнерки
При споре по начислению
Партнерские баннеры
Логотипы и ссылки партнеров
Для публичного блока партнеров
Экспорт курсов
XML или BestChange XML файл
Для мониторингов и партнеров
Доступность файла
Всем или только по ссылке
Для публичного или закрытого экспорта
Исключенные направления
Пары, которые не попадут в экспорт
Если пару нельзя отдавать мониторингу
Export data
Выгрузка данных из админки
Для отчетов и аудита
Чат заявки
Переписка клиента и оператора по заявке
При оплате, чеке, уточнении реквизитов
Закрыть чат
Запретить клиенту писать дальше
После завершения спора или злоупотребления
Запретить файлы
Запретить клиенту прикреплять файлы
Если клиент отправляет мусор или опасные файлы
Запросить поля
Попросить клиента заполнить структурированные данные
Для чека, TXID, банка, суммы, комментария
Настройки партнерской системы
Для чего нужны
Настройки партнерской системы определяют, работает ли партнерка, как начислять бонус, сколько хранить реферальную привязку и когда партнер может запросить выплату.
Поля и настройки
Минимальная выплата
С какой суммы партнер может вывести бонус
Укажите сумму по регламенту
Слишком высокая сумма вызывает вопросы партнеров
Включить реферальную программу
Разрешить начисления
Да — если партнерка должна работать
Нет — новые бонусы не начисляются
Программа по умолчанию
Какая программа назначается новым партнерам
Выберите активную программу
Без нее партнер может остаться без процента
Лог действий
Записывать события бонусной системы
Да — для нормальной диагностики
Если выключить, сложнее разбирать споры
Тип вознаграждений
От суммы обмена или от прибыли обменника
Выберите бизнес-модель
От суммы проще, от прибыли точнее для экономики
Срок жизни реферала
Как долго хранится привязка клиента к партнеру
Без ограничения или ограничить по времени
Влияет на будущие начисления
Время жизни cookie в днях
Сколько дней работает cookie
Например 90, 365, 1825
Работает только при ограничении по времени
Типы вознаграждений
От суммы обмена
Партнер получает процент от суммы операции
Когда нужна простая и понятная схема
От прибыли обменника
Партнер получает процент от чистой прибыли
Когда важно учитывать комиссии и расходы направления
Как настроить партнерку
Создайте хотя бы одну реферальную программу.
Укажите процент партнера.
Включите реферальную программу.
Выберите программу по умолчанию.
Укажите минимальную выплату.
Выберите тип начисления: от суммы обмена или от прибыли.
Включите лог действий.
Настройте срок cookie.
Сделайте тестовую регистрацию по реферальной ссылке.
Создайте тестовую заявку и проверьте лог начисления.
Типовые ошибки
Бонус не начислился
Партнерка выключена, нет программы, заявка не подходит
Проверить настройки и реферальные логи
Бонус равен 0
Процент 0, нет прибыли, условия не выполнены
Проверить программу, тип начисления и направление
Клиент не привязался
Cookie истек или ссылка не применена
Проверить срок cookie и событие client_attached
Партнер не видит выплату
Не достигнута минимальная сумма вывода бонусов
Проверить баланс и минимальную сумму выплаты
Реферальные программы
Поля программы
Название программы
Имя программы по языкам
“Базовая 2%”, “VIP”
Основной язык обязателен
Описание
Объяснение условий
Пишите простым языком
Может быть видно партнеру
Процент партнера
Сколько начислять
Укажите число, например 2 или 0.6
Не добавляйте знак процента, если форма ждет число
Срок действия в минутах
Сколько действует привязка или cookie для программы
Можно оставить пустым
Есть быстрые пресеты 5 месяцев, 1 год, 3 года
Рекомендации
Простая партнерка
Одна программа по умолчанию и понятный процент
Разные уровни партнеров
Несколько программ с понятными названиями
Временная акция
Отдельная программа с ограниченным сроком
Снижение споров
Подробное описание условий и включенные логи
Реферальные логи
Для чего нужны
Реферальные логи показывают, что происходило с партнерской системой: регистрация, привязка клиента, начисление бонуса, отказ в начислении, дубль, сторно или предварительный расчет.
Фильтры
Search
Поиск по тексту или событию
Введите часть сообщения
Event
Тип события
Выберите начисление, привязку, регистрацию и другое
Level
Уровень события
Info, warning, error
Partner ID
ID партнера
Используйте при споре конкретного партнера
Client ID
ID клиента
Используйте при споре по клиенту
Task ID
ID заявки
Основной фильтр для спора по начислению
Trace ID
Технический ID цепочки
Используйте, если событие прошло через несколько шагов
Date from / Date to
Период
Ограничьте дату, чтобы не смотреть весь журнал
События
register_start
Началась регистрация
Проверить, дошел ли клиент до завершения
register_finish
Регистрация завершена
Проверить привязку к партнеру
client_attached
Клиент стал рефералом
Значит ссылка или cookie сработали
credit_success
Бонус начислен
Проверить сумму, процент и заявку
credit_ineligible
Начисление недоступно
Смотреть условия и причину в сообщении
credit_duplicate
Повторное начисление пропущено
Обычно защита от дубля
credit_zero
Бонус получился 0
Проверить процент, прибыль и сумму
hold_settled
HOLD снят, бонус стал доступен
Можно объяснить партнеру, что бонус разблокирован
credit_reversed
Бонус отменен
Проверить причину сторно
preview
Предварительный расчет
Не является реальным начислением
balance_created
Создан баланс партнера
Нормальное служебное событие
program_assigned
Назначена программа
Проверить, какая программа назначена
Аналитика логов
Всего событий
Общее количество записей
Оценить активность
За сегодня
События за текущий день
Проверка свежих проблем
За 7 дней
Недельная динамика
Найти повторяющуюся ошибку
За 30 дней
Месячная динамика
Оценить стабильность партнерки
Топ событий
Какие события чаще всего происходят
Если много ошибок, смотреть условия
По уровню
Info, warning, error
Ошибки требуют проверки
Партнерские условия и баннеры
Информация для партнеров
Реферальная программа
Текст условий партнерки
Пишите понятно: как считается бонус, когда доступен
Не обещайте то, чего нет в настройках
Скидки
Описание скидок или cashback
Укажите реальные условия
Текст должен совпадать с настройками скидок
Мониторингам
Текст для мониторингов
Объясните правила сотрудничества
Не добавляйте приватные контакты
Партнерские баннеры
Название
Название партнера по языкам
Основной язык обязателен
Должно быть понятно на публичном сайте
Ссылка на сайт
URL партнера
Только http или https
Для основного языка ссылка обязательна
Логотип
Изображение партнера
Загрузите качественный логотип
Не используйте тяжелые файлы
Сортировка
Порядок баннеров
Перетащите строку в списке
Важные партнеры выше
Типовые ошибки
Баннер не сохраняется
Нет названия или ссылки на основном языке
Заполнить обязательные поля
Ссылка некорректна
Не http/https или пустая ссылка
Исправить URL
Логотип не отображается
Файл не загружен или удален
Загрузить заново через медиа/поле изображения
Экспорт курсов
Для чего нужен
Экспорт курсов создает XML или BestChange XML файл с направлениями обмена. Его используют мониторинги, партнеры, внешние сервисы и иногда владельцы обменника для проверки доступных пар.
Поля создания файла
Название файла
Имя экспортного файла
Коротко, латиницей, без секретов
Не используйте приватные названия
Тип файла
Формат
XML или BestChange XML
BestChange XML должен соответствовать требованиям мониторинга
Доступность файла
Кто может открыть
Всем или только по ссылке
“Только по ссылке” не заменяет секретную защиту
Статус
Генерировать и отдавать файл
Да — если файл должен работать
Выключенный файл не должен быть доступен как активный экспорт
Поля редактирования файла
Описание
Краткое описание файла по языкам
Пишите назначение файла
Не добавляйте приватные URL
Учитывать правила верификации карты
Влияют ли KYC/card rules на расчет курса
Да — если мониторинг должен видеть реальные условия
Если Нет, файл может показывать курс, недоступный клиенту
Скрывать направление, если резерв меньше минимальной суммы
Убирать пару из экспорта при малом резерве
Да — чтобы не принимать невозможные обмены
Если Нет, мониторинг может видеть пару без достаточного резерва
Тип отображения знаков после запятой
Откуда брать округление
От настроек валюты или принудительно
Принудительное округление может менять вид курса
Количество знаков после запятой
Сколько знаков показывать
Заполняйте только при принудительном режиме
Неверное число портит формат файла
Параметр для fromfee
Как передавать комиссию стороны “Отдаю”
Дополнительная комиссия или комиссия платежной системы
Должно соответствовать ожиданию мониторинга
Параметр для tofee
Как передавать комиссию стороны “Получаю”
Дополнительная комиссия или комиссия платежной системы
Ошибка даст неверную комиссию
Разрешить отключить ручные направления, когда оператор не в сети
Скрывать ручные пары, если оператор офлайн
Да — если ручной обмен без оператора невозможен
Связано со статусом оператора
Исключенные направления
Пары, которые не попадут в файл
Выберите пары вручную
Используйте для временно проблемных направлений
Как проверить экспорт
Откройте список export rates.
Убедитесь, что файл включен.
Проверьте тип файла.
Проверьте доступность: всем или только по ссылке.
Откройте настройки файла.
Проверьте исключенные направления.
Проверьте настройки резерва и статуса оператора.
Если мониторинг жалуется, сравните пару в админке и в XML.
Типовые ошибки
XML пустой
Все направления выключены, исключены или нет резерва
Проверить статус направлений, резерв и исключения
Пары нет в BestChange XML
Тип файла не BestChange XML или пара исключена
Проверить type_file и excluded directions
Мониторинг видит неверную комиссию
Неверно выбран fromfee/tofee
Сверить комиссии направления и параметры экспорта
Ручная пара пропала
Оператор оффлайн и включено скрытие ручных направлений
Проверить статус оператора
Курс отличается от сайта
В экспорт включены другие правила округления или верификации
Проверить number format и card verification rules
Export data
Для чего нужен
Export data — это инструмент выгрузки данных из админки. Он нужен для отчетов, аудита и передачи информации владельцу или бухгалтерии.
Рекомендации
Выгружайте только нужный период
Меньше риск утечки и проще анализ
Давайте доступ только доверенным ролям
Выгрузки могут содержать чувствительные данные
Не храните файлы в публичных местах
В них могут быть заявки, email, суммы и реквизиты
Не добавляйте реальные выгрузки в GitBook
Это приватные данные клиентов
После выгрузки проверьте, кто запросил файл
Это важно для аудита
Чат заявки
Для чего нужен
Чат заявки позволяет оператору и клиенту обсуждать конкретную заявку: оплату, чек, TXID, ошибку реквизитов, возврат или уточнение данных. Чат хранится в карточке заявки и доступен в общем центре чатов.
Состояния и настройки
Чат включен
Включен ли чат заявок глобально
Проверяйте в настройках онлайн-чата
Если выключен, чат не работает
Chat state is_blocked
Чат закрыт для клиента
Закрывайте после завершения спора
История остается в админке
Files enabled
Разрешены ли файлы глобально
Включайте, если нужны чеки
Файлы должны быть безопасных форматов
Files blocked
Файлы запрещены только в этой заявке
Используйте при злоупотреблении
Не отключает текстовые сообщения
Allowed file extensions
Какие файлы можно отправлять
PNG, JPG, JPEG, PDF
Нельзя разрешать произвольные опасные форматы
Max file size MB
Максимальный размер файла
Обычно до 10 МБ, технический максимум до 50 МБ
Большие файлы грузятся медленно
Индикатор печати
Показывать “печатает”
Используйте для живого чата
Требует настроек обновления в реальном времени
Quick replies
Быстрые ответы оператора
Подставляют текст в поле, не отправляют сразу
Оператор должен проверить текст перед отправкой
Активный запрос данных
Активный запрос данных у клиента
Используйте для структурированного сбора информации
Пока запрос активен, клиент видит форму
Customer context
Данные клиента и последние заявки
Смотрите при повторных проблемах
Не отправляйте эти данные другим клиентам
Действия оператора
Отправить сообщение
Написать клиенту в чат
Для уточнения оплаты или реквизитов
Пишите коротко и конкретно
Закрыть для клиента
Запретить новые сообщения
После решения вопроса или злоупотребления
Клиент больше не сможет писать
Открыть чат
Снова разрешить сообщения
Если вопрос возобновился
Проверьте причину открытия
Запретить файлы клиенту
Запретить прикрепления
Если клиент отправляет мусор или опасные файлы
Текстовый чат остается
Разрешить файлы клиенту
Вернуть прикрепления
Если снова нужен чек или документ
Следите за лимитами файлов
Запросить поля у клиента
Попросить заполнить форму
Для TXID, суммы, банка, комментария
Укажите понятные label и placeholder
Отменить запрос полей
Убрать активный запрос
Если запрос ошибочный или больше не нужен
Клиент снова работает без этой формы
Отметить чат прочитанным
Убрать непрочитанный счетчик
После обработки сообщений
Не удаляет переписку
Отметить все чаты прочитанными
Массово убрать счетчики
В конце смены, если все обработано
Не используйте, если есть необработанные вопросы
Поля запроса данных у клиента
Title
Заголовок запроса
“Уточните данные платежа”
Клиент должен понимать цель
Fields
Список полей
От 1 до 8 полей
Не перегружайте клиента
Label
Название поля
“TXID”, “Банк отправителя”, “Сумма оплаты”
Обязательное поле в настройке
Type
Тип поля
Text, textarea или number
Number только для чисел
Required
Обязательное ли поле
Да — если без него нельзя проверить оплату
Не делайте все поля обязательными без причины
Placeholder
Подсказка
“Введите TXID из кошелька”
Не используйте реальные данные
Центр чатов заявок
Список чатов
Последние чаты по заявкам
Для работы оператора со всеми сообщениями
Search value
Поиск по ID заявки или public ID
Когда клиент назвал номер заявки
Unread count
Количество непрочитанных сообщений
Сначала обрабатывайте чаты с непрочитанными
Last message
Последнее сообщение
Быстро понять суть
Customer context
Клиент и до 20 последних заявок
Для повторных проблем
All read by ID
Отметить один чат прочитанным
После обработки заявки
All read chats
Отметить все чаты прочитанными
Только когда все реально обработано
Типовые ошибки
Клиент не может написать
Чат закрыт или глобально выключен
Проверить chat enabled и is_blocked
Клиент не может отправить чек
Файлы выключены глобально или заблокированы в заявке
Проверить files enabled и files blocked
Файл не прикрепляется
Неверный формат или размер
Попросить PNG, JPG, JPEG или PDF в пределах лимита
Оператор не видит новые сообщения
Realtime или очередь не работает
Обновить страницу, проверить уведомления и очередь
Клиент заполнил не те данные
Плохой label или placeholder
Создать новый понятный запрос полей
Важные предупреждения
Не обещайте партнеру начисление, пока не проверены реферальные логи и статус заявки. Бонус может быть недоступен из-за условий, дубля, нулевой прибыли или сторно.
Не публикуйте экспортные ссылки с приватной доступностью в открытых местах. Даже “только по ссылке” не означает полноценную защиту секретом.
Не включайте направления в XML, если по ним нет резерва, оператор оффлайн или реквизиты не готовы.
Не отправляйте в чат персональные данные другого клиента. Чат заявки относится только к конкретному клиенту и конкретной заявке.
Не разрешайте опасные типы файлов в чате. Безопасный набор — изображения и PDF, если это соответствует настройкам проекта.
Связанные разделы
Заявки
Заявки, статусы и действия оператора
Пользователи
Пользователи, партнерская привязка и балансы
Справочник системных настроек
Online chat, уведомления и системные настройки
Источники курсов, формулы и резервы
Курсы, резервы и экспорт
Операции, статусы и действия оператора
Карточка заявки и чат
Справочник пользователей, ролей и доступа
Партнеры, скидки, роли и доступ
Служебные инструменты админки
Файловый менеджер, обновления в реальном времени и служебные действия
Последнее обновление
Это было полезно?