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

# Кампании и источники

> Единица трафика в BotFlow: источники Facebook Ads, Telegram и инвайт-ссылка, мастер создания, трекинговые ссылки, статусы и органика.

Кампания это единица трафика. У неё своя трекинговая ссылка, свой источник, своя воронка и своя
статистика. Одна кампания привязана к одному боту: именно в него попадают все подписчики, пришедшие по
её ссылке. Список кампаний и создание новой живут во вкладке «Кампании» раздела «Трекер». Про сам раздел
и метрики смотрите [Трекер и кампании](/ru/tracker).

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

При создании кампании вы выбираете источник. От него зависят и вид ссылки, и набор шагов мастера, и то,
какие настройки вообще понадобятся.

<Columns cols={3}>
  <Card title="Facebook Ads" icon="facebook">
    Лендинг с FB Pixel и Conversion API. Требует свой домен и прокси. Ссылка идёт через ваш домен и несёт
    URL-параметры с макросами Facebook.
  </Card>

  <Card title="Telegram" icon="telegram">
    Прямая ссылка `t.me` без лендинга. Без пикселя и прокси, самый короткий путь до бота.
  </Card>

  <Card title="Инвайт-ссылка" icon="user-plus">
    Заявка в закрытый канал: бот принимает её автоматически и пишет первым. Ссылку платформа генерирует
    сама.
  </Card>
</Columns>

<Warning>
  Источник и бот нельзя изменить после создания кампании. Атрибуция уже привязана к ним, поэтому под
  другой источник или другого бота заведите новую кампанию.
</Warning>

## Как создать кампанию

Кнопка «Новая кампания» вверху списка открывает мастер. Число шагов зависит от выбранного источника.

| Источник          | Шаги мастера                                                  |
| ----------------- | ------------------------------------------------------------- |
| **Facebook Ads**  | Основное, Точка входа, Трекинг, Подтверждение (4 шага)        |
| **Telegram**      | Основное, Точка входа, Подтверждение (3 шага, без «Трекинга») |
| **Инвайт-ссылка** | Основное, «Бот и канал» (2 шага)                              |

По уже пройденным шагам можно вернуться назад кликом по номеру шага. Кнопка «Далее» становится активной,
только когда обязательные поля текущего шага заполнены.

<Steps>
  <Step title="Основное" icon="pen">
    Название кампании и источник трафика. Название видно только вам и команде, в публичную ссылку оно не
    попадает, поэтому пишите так, чтобы удобно было искать кампанию в списке (например, `FB Test 2026-05`).
    Ниже тремя карточками выбирается источник: Facebook Ads, Telegram или Инвайт-ссылка.
  </Step>

  <Step title="Точка входа" icon="robot">
    Бот, стартовый блок воронки и лендинг. Для инвайт-ссылки этот шаг называется «Бот и канал» и устроен
    иначе (бот плюс канал вступления, без стартового блока и лендинга). Подробности ниже.
  </Step>

  <Step title="Трекинг" icon="link">
    Только для Facebook Ads. Домен, прокси, Facebook Pixel ID, CAPI Access Token, URL-параметры ссылки и
    список событий для отправки в Facebook. У Telegram-источника этого шага нет.
  </Step>

  <Step title="Подтверждение" icon="circle-check">
    Сводка настроек. Кнопка «Создать кампанию» создаёт кампанию и сразу выдаёт готовую трекинговую ссылку.
    У инвайт-ссылки отдельного шага «Подтверждение» нет, а кнопка называется «Создать и сгенерировать
    ссылку».
  </Step>
</Steps>

### Шаг «Точка входа»

Здесь вы указываете, куда именно попадёт подписчик после клика.

<Columns cols={3}>
  <Card title="Бот" icon="robot">
    В этого бота приведёте подписчиков из кампании. Бот выбирается один раз: после создания кампании
    сменить его нельзя.
  </Card>

  <Card title="Стартовый блок" icon="diagram-project">
    С какого блока воронки начнётся диалог. По умолчанию «Авто»: подписчик идёт по обычным условиям входа
    блоков.
  </Card>

  <Card title="Лендинг" icon="window-maximize">
    Промо-страница между кликом и ботом. Для Telegram лендинг необязателен, для Facebook на нём живёт
    пиксель.
  </Card>
</Columns>

Про стартовый блок и то, как он влияет на диалог, читайте в разделе [«Стартовый блок»](#стартовый-блок)
ниже. Про сами лендинги, их типы и загрузку смотрите [Лендинги](/ru/landings).

### Шаг «Трекинг» (Facebook)

Шаг «Трекинг» появляется только у источника Facebook Ads и собран из нескольких секций.

<Steps>
  <Step title="Домен" icon="globe">
    Ваш домен, через который пойдёт трекинговая ссылка. В списке доступны только активные домены. Без
    домена кампания создастся черновиком, и пускать на неё трафик будет нельзя. Управление доменами живёт
    в разделе [Домены и прокси](/ru/domains-proxies).
  </Step>

  <Step title="Прокси для CAPI" icon="server">
    Через какой прокси отправлять события в Facebook. Facebook блокирует Conversion API с дата-центров,
    поэтому для запуска FB-кампании прокси обязателен.
  </Step>

  <Step title="Facebook Pixel" icon="chart-simple">
    Pixel ID и CAPI Access Token. Токен сохраняется в защищённой части базы и обратно в API не
    возвращается: после сохранения виден только индикатор «настроен». Рядом есть подсказка «Где взять
    токен?» с пошаговой инструкцией и кнопка «Тест подключения»: она шлёт один тестовый TestEvent в
    Facebook, чтобы проверить связку токена и Pixel ID.
  </Step>

  <Step title="URL-параметры ссылки" icon="link">
    Пары «имя параметра» и «макрос», которые подставятся в трекинговую ссылку. Каждую пару можно включить
    или выключить галочкой, макрос можно поправить. Facebook сам заполнит макросы вроде `{{ad.id}}`
    реальными значениями в момент клика по объявлению.
  </Step>

  <Step title="CAPI события" icon="arrows-turn-right">
    Какие события воронки отправлять обратно в Facebook Conversion API. Настраиваются и события из бота
    (подписка, контакт, просмотр лендинга), и события из постбеков партнёрки (регистрация, FTD, RD).
    Выбор «Не отправлять» отключает конкретное событие. Подробнее про доставку в CAPI ниже.
  </Step>
</Steps>

<Note>
  Строка «Просмотр лендинга» в CAPI-событиях показывается только если у кампании выбран лендинг: без
  лендинга это событие никогда не срабатывает, поэтому платформа его прячет.
</Note>

## Трекинговая ссылка

Готовую ссылку кампании вы вставляете в источники трафика. Её вид зависит от источника.

Для **Telegram** это прямая ссылка на бота с кодом кампании:

```
https://t.me/<имя_бота>?start=<код_кампании>
```

Для **Facebook** ссылка идёт через ваш домен и несёт URL-параметры с макросами. Макросы Facebook
подставляет реальными значениями в момент клика по объявлению:

```
https://<ваш_домен>/<код_ссылки>?adset_name={{adset.name}}&ad_id={{ad.id}}&campaign_name={{campaign.name}}
```

По умолчанию для Facebook включены такие пары «параметр это макрос»:

| Параметр           | Макрос Facebook        |
| ------------------ | ---------------------- |
| `adset_name`       | `{{adset.name}}`       |
| `ad_id`            | `{{ad.id}}`            |
| `adset_id`         | `{{adset.id}}`         |
| `utm_source`       | `{{utm_source}}`       |
| `placement`        | `{{placement}}`        |
| `campaign_name`    | `{{campaign.name}}`    |
| `site_source_name` | `{{site_source_name}}` |
| `ad_campaign_id`   | `{{campaign.id}}`      |

Эти значения попадают в Click Log и в разбивки на странице кампании, поэтому вы видите, какой adset и
какое объявление принесли клик. У Telegram-источника query-параметров нет: ссылка ведёт прямо в бота.

<Warning>
  FB-кампанию можно запустить только со своим доменом: платформа не отдаёт FB-трафик на общий домен
  платформы. Без домена кампания останется черновиком. Для активации FB-кампании обязателен ещё и прокси,
  потому что Facebook блокирует Conversion API из дата-центров.
</Warning>

## Стартовый блок

В точке входа можно задать стартовый блок воронки. Тогда все, кто пришёл по этой ссылке, попадают сразу в
этот блок при запуске бота, минуя условия входа. По умолчанию стоит «Авто», и подписчик идёт по обычным
условиям блоков.

<Info>
  Смена стартового блока применяется только к новым подписчикам. Текущие диалоги продолжают идти по своему
  сценарию, их выбранный блок не переносит.
</Info>

Блоки для выбора берутся у бота этой кампании. Активные блоки идут первыми, черновики и отключённые
показываются с пометкой и недоступны для выбора. Про сами блоки, условия входа и триггеры смотрите
[Конструктор воронок](/ru/constructor).

## Статусы и жизненный цикл

Кампания проходит через четыре статуса.

| Статус       | Что значит                                                            |
| ------------ | --------------------------------------------------------------------- |
| **Черновик** | Настраивается, трафик пускать нельзя (например, ещё не выбран домен). |
| **Активна**  | Принимает трафик, ссылка работает.                                    |
| **Пауза**    | Временно остановлена, можно вернуть в работу.                         |
| **Архив**    | Убрана из списка, лендинг отдаёт 404. Обратимо через фильтр «Архив».  |

Из списка кампаний доступны построчные действия (редактировать, копировать ссылку, пауза, запуск, архив,
удаление) и массовые действия по нескольким выбранным кампаниям сразу.

<Warning>
  Удалить можно только кампанию без кликов: это действие необратимо. Если клики уже были, используйте
  архив, чтобы сохранить историю трафика и конверсий.
</Warning>

<Tip>
  Если вы редактируете кампанию-черновик и на этом шаге дозаполняете недостающее (домен, а для Facebook
  ещё и прокси), при сохранении она сразу запускается: статус меняется на «Активна», и вручную нажимать
  «Запустить» не нужно.
</Tip>

## Инвайт-ссылка

Инвайт-ссылка ведёт в закрытый канал. Человек подаёт заявку на вступление, бот принимает её автоматически
и первым пишет в личку, запуская воронку. Лендинг и пиксель тут не нужны, поэтому у этого источника всего
два шага: «Основное» и «Бот и канал».

<Steps>
  <Step title="Добавьте бота админом канала" icon="shield-halved">
    Бот должен быть администратором нужного канала с правом «Добавление участников». После этого канал сам
    появится в списке на шаге «Бот и канал». Если бот уже был админом раньше, а канала нет в списке,
    снимите бота и назначьте админом заново.
  </Step>

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

  <Step title="Создайте и раздайте ссылку" icon="share-nodes">
    Кнопка «Создать и сгенерировать ссылку» сразу выдаёт готовую инвайт-ссылку прямо на экране, её можно
    скопировать. Вставьте её в источники трафика. Каждый, кто перейдёт и подаст заявку, будет принят
    автоматически и попадёт в воронку по триггеру «Заявка одобрена».
  </Step>
</Steps>

<Warning>
  В одном канале заявки должен принимать только один бот: это ограничение Telegram, первым лиду может
  написать лишь тот бот, который принял его заявку. Если в канале несколько ботов-приёмщиков, чужие
  принятые заявки в трекер не попадут и сообщение лиду не уйдёт.
</Warning>

Кнопка «Перегенерировать» выдаёт новую ссылку и отзывает старую: у кого была прежняя ссылка, тот больше не
подаст заявку по ней. Про триггер «Заявка одобрена» и построение воронки после вступления читайте
[Конструктор воронок](/ru/constructor).

## Отправка событий в Facebook (CAPI)

Для FB-кампаний BotFlow может отправлять события воронки обратно в Facebook через Conversion API, чтобы
алгоритм оптимизировал закупку. На шаге «Трекинг» вы задаёте Pixel ID, CAPI Access Token и выбираете, что
слать.

| Событие                        | Откуда приходит                   | По умолчанию                       |
| ------------------------------ | --------------------------------- | ---------------------------------- |
| **Просмотр лендинга**          | Пиксель лендинга                  | Отправляется                       |
| **Подписка**                   | Бот (подписка на бота)            | Отправляется                       |
| **Контакт (первое сообщение)** | Бот (первое сообщение подписчика) | Отправляется                       |
| **Регистрация**                | Постбек партнёрки                 | Отправляется                       |
| **FTD (первый депозит)**       | Постбек партнёрки                 | Отправляется как Purchase с суммой |
| **RD (повторный депозит)**     | Постбек партнёрки                 | По умолчанию не отправляется       |

FTD и RD уходят в Facebook как Purchase с суммой депозита: это главный денежный сигнал для оптимизации.
RD по умолчанию выключен, потому что оптимизация Facebook обычно строится на первом депозите. Повторные
можно включить вручную на шаге «Трекинг».

<Info>
  Доставку событий в Facebook видно на странице кампании (блок «Доставка в Facebook CAPI») и в отчёте
  «Конверсии» на вкладке «Исходящие»: статусы «Отправка», «Доставлено», «Ошибка». Про входящие постбеки от
  партнёрок смотрите [Постбеки и партнёрки](/ru/postbacks).
</Info>

## Органика

Кампания «Органика» создаётся для бота автоматически и собирает запуски бота без кампании: когда человек
нашёл бота сам и написал `/start` без кода кампании. Её нельзя удалить или переименовать, но можно
назначить ей лендинг, воронку и пиксель, как обычной кампании.

<Note>
  Клик по лендингу и запуск бота это разные события. Клик по трекинговой ссылке (landing) это попадание на
  промо-страницу, оно может не дойти до бота. Запуск бота через `/start` создаёт подписчика (Subscriber) и
  открывает воронку. В отчётах они разделены. Подробнее про путь клика и метрики (Click2LP, Click2FTD,
  Reg2Dep, FTD, RD, EPC) смотрите [Трекер и кампании](/ru/tracker) и [Отчёты](/ru/reports).
</Note>

## Что дальше

<Columns cols={2}>
  <Card title="Лендинги" icon="window-maximize" href="/ru/landings">
    Telegram-клоны и кастомные HTML-страницы между кликом и ботом.
  </Card>

  <Card title="Домены и прокси" icon="globe" href="/ru/domains-proxies">
    Свои домены для FB-ссылок и прокси для отправки событий в Facebook.
  </Card>

  <Card title="Постбеки и партнёрки" icon="arrow-right-arrow-left" href="/ru/postbacks">
    Приём конверсий от партнёрских сетей по `click_id`.
  </Card>

  <Card title="Конструктор воронок" icon="diagram-project" href="/ru/constructor">
    Куда попадает подписчик после запуска бота: блоки, условия, триггеры.
  </Card>
</Columns>
