> ## Documentation Index
> Fetch the complete documentation index at: https://agencykey.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Умные списки
> Соберите любой сегмент фанатов на одном экране — фильтры по тратам, чату и подписке — и синхронизируйте список прямо с OnlyFans
## Что такое умные списки
Умные списки — это динамические сегменты фанов внутри AgencyKey. Правила настраиваются один раз, а AgencyKey пересчитывает состав при изменении активности. Обновление выполняется в фоне, поэтому перед использованием проверяйте статус синхронизации в строке списка.
* **Автоматически** — фанаты добавляются и убираются за вас по мере изменения данных
* **По поведению** — сегменты отражают реальные траты, чат и активность подписки
* **Автоматическое обновление** — ручная чистка не нужна; состав меняется после завершения текущего расчёта и синхронизации
Умные списки находятся в разделе **Автоматизация > Списки фанатов**. Выберите модель сверху страницы и оставайтесь на вкладке **Умный список**.
Пока модель не выбрана, ничего не отображается. Рядом с каждым именем в выпадающем списке моделей есть маленький счётчик: сколько у модели умных списков и списков OnlyFans.
## Конструктор умного списка
Любой список собирается и редактируется на одном экране. Нажмите **Создать** (или иконку карандаша в строке, чтобы редактировать) — откроется **Конструктор умного списка**.
Не нужно сначала выбирать тип списка, и нет отдельного окна под каждое правило — всё на одном экране:
1. Дайте списку **название** сверху.
2. Под заголовком **Кто попадёт в список** включите нужные фильтры.
3. Следите за живым счётчиком внизу, чтобы видеть, сколько фанатов будет в списке.
4. Нажмите **Создать** (или **Сохранить** при редактировании).
Фан попадает в список, когда подходит под **все** включённые фильтры. Если вы включили три фильтра, фан должен пройти по всем трём. Кнопка **Сбросить фильтры** выключает всё и позволяет начать заново.
### Группы фильтров
Фильтры разбиты на три группы. Включайте только нужные — остальные остаются выключенными и не учитываются.
| Группа | По чему фильтруете |
| ------------ | ----------------------------------------------------------------------------------------------------------------------------------------- |
| **Траты** | Сколько фан потратил всего или сколько потратил за последние несколько дней |
| **Чат** | Кто писал и сколько сообщений, как давно писала каждая сторона, как долго фан молчит, сколько отправлено PPV и был ли чат активен недавно |
| **Подписка** | Подписка истекает в течение заданного числа дней, сколько дней фан подписан, и статус подписки |
Фильтр **Статус подписки** позволяет выбрать любую комбинацию из:
| Статус | Что означает |
| --------------------- | ------------------------------------------------------- |
| **Активна** | У фана действующая подписка |
| **Без автопродления** | Подписан, но автопродление выключено — подписка истечёт |
| **Истекла** | Срок подписки закончился |
### Счётчик до сохранения
По мере настройки фильтров строка внизу конструктора обновляется сама:
> **В списке X из Y · Не войдут Z**
* **X** — сколько фанатов подходит под фильтры прямо сейчас
* **Y** — общее число фанатов модели
* **Z** — сколько фанатов остаётся за пределами списка
Так вы точно знаете, каким будет список, ещё до сохранения. Счётчик обновляется через мгновение после каждого изменения.
Если задать диапазон наоборот — значение «до» меньше, чем «от» — появится подсказка **«До» не может быть меньше «От».** прямо у фильтра. Поменяйте числа местами, и счётчик снова обновится.
## Таблица умных списков
Таблица списков плоская и легко читается. Каждая строка показывает, что делает список и как он используется, без открытия.
| Колонка | Что показывает |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Название** | Название списка с маленьким значком его главного условия |
| **Фанаты** | Сколько фанатов в списке сейчас |
| **Кто будет в списке** | Понятная сводка условий. Когда условий больше, чем помещается, лишние прячутся в чип **+N фильтров** — наведите на него, чтобы увидеть остальные |
| **Рассылки** | Сколько рассылок используют этот список как аудиторию, или **Не используется** |
| **Выгрузка в OF** | Сколько фанов из плана подтверждено в списке OnlyFans и когда завершилась последняя полная сверка |
| **Синхр. с OF** | Переключатель синхронизации с OnlyFans (см. ниже) |
## Синхронизация списка с OnlyFans
Включите **Синхр. с OF** в строке — AgencyKey свяжет Умный список со списком OnlyFans и будет обновлять его состав по мере того, как фаны входят и выходят.
* **Включить впервые** → на OnlyFans создаётся такой же список и держится синхронизированным.
* **Включить повторно** → AgencyKey проверяет ранее связанный список OnlyFans и, если он существует, приводит его состав в соответствие с текущим Умным списком. Если список удалён, AgencyKey сбрасывает связь; включите синхронизацию ещё раз, чтобы создать новый зеркальный список.
* **Выключить** → список на OnlyFans замирает. Он остаётся на месте, просто перестаёт обновляться.
Пока список синхронизирован, вы управляете его составом из AgencyKey — соответствующий список на OnlyFans следует за ним автоматически.
Пока синхронизация включена, составом зеркала управляет AgencyKey. При выключенной синхронизации состав можно изменить вручную на OnlyFans, но эти изменения временные: после повторного включения AgencyKey сверит зеркало с текущим Умным списком и может заменить их.
### Когда изменения попадают в OnlyFans
AgencyKey сочетает обновления по событиям с регулярными полными сверками:
| Что произошло | Когда AgencyKey проверяет список OnlyFans |
| -------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- |
| Вы включили **Синхр. с OF** | Полная синхронизация сразу ставится в очередь |
| Вы сохранили новые фильтры синхронизированного Умного списка | Новая полная синхронизация сразу ставится в очередь |
| AgencyKey получил событие о покупке, подписке, новом фане или активности в чате, которое изменило состав | Обычно этот фан проверяется примерно через **30 секунд** |
| Для возврата или изменения подписки нужны более свежие исходные данные | AgencyKey выполняет дополнительную проверку примерно через **3 минуты** |
| Фильтры зависят от времени, например «за последние N дней» или «истекает через N дней» | Весь список проверяется каждые **15 минут** |
| У любого Умного списка включена **Синхр. с OF** | Контрольная сверка всего списка выполняется каждый **час** |
| OnlyFans подтвердил не все изменения | AgencyKey выполняет одну восстановительную сверку примерно через **2 минуты**, затем продолжает обычные проверки |
| Синхронизация завершилась ошибкой | AgencyKey делает несколько быстрых попыток, а затем повторяет проверку примерно через **5, 15 и 60 минут** |
Эти интервалы показывают, когда начинается обработка, но не гарантируют время её завершения. Очередь, большой список, задержка исходных данных или ограничения запросов OnlyFans могут увеличить время обновления.
Дата в колонке **Выгрузка в OF** — это время последней подтверждённой **полной сверки**. Точечные обновления отдельных фанов выполняются чаще и не меняют эту дату. Изменения, по которым AgencyKey не получил событие активности, обнаруживаются при следующей подходящей полной сверке через 15 минут или час.
### Статус синхронизации
Точка и текст в колонке **Выгрузка в OF** показывают реальное состояние:
| Состояние | Что означает |
| -------------------------------------------------------- | ------------------------------------------------------------------------- |
| **Идёт синхронизация** | AgencyKey создаёт или обновляет зеркало OnlyFans |
| **Включено — ожидается первая синхронизация** | Первая выгрузка поставлена в очередь, но ещё не завершилась |
| **Синхронизация завершена** | Зеркало соответствует последнему завершённому расчёту |
| **Условия изменены — ожидается повторная синхронизация** | Список изменился, новое обновление поставлено в очередь |
| **Ошибка синхронизации — повтор запланирован** | Последний запуск завершился ошибкой; AgencyKey повторит его автоматически |
| **Не синхронизируется** | Синхронизация выключена, список OnlyFans заморожен |
Зеркало OnlyFans вмещает до **10 000 фанатов**. Сам Умный список внутри AgencyKey может рассчитать большую аудиторию, но такую аудиторию нельзя выгрузить в зеркало. Сузьте фильтры до значения меньше 10 000 и дождитесь успешной синхронизации. В строке отображается причина, если превышен лимит зеркала.
Когда вы меняете фильтры синхронизированного списка, AgencyKey заново проверяет, кто в него входит, и обновляет список на OnlyFans под новый состав.
## Копирование списков между моделями
Кнопка **Копировать** переносит списки одной модели одной или нескольким другим — удобно, чтобы держать одинаковую сегментацию на нескольких аккаунтах.
1. Нажмите **Копировать**.
2. Выберите **модель-источник**.
3. Отметьте списки, которые хотите скопировать.
4. Укажите одну или несколько **целевых моделей**.
5. Подтвердите.
Копирование только **добавляет** списки. Если у целевой модели уже есть список с таким же именем, он пропускается — ничего из уже настроенного не перезаписывается. Скопированный список начинается с чистого листа: он **не** связан ни с каким списком OnlyFans, и его синхронизация с OnlyFans выключена.
## Редактирование и удаление
* **Редактирование** — нажмите иконку карандаша в строке, чтобы снова открыть конструктор с текущими фильтрами. Измените название, переключите фильтры и нажмите **Сохранить**.
* **Удаление** — нажмите иконку корзины и подтвердите. Удаление списка нельзя отменить.
### Удаление синхронизированного списка
Если удаляемый список синхронизирован с OnlyFans, вас спросят, что сделать с соответствующим списком на OnlyFans:
| Выбор | Результат |
| ---------------------------------------------------------- | ------------------------------------------------------------------------------------ |
| **Удалить список на OnlyFans тоже** | Удаляются и умный список, и его копия на OnlyFans |
| **Оставить список на OnlyFans (прекратить синхронизацию)** | Умный список удаляется; список на OnlyFans остаётся как есть и перестаёт обновляться |
## Ограничения
| Ограничение | Значение |
| --------------------- | ------------------------------------- |
| Фильтры по дням | От 1 до 3650 дней |
| Длина названия списка | До 255 символов |
| Название списка | Должно быть уникальным у одной модели |
| Зеркало OnlyFans | До 10 000 фанатов |
## Права доступа
* **Любой, у кого есть доступ к просмотру Списков фанатов**, может открыть таблицу и читать все списки.
* **Создание, редактирование, удаление, копирование и Синхр. с OF** доступны ролям, которые могут управлять Списками фанатов.
Без права на управление кнопки **Создать** и **Копировать**, иконки действий в строке и переключатель **Синхр. с OF** скрыты.
## Что может пойти не так
**Счётчик показывает «Не удалось получить предпросмотр».** Конструктор на мгновение не смог посчитать количество. Измените фильтр, чтобы запустить новую проверку, или переоткройте конструктор.
**Таблица не перестаёт загружаться / показывает «Не удалось загрузить умные списки».** Нажмите **Повторить**, чтобы перезагрузить. Если ошибка повторяется, обновите страницу.
**«Версия умного списка не поддерживается».** Этот список создан в более новой версии приложения, чем та, что запущена у вас. Обновите приложение, чтобы его редактировать.
## Связанные страницы
* [Списки фанатов](/docs/ru/fan-lists/index) — обзор умных списков и списков OnlyFans
* [Таргетинг массовых рассылок](/docs/ru/mass-messages/targeting) — отправка (или исключение) умного списка