> For the complete documentation index, see [llms.txt](https://docs.iexexchanger.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.iexexchanger.com/help-center/ai-base/dlya-ai-agenta/answer-playbooks.md). # Сценарии ответов AI-чата ## Для чего нужен раздел Этот раздел помогает GitBook AI отвечать не только "где находится настройка", но и "что делать дальше". Сценарии написаны для типовых ситуаций, когда пользователь ожидает практическую инструкцию. ## Как использовать сценарии AI-агент должен выбрать сценарий, который ближе всего к вопросу пользователя, и дать ответ простым языком. Если в вопросе не хватает данных, сначала задайте один уточняющий вопрос. ## Сценарий: направление не видно на сайте ### Короткий ответ Проверьте цепочку: валюта "Отдаю", валюта "Получаю", направление, курс, резерв, лимиты, график работы и кеш. ### Пошаговая проверка 1. Убедитесь, что обе валюты включены и не находятся в архиве. 2. Проверьте, что направление активно. 3. Проверьте, что у направления есть рабочий курс. 4. Проверьте, что резерв достаточный для минимальной суммы обмена. 5. Проверьте минимальную и максимальную сумму. 6. Проверьте, не закрывает ли направление график работы. 7. Очистите кеш и снова откройте форму обмена. ### Частые причины | Причина | Что сделать | | --------------------- | ----------------------------------------------------- | | Валюта выключена | Включить валюту и проверить ее фильтр | | Направление выключено | Включить направление после проверки курса и резерва | | Нет курса | Настроить ручной курс или источник курса | | Резерв ниже минимума | Пополнить резерв или изменить лимиты | | Сработало расписание | Проверить рабочий статус и город, если обмен наличный | ### Предупреждение Не включайте направление без резерва, лимитов и понятной инструкции для клиента. Клиент сможет создать заявку, а оператору придется разбирать проблему вручную. ## Сценарий: клиент не может создать заявку ### Короткий ответ Если направление видно, но заявка не создается, проблема обычно в сумме, обязательных полях, реквизитах, KYC, AML, чекбоксах согласия или ограничениях пользователя. ### Пошаговая проверка 1. Попросите пользователя назвать направление и сумму. 2. Проверьте текст ошибки на форме обмена. 3. Проверьте минимальную и максимальную сумму направления. 4. Проверьте обязательные поля валюты и направления. 5. Проверьте чекбоксы согласия и правила формы. 6. Проверьте KYC и верификацию карты. 7. Проверьте AML-правила, если обмен связан с криптовалютой. 8. Проверьте пользователя: блокировка, IP, e-mail, черный список. ### Частые причины | Ошибка | Причина | Решение | | ---------------------- | ------------------------------------------ | ----------------------------------------------------------- | | Сумма меньше минимума | Пользователь ввел слишком маленькую сумму | Указать допустимый минимум | | Сумма больше максимума | Лимит направления или резерва меньше суммы | Изменить лимит или предложить меньшую сумму | | Не заполнено поле | Обязательное поле пустое | Заполнить поле или убрать обязательность, если она не нужна | | Требуется KYC | Для направления включена проверка личности | Направить пользователя на верификацию | | Клиент заблокирован | Сработал черный список или ограничение | Проверить причину блокировки | ## Сценарий: курс не обновляется ### Короткий ответ Сначала выясните, какой тип курса использует направление: ручной, из источника, по формуле, из файла или BestChange. После этого проверяйте именно этот источник. ### Пошаговая проверка 1. Откройте направление и посмотрите тип курса. 2. Если курс ручной, проверьте значение в направлении. 3. Если курс из источника, проверьте дату последнего обновления источника. 4. Если курс по формуле, проверьте исходные значения и тестовый расчет. 5. Если курс из файла, проверьте дату файла и формат. 6. Если курс BestChange, проверьте пару, режим расчета и фильтры. 7. Проверьте CRON и фоновые процессы. 8. Очистите кеш и проверьте форму обмена. ### Типовые ошибки | Ситуация | Причина | Что сделать | | ------------------------- | ---------------------------------------- | -------------------------------------- | | На сайте старый курс | Кеш или не сработало автообновление | Очистить кеш, проверить CRON | | В направлении другой курс | Выбран другой источник или формула | Проверить тип курса в направлении | | Формула считает странно | Ошибка в переменных или коэффициенте | Проверить расчет на конкретном примере | | BestChange не дает курс | Нет подходящих обменников после фильтров | Ослабить фильтры или проверить пару | ### Предупреждение Не меняйте формулу или источник на рабочем направлении без теста. Ошибка курса может привести к финансовому убытку. ## Сценарий: формула курса считает неправильно ### Короткий ответ Проверьте формулу по цепочке: исходные теги, значения источников, коэффициенты, порядок действий, округление, обратную пару и настройки направления. Не исправляйте рабочую формулу сразу, сначала сделайте тестовый расчет. ### Пошаговая проверка 1. Откройте формулу и выпишите все теги, которые в ней используются. 2. Проверьте значение каждого тега отдельно. 3. Если какой-то тег пустой или равен 0, проверьте источник этого курса. 4. Проверьте коэффициенты: `1.01` означает плюс 1 процент, `0.99` означает минус 1 процент. 5. Проверьте, не применена ли маржа дважды: в формуле и отдельно в направлении. 6. Если это обратная пара, посчитайте вручную: 1 делится на исходный курс. 7. Если курс считается через промежуточную валюту, проверьте обе части цепочки. 8. Проверьте округление: для фиата обычно 2 знака, для криптовалюты нужно больше. 9. Сделайте preview и сравните результат с ручным расчетом. 10. После исправления проверьте направление на публичной форме обмена и тестовой заявке. ### Типовые ситуации | Ситуация | Вероятная причина | Что сделать | | --------------------------------------------------- | ------------------------------------------------- | -------------------------------------------------------------- | | Формула дала 0 | Пустой источник, неизвестный тег или деление на 0 | Проверить каждый тег и добавить запасной источник | | Курс стал слишком высоким | Дважды применена маржа или неверный кросс-курс | Проверить формулу и настройки направления | | Курс стал слишком низким | Использована обратная пара или лишняя скидка | Проверить `inverse`, коэффициент и округление | | После изменения коэффициента изменились другие пары | Коэффициент общий для нескольких формул | Проверить связанные формулы или разделить коэффициенты | | Запасной источник всегда используется | Основной источник давно пустой | Проверить основной источник, а fallback оставить как страховку | ### Предупреждение Если формула используется в нескольких направлениях, любое изменение сразу влияет на все эти пары. Перед изменением проверьте связанные направления и сохраните старое значение в рабочей заметке. ## Сценарий: клиент оплатил, но заявка не перешла дальше ### Короткий ответ Проверьте факт поступления, сумму, реквизиты, статус заявки, журнал платежной системы и очередь обработки. ### Пошаговая проверка 1. Откройте карточку заявки. 2. Проверьте текущий статус заявки. 3. Сверьте сумму, которую должен был отправить клиент. 4. Сверьте реквизиты, на которые клиент оплатил. 5. Проверьте журнал платежной системы или входящего платежа. 6. Проверьте, была ли частичная оплата, переплата или оплата не на тот реквизит. 7. Проверьте, не требуется ли AML или KYC перед продолжением. 8. Если автоматическая проверка не сработала, передайте заявку ответственному оператору. ### Типовые ситуации | Ситуация | Что означает | Действие | | -------------------------------- | ---------------------------- | ----------------------------------------------- | | Оплата не найдена | Система не видит поступление | Проверить реквизит и платежную систему | | Сумма меньше ожидаемой | Клиент недоплатил | Пересчитать или запросить доплату по регламенту | | Сумма больше ожидаемой | Клиент переплатил | Проверить правила переплаты | | Оплата пришла позже | Платеж задержался | Проверить статус подтверждений | | Оплата пришла на другой реквизит | Клиент ошибся | Передать на ручную проверку | ### Предупреждение Не переводите заявку в оплаченные или выполненные, пока не подтвержден факт поступления. Это одно из самых рискованных действий в админке. ## Сценарий: автовыплата не отправилась ### Короткий ответ Проверьте статус заявки, настройки автовыплаты, лимиты, реквизиты клиента, баланс у провайдера, журнал ошибки и очередь. ### Пошаговая проверка 1. Убедитесь, что заявка находится в статусе, где разрешена выплата. 2. Проверьте, включена ли автовыплата для валюты и направления. 3. Проверьте лимиты автовыплаты. 4. Проверьте реквизиты клиента и сеть. 5. Проверьте, достаточно ли средств у провайдера. 6. Откройте журнал автовыплаты и посмотрите причину ошибки. 7. Проверьте очередь фоновых задач. 8. Перед повторным запуском убедитесь, что первая выплата точно не прошла. ### Типовые ошибки | Ошибка | Причина | Решение | | ------------------------ | ------------------------------------------------ | -------------------------------------------------- | | Автовыплата не выбралась | Нет подходящего правила или провайдера | Проверить правила выплат | | Провайдер вернул ошибку | Ошибка на стороне провайдера или неверные данные | Проверить журнал и настройки подключения | | Превышен лимит | Сумма больше разрешенного лимита | Изменить лимит или выполнить вручную по регламенту | | Неверная сеть | Клиент указал реквизит другой сети | Проверить поле сети и реквизит | ## Сценарий: реквизиты не выдались клиенту ### Короткий ответ Проверьте статус реквизита, привязку к валюте и направлению, лимиты, остаток, правила выдачи и журнал реквизитов. ### Пошаговая проверка 1. Откройте валюту, которую клиент отдает. 2. Проверьте, какой способ приема оплаты используется: ручные реквизиты или мерчант. 3. Если используются ручные реквизиты, проверьте активность реквизита. 4. Проверьте, подходит ли реквизит по сумме и направлению. 5. Проверьте остаток лимита реквизита. 6. Проверьте журнал выдачи реквизитов по конкретной заявке. 7. Если используется мерчант, проверьте журнал платежной системы. ### Предупреждение Не добавляйте реальные реквизиты в переписку с AI или документацию. Реквизиты должны храниться только в защищенной админке. ## Сценарий: KYC не проходит или завис ### Короткий ответ Проверьте статус KYC-заявки, выбранный KYC-сервис, причину отказа, документы пользователя и журнал проверки. ### Пошаговая проверка 1. Откройте заявку KYC пользователя. 2. Проверьте текущий статус. 3. Проверьте, внешний сервис используется или ручная модерация. 4. Проверьте загруженные документы и обязательные поля. 5. Проверьте причину отказа, если она есть. 6. Проверьте журнал KYC. 7. Если сервис не отвечает, передайте вопрос ответственному специалисту. ### Типовые причины | Причина | Что делать | | -------------------------- | ------------------------------------------------ | | Документы плохого качества | Попросить пользователя загрузить новые документы | | Не совпадают данные | Проверить данные профиля и документа | | Сервис не обновил статус | Проверить журнал и очередь | | Требуется ручное решение | Передать ответственному модератору | ## Сценарий: AML показывает высокий риск ### Короткий ответ Не продолжайте обмен автоматически. Проверьте AML-лог, адрес, транзакцию, уровень риска и внутренний регламент обменника. ### Пошаговая проверка 1. Откройте карточку заявки. 2. Проверьте AML-результат. 3. Откройте AML-лог. 4. Посмотрите, что проверялось: адрес, транзакция или оба варианта. 5. Сравните риск с правилами обменника. 6. Если риск высокий, передайте заявку на ручное решение. 7. Не меняйте настройки AML только ради одной заявки. ### Предупреждение AML связан с юридическими и финансовыми рисками. AI не должен советовать обходить AML-проверку. ## Сценарий: письма не приходят ### Короткий ответ Проверьте настройки email, шаблон события, адрес получателя, очередь, журнал отправки и папку спам. ### Пошаговая проверка 1. Уточните, кому не приходит письмо: клиенту, оператору или владельцу. 2. Уточните событие: регистрация, заявка, смена статуса, KYC, выплата. 3. Проверьте, включен ли шаблон события. 4. Проверьте адрес отправителя и получателя. 5. Отправьте тестовое письмо. 6. Проверьте очередь и журнал. 7. Если тест не отправляется, проверьте настройки почтового провайдера. ### Предупреждение Не вставляйте почтовые ключи и пароли в чат. Их можно проверять только в защищенной админке или кабинете провайдера. ## Сценарий: Telegram не отправляет уведомления ### Короткий ответ Проверьте бота, канал, права бота, шаблон события, привязку канала и тестовое сообщение. ### Пошаговая проверка 1. Убедитесь, что бот создан и активен. 2. Убедитесь, что бот добавлен в нужный канал или чат. 3. Проверьте права бота на отправку сообщений. 4. Проверьте привязку канала в админке. 5. Проверьте шаблон уведомления. 6. Отправьте тестовое сообщение. 7. Проверьте журнал ошибок уведомлений. ### Предупреждение Токен Telegram-бота нельзя отправлять в чат поддержки или добавлять в документацию. ## Сценарий: клиент заблокирован или не может создать заявку ### Короткий ответ Проверьте пользователя, IP, e-mail, карту, кошелек, черный список, KYC, AML и лимиты направления. ### Пошаговая проверка 1. Найдите пользователя в админке. 2. Проверьте блокировку пользователя. 3. Проверьте IP и e-mail ограничения. 4. Проверьте черный список по карте, кошельку или реквизиту. 5. Проверьте KYC и AML. 6. Проверьте направление и лимиты. 7. Если блокировка была ручной, проверьте комментарий или журнал. ### Предупреждение Не снимайте блокировку без понимания причины. Блокировка могла быть связана с мошенничеством, AML или спорной оплатой. ## Сценарий: промо-код или скидка не применяются ### Короткий ответ Проверьте срок действия, лимит использований, пользователя, направление, сумму и условия промо-кода или скидки. ### Пошаговая проверка 1. Проверьте активность промо-кода или скидки. 2. Проверьте дату начала и окончания. 3. Проверьте лимит использований. 4. Проверьте, подходит ли направление. 5. Проверьте, подходит ли сумма обмена. 6. Проверьте пользователя или группу клиентов. 7. Проверьте, не конфликтует ли скидка с другим правилом. ## Сценарий: партнерский бонус не начислен ### Короткий ответ Проверьте реферальную связь, программу партнера, статус заявки, тип расчета, HOLD и журнал начислений. ### Пошаговая проверка 1. Найдите партнера и реферала. 2. Проверьте, есть ли реферальная связь. 3. Проверьте программу, назначенную партнеру. 4. Проверьте статус заявки. 5. Проверьте тип расчета: от суммы обмена или от прибыли. 6. Проверьте минимальные суммы и HOLD. 7. Откройте журнал партнерских начислений. ### Предупреждение Партнерские начисления должны соответствовать публичным условиям партнерской программы. ## Сценарий: страница, баннер или контакт не видны на сайте ### Короткий ответ Проверьте статус, дату публикации, место отображения, меню, группу, кеш и мобильную версию. ### Пошаговая проверка 1. Откройте нужный объект в админке. 2. Проверьте, включен ли он. 3. Проверьте даты показа, если они есть. 4. Проверьте привязку к меню или группе. 5. Проверьте порядок сортировки. 6. Очистите кеш. 7. Проверьте сайт на компьютере и телефоне. ## Сценарий: CRON или фоновые процессы не работают ### Короткий ответ Проверьте дату последнего запуска, задачи курсов, очереди, уведомления и журналы ошибок. Если запуски остановились, нужен специалист по серверу. ### Пошаговая проверка 1. Проверьте дату последнего успешного запуска. 2. Проверьте, какие задачи перестали работать: курсы, уведомления, выплаты, импорт, очереди. 3. Проверьте журналы ошибок. 4. Проверьте, не выключен ли автоматический режим. 5. Проверьте очередь фоновых задач. 6. Если задачи не запускаются совсем, передайте вопрос специалисту по серверу. ### Предупреждение AI может объяснить, где смотреть симптомы, но не должен выдавать приватные серверные команды или доступы. ## Сценарий: пользователь спрашивает "что можно безопасно менять" ### Короткий ответ Безопаснее менять тексты, описания, порядок, FAQ, баннеры и неопасные визуальные настройки. Осторожно меняйте курсы, лимиты, резервы, статусы, мерчанты, автовыплаты, KYC, AML и безопасность. ### Таблица риска | Настройка | Риск | Рекомендация | | ---------------------- | ------------- | ----------------------------------------------- | | Тексты, FAQ, новости | Низкий | Можно менять после проверки отображения | | Баннеры и дизайн | Средний | Проверить мобильную и desktop версию | | Валюты и направления | Высокий | Проверять курс, резерв, лимиты, реквизиты | | Курсы и формулы | Высокий | Тестировать на примере до включения | | Резервы | Высокий | Не завышать без фактических средств | | Статусы заявок | Высокий | Менять только после понимания цепочки обработки | | Мерчанты и автовыплаты | Очень высокий | Проверять на малых суммах и по журналам | | KYC и AML | Очень высокий | Согласовывать с регламентом обменника | | 2FA, IP, доступы | Очень высокий | Менять только ответственному администратору | --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.iexexchanger.com/help-center/ai-base/dlya-ai-agenta/answer-playbooks.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.