> ## Documentation Index
> Fetch the complete documentation index at: https://docs.botflow.cc/llms.txt
> Use this file to discover all available pages before exploring further.

# Фильтры

> Фильтры и сегменты подписчиков: быстрые фильтры списка чатов, конструктор условий по стране, событиям и депозитам, сохранённые сегменты и их переиспользование в рассылках.

Фильтр это набор условий, которым должен отвечать подписчик, чтобы попасть в выборку. С его помощью вы сужаете список чатов до нужных людей: «те, кто зарегистрировался, но не задепал», «депозиты от 10 долларов», «подписчики из RU без тегов» и так далее.

Отдельного пункта меню «Фильтры» нет. Они живут внутри двух разделов и в обоих собираются одним и тем же конструктором условий.

<Columns cols={2}>
  <Card title="Мессенджер" icon="comments" href="/ru/messenger">
    Быстрые фильтры списка чатов, папки по воронке и сохранённые сегменты слева над списком диалогов.
  </Card>

  <Card title="Подписчики" icon="users" href="/ru/subscribers">
    Вся таблица подписчиков бота с тем же конструктором условий по колонкам сверху.
  </Card>
</Columns>

Сохранённый фильтр называется **сегментом**. Один раз собрав условие и дав ему имя, вы переиспользуете его в [рассылках](/ru/broadcasts) как аудиторию, не пересобирая заново.

## Быстрые фильтры списка чатов

В разделе [Мессенджер](/ru/messenger) над списком чатов есть готовые фильтры, которые не нужно настраивать. Кнопка с иконкой ползунков справа от поиска открывает меню из пяти режимов. Активен всегда один.

| Режим           | Что показывает                                               |
| --------------- | ------------------------------------------------------------ |
| Все чаты        | все диалоги бота                                             |
| Непрочитанные   | диалоги с непрочитанными входящими                           |
| ИИ              | диалоги, которые сейчас ведёт [ИИ-оператор](/ru/ai-operator) |
| Оператор        | диалоги, переведённые на ручной режим                        |
| Заблокированные | подписчики, заблокировавшие бота                             |

### Папки по воронке

Над списком идёт полоса быстрых «папок» по воронке продаж. Их названия закреплены на английском и одинаковы во всех языках интерфейса, чтобы операторы из разных стран называли папку одинаково.

* `All`: все чаты.
* `Reg`: есть событие регистрации.
* `FD`: был первый депозит.
* `RD`: был повторный депозит.
* `Deposits`: сумма депозитов больше нуля.
* `<$5`, `$5-10`, `$10-100`: срезы по сумме депозитов.

В той же полосе показываются сохранённые сегменты этого бота, а кнопка «Фильтр» в конце ряда открывает конструктор условий. Выбор режима, папки, сегмента или своего фильтра сбрасывает предыдущий: источник фильтрации всегда один.

## Конструктор условий

Кнопка «Фильтр» (в «Сообщениях») или «Добавить фильтр» (в «Подписчиках») открывает панель «Фильтр подписчиков». Здесь вы собираете условие из отдельных строк.

Каждая строка это три части:

1. **Поле**: по чему фильтруем (страна, сумма депозитов, теги и так далее).
2. **Оператор**: как сравниваем (равно, больше, содержит, за последние N дней).
3. **Значение**: с чем сравниваем. Для некоторых операторов («пусто», «заполнено») значение не нужно.

<Steps>
  <Step title="Добавьте первое условие" icon="plus">
    Нажмите «Добавить условие», выберите поле из списка, затем оператор и укажите значение. Строка сразу применяется к выборке.
  </Step>

  <Step title="Добавьте ещё условия" icon="layer-group">
    Каждое следующее условие соединяется с предыдущими через переключатель «И» / «ИЛИ». «И» требует выполнения всех условий сразу, «ИЛИ» достаточно любого одного.
  </Step>

  <Step title="Смешайте логику через подгруппу" icon="code-branch">
    Если нужно правило вида «(A и B) или C», добавьте подгруппу с противоположным оператором. Так внутри одной группы уживаются «И» и «ИЛИ».
  </Step>

  <Step title="Проверьте счётчик" icon="calculator">
    Рядом с фильтром показывается, сколько подписчиков подходит: «N подписчиков» или «N / T», где T это всё население бота. Счётчик пересчитывается сразу, пока вы правите условия.
  </Step>

  <Step title="Примените" icon="check">
    Нажмите «Применить». Список чатов или таблица подписчиков перестроятся под ваше условие.
  </Step>
</Steps>

<Note>В одном фильтре можно собрать до 50 условий с вложенностью подгрупп до 5 уровней. Этого хватает на любую реальную выборку.</Note>

### Какие поля доступны

Поля сгруппированы в выпадающем списке. Технические имена (`sub1`, `fb_campaign_id`, `UTM source`) намеренно одинаковы во всех языках, это отраслевые названия.

| Группа     | Поля                                                                                                                               |
| ---------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| Подписчик  | Имя, Фамилия, Username, Start-параметр, Заблокирован ботом, Заблокирован админом, Дата подписки, Дата блокировки, [Теги](/ru/tags) |
| Депозиты   | Есть регистрация, Был FTD, Дата FTD, Дата последнего RD, Сумма депозитов, Кол-во конверсий                                         |
| Трафик     | Страна, Устройство, UTM source, FB campaign, FB adset, FB ad, `sub1`-`sub5`                                                        |
| Переменные | Ваши [переменные бота](/ru/variables) (`var.имя`)                                                                                  |

<Info>События воронки (регистрация, FTD, RD) приходят из [трекера](/ru/tracker) и уже готовы к использованию в группе «Депозиты» как отдельные условия. Отдельно считать их не нужно.</Info>

### Операторы

Набор операторов зависит от типа поля.

| Тип поля                                  | Операторы                                                                                        |
| ----------------------------------------- | ------------------------------------------------------------------------------------------------ |
| Текст (имя, страна, `sub1`, переменные)   | равно, не равно, имеет любой из, не имеет ни одного из, содержит, пусто, заполнено               |
| Число (сумма депозитов, кол-во конверсий) | равно, не равно, больше, больше или равно, меньше, меньше или равно, между                       |
| Дата (дата подписки, дата FTD)            | больше, больше или равно, меньше, меньше или равно, между, за последние N дней, пусто, заполнено |
| Да / Нет (был FTD, заблокирован)          | да, нет                                                                                          |
| [Теги](/ru/tags)                          | имеет любой из, имеет все, не имеет ни одного, имеет только эти, без тегов, есть теги            |

<Tip>Оператор «имеет любой из» удобен, когда значений несколько: введите `RU, US, KZ`, нажимая Enter после каждого, и в выборку попадут подписчики из любой из этих стран.</Tip>

## Сохранение сегмента

Собранное условие можно сохранить под именем и переиспользовать. В панели фильтра нажмите «Сохранить фильтр», введите название (например, `VIP с FTD`) и подтвердите.

Что важно знать о сегментах:

* Сегмент принадлежит **боту** и виден всей команде, у которой есть доступ к этому боту.
* Создавать, переименовывать и удалять сегменты может оператор и роли выше.
* Избранные сегменты помечаются звёздочкой и всплывают в начало полосы папок. Избранное общее для всей команды.
* На одного бота можно хранить до 50 сегментов.

<Warning>Удаление сегмента необратимо. Рассылки и триггеры, которые уже его использовали, сохранят снимок своей аудитории, но новые запуски ссылаться на удалённый сегмент не смогут.</Warning>

## Переиспользование в рассылках

Главная выгода сегментов раскрывается в [рассылках](/ru/broadcasts). На шаге выбора аудитории вы указываете либо сохранённый сегмент, либо собираете свой фильтр прямо в мастере тем же конструктором. Так же аудитория задаётся у триггерных рассылок [кампаний](/ru/campaigns).

<Columns cols={2}>
  <Card title="Рассылки" icon="paper-plane" href="/ru/broadcasts">
    Массовая или отложенная отправка по выбранному сегменту или своему фильтру.
  </Card>

  <Card title="Теги" icon="tag" href="/ru/tags">
    Ручные и авто-теги подписчиков, по которым удобно строить сегменты.
  </Card>
</Columns>

<Note>Перед запуском рассылки мастер показывает, сколько подписчиков попадает в выбранную аудиторию. Это тот же живой счётчик, что и в конструкторе условий.</Note>