> ## 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.

# Подписчики

> База подписчиков бота: список, фильтры и сегменты, карточка с данными и переменными, импорт и экспорт.

Подписчик это человек, который запустил вашего бота, то есть написал ему `/start`. С этого момента он попадает
в базу подписчиков и в вашу воронку. У каждого подписчика есть Telegram ID, имя и @username (если он их задал
в Telegram), дата подписки и статус. Раздел «Подписчики» это полная таблица вашей аудитории по одному боту.

<Note>
  Запуск бота и клик по рекламе это разные события. Клик по трекинговой ссылке или лендингу может не дойти до
  бота. Подписчик появляется только когда человек реально нажал «Запустить» и отправил `/start`. Про путь от
  клика до бота смотрите [Трекер и кампании](/ru/tracker).
</Note>

## Где найти

В меню бота откройте группу «Аудитория», пункт «Подписчики». Рядом в той же группе лежит раздел
[Теги](/ru/tags). Таблица показывает подписчиков только текущего бота: у каждого бота своя база.

## Список подписчиков

Подписчики выводятся таблицей со следующими колонками.

| Колонка         | Что показывает                                                             |
| --------------- | -------------------------------------------------------------------------- |
| **Имя**         | Имя подписчика. Если имени и @username нет, строка помечается «Без имени». |
| **Username**    | @username в Telegram, если он задан.                                       |
| **Telegram ID** | Числовой идентификатор пользователя в Telegram.                            |
| **Подписался**  | Дата, когда человек запустил бота.                                         |
| **Статус**      | «Активен» или «Заблокирован» (пользователь заблокировал бота).             |

Клик по строке открывает карточку подписчика. Справа в строке есть две кнопки: открыть диалог (ведёт в
Мессенджер, в меню бота это пункт «Сообщения») и удалить подписчика. Внизу списка кнопка «Показать ещё»
подгружает следующую страницу.

Если база пуста, вы увидите подсказку «Подписчики появятся, когда кто-то напишет `/start` боту».

<Tip>
  Найти конкретного человека по имени или @username (от 3 символов) можно поиском в Мессенджере, когда
  открываете диалог. В самом разделе «Подписчики» аудиторию сужают фильтры и пресеты, смотрите ниже.
</Tip>

## Фильтры и сегменты

Над таблицей есть два инструмента отбора: быстрые пресеты воронки и конструктор «Свой фильтр». Рядом всегда
виден счётчик аудитории, например «12 233 / 80 000 подписчиков»: слева сколько попало под фильтр, справа
сколько всего.

### Пресеты воронки

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

| Плашка        | Кто попадает                            |
| ------------- | --------------------------------------- |
| **All**       | Все подписчики бота.                    |
| **Reg**       | Есть событие «Регистрация».             |
| **FD**        | Был первый депозит (first deposit).     |
| **RD**        | Был повторный депозит (repeat deposit). |
| **Deposits**  | Суммарно задепозитил больше нуля.       |
| **`<$5`**     | Задепозитил, но не больше 5 долларов.   |
| **`$5-10`**   | Сумма депозитов от 5 до 10 долларов.    |
| **`$10-100`** | Сумма депозитов от 10 до 100 долларов.  |

### Свой фильтр

Кнопка «Свой фильтр» открывает конструктор условий. Здесь вы отбираете подписчиков по тегам, этапам воронки,
метрикам трекинга и переменным бота, объединяя условия по И и ИЛИ. Составленный фильтр можно сохранить
как сегмент и потом выбирать его одним кликом. Подробно про конструктор условий и сохранённые сегменты
смотрите в разделе [Фильтры и сегменты](/ru/filters).

<Info>
  Тот же фильтр работает и как аудитория рассылки: сегмент, собранный здесь, вы выбираете при создании
  [рассылки](/ru/broadcasts). Один способ описать аудиторию для отбора и для отправки.
</Info>

## Массовые действия

Слева от каждой строки есть чекбокс. Отметить можно как отдельных подписчиков, так и всех сразу.

<Steps>
  <Step title="Выберите подписчиков" icon="square-check">
    Отмечайте строки по одной, либо чекбоксом в шапке выберите всех, кто подходит под текущий фильтр, включая
    тех, кто ниже видимой части списка.
  </Step>

  <Step title="Уточните выбор" icon="filter">
    В режиме «все подходящие» можно снять галочку с отдельных строк, чтобы исключить их из выбора.
  </Step>

  <Step title="Примените действие" icon="trash">
    Внизу появляется панель со счётчиком «N выбрано» и кнопкой «Удалить». Массовое удаление необратимо.
  </Step>
</Steps>

## Карточка подписчика

Клик по строке открывает карточку. Вверху аватар, полное имя и @username. Дальше идут данные подписчика.

### Системные переменные

Это стандартные поля, которые платформа заполняет сама. Имена переменных всегда английские, их нельзя
переводить: они подставляются в воронку и рассылки как есть.

| Переменная      | Что означает                                                                       |
| --------------- | ---------------------------------------------------------------------------------- |
| `user_id`       | Внутренний идентификатор подписчика в BotFlow.                                     |
| `telegram_id`   | Идентификатор пользователя в Telegram.                                             |
| `first_name`    | Имя.                                                                               |
| `last_name`     | Фамилия.                                                                           |
| `full_name`     | Имя и фамилия вместе.                                                              |
| `username`      | @username в Telegram, если задан.                                                  |
| `date_of_birth` | Дата рождения, если известна.                                                      |
| `created_at`    | Когда человек запустил бота (дата подписки).                                       |
| `tag`           | Start-параметр, с которым человек запустил бота (`t.me/бот?start=123` даёт `123`). |

### Переменные бота

Кроме системных полей, у бота могут быть свои переменные для подстановки в сообщения и условия. Как их
заводить и использовать, смотрите раздел [Переменные](/ru/variables).

### Статус и действия

Под переменными выводится бейдж статуса: «Активен» или «Заблокирован» (с даты блокировки). Внизу карточки две
кнопки: «Открыть диалог» (переход в Мессенджер к переписке) и «Удалить».

<Warning>
  Удаление подписчика необратимо. Вместе с ним удаляются все его сообщения, переменные и принадлежность к
  спискам и сегментам. Платформа просит подтверждение перед удалением.
</Warning>

## Источник трафика и конверсии

Карточка подписчика показывает его данные и переменные. Откуда он пришёл и какие у него конверсии
(регистрация, FTD, RD) отслеживается в Трекере и привязывается к подписчику по `click_id`. Пресеты воронки
над списком (Reg, FD, RD, Deposits) как раз отражают это состояние, поэтому вы можете отобрать, например, всех
зарегистрировавшихся без депозита прямо в списке подписчиков.

<Warning>
  `click_id` это денежный идентификатор атрибуции. Он привязывает будущий депозит к конкретному подписчику и
  кампании, его нельзя подменять вручную. Подробнее в разделе [Трекер и кампании](/ru/tracker).
</Warning>

## Импорт подписчиков

Если у вас уже есть база из другого сервиса, её можно загрузить. Кнопка «Импорт» в шапке принимает файлы
`.xlsx` и `.csv`.

<Steps>
  <Step title="Проверьте опции импорта" icon="sliders">
    В меню «Ещё» (три точки в шапке) есть два переключателя: «Импорт: определять FTD» (по сигналам выгрузки
    Chatterfy) и «Импорт: переносить теги». По умолчанию оба выключены, чтобы чужие пометки не засоряли базу.
  </Step>

  <Step title="Выберите файл" icon="upload">
    Нажмите «Импорт» и укажите `.xlsx` или `.csv`. Загрузка большого файла занимает время, в кнопке виден
    прогресс.
  </Step>

  <Step title="Проверьте результат" icon="clipboard-check">
    После загрузки платформа сообщает, сколько подписчиков добавлено и сколько обновлено, а также число
    регистраций, перенесённых меток и ошибок.
  </Step>
</Steps>

<Note>
  Строки без Telegram ID импортировать нельзя: подписчик в Telegram определяется именно по нему. Такие строки
  пропускаются, и их число показывается отдельно, чтобы был понятен разрыв между «в файле N» и
  «импортировано M».
</Note>

## Экспорт

Кнопка «CSV» в шапке выгружает всю базу подписчиков бота в файл. Это удобно для резервной копии или переноса
данных.

## Удаление базы

Кроме удаления по одному и массового удаления по выбору, в меню «Ещё» есть пункт «Удалить всю базу…». Он
стирает всех подписчиков бота вместе с историей сообщений.

<Warning>
  «Удалить всю базу» необратимо. Чтобы подтвердить, нужно вручную ввести слово `УДАЛИТЬ`. Данные исчезнут
  навсегда, восстановления нет.
</Warning>

## Что дальше

<Columns cols={2}>
  <Card title="Сообщения" icon="comments" href="/ru/messenger">
    Переписка с подписчиком, ручные ответы и работа операторов.
  </Card>

  <Card title="Теги" icon="tag" href="/ru/tags">
    Метки для сегментации аудитории и запуска сценариев.
  </Card>

  <Card title="Фильтры и сегменты" icon="filter" href="/ru/filters">
    Конструктор условий и сохранённые сегменты аудитории.
  </Card>

  <Card title="Переменные" icon="code" href="/ru/variables">
    Системные поля подписчика и свои переменные бота.
  </Card>

  <Card title="Рассылки" icon="paper-plane" href="/ru/broadcasts">
    Массовая отправка по сегменту подписчиков.
  </Card>

  <Card title="Трекер и кампании" icon="chart-line" href="/ru/tracker">
    Источник трафика, клики и конверсии по `click_id`.
  </Card>
</Columns>