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

# Постбеки

> Приём конверсий от партнёрских сетей по S2S: подключение партнёрки, сопоставление по click_id, события воронки, отправка в Facebook CAPI и авто-переходы в воронке.

Постбек это сообщение от партнёрской сети о том, что ваш подписчик совершил целевое действие:
зарегистрировался, внёс первый депозит, пополнил счёт повторно. Партнёрка отправляет такое событие
напрямую с сервера на сервер (S2S, server-to-server), а BotFlow сопоставляет его с конкретным подписчиком
по `click_id` и записывает в историю конверсий.

Это замыкает воронку: клик и запуск бота платформа видит сама, а вот что произошло на стороне рекламодателя
(регистрация, депозит) знает только партнёрка. Постбек передаёт эти факты обратно к вам, привязывает их к
человеку и кампании и оживляет метрики Reg2Dep, Click2FTD, FTD, RD и EPC.

## Как это работает

<Steps>
  <Step title="Вы даёте подписчику ссылку с click_id" icon="link">
    В ссылку регистрации у рекламодателя подставляется `click_id` конкретного подписчика. Он приходит вместе
    с переходом в бота (`t.me/<бот>?start=<click_id>`) и остаётся привязан к этому человеку.
  </Step>

  <Step title="Партнёрка запоминает click_id" icon="floppy-disk">
    При регистрации подписчик передаёт `click_id` в партнёрку через параметр её ссылки. Партнёрка сохраняет
    его рядом с новым аккаунтом клиента.
  </Step>

  <Step title="Клиент совершает действие" icon="user-check">
    Клиент регистрируется, вносит депозит или пополняет счёт повторно на стороне рекламодателя.
  </Step>

  <Step title="Партнёрка шлёт постбек" icon="arrows-rotate">
    Партнёрка отправляет запрос на вашу постбек-ссылку и передаёт в ней тот самый `click_id`, тип события и
    сумму.
  </Step>

  <Step title="Платформа сопоставляет и записывает" icon="check-double">
    BotFlow находит клик по `click_id`, привязывает событие к подписчику и кампании и пишет конверсию в
    историю. Дальше она видна в отчётах, в карточке подписчика и в метриках.
  </Step>
</Steps>

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

## Партнёрки

Приём постбеков настраивается в трекере, во вкладке **Партнёрки**. Здесь вы подключаете партнёрскую сеть,
видите её статус и проверяете, что приём событий работает.

### Подключение сети

Кнопка **Подключить** открывает окно, где вы выбираете тип партнёрки и при желании задаёте название.

<Columns cols={2}>
  <Card title="Pocket Option" icon="plug">
    Готовая интеграция. Постбек-ссылки для событий уже настроены, параметр `click_id` подставлен. Вам остаётся
    скопировать ссылки в кабинет партнёрки.
  </Card>

  <Card title="Другая партнёрка" icon="sliders">
    Универсальный вариант для любой сети. Вы указываете, в какой параметр партнёрка кладёт `click_id`, и
    берёте готовые постбек-ссылки под свои события.
  </Card>
</Columns>

<Tip>
  Название необязательно, но удобно, если вы подключаете несколько партнёрок одного типа: по названию вы
  различаете их в списке и в журнале конверсий.
</Tip>

### Статус и кнопка «Тест»

У каждой подключённой партнёрки есть статус (**Активна** или **Неактивна**) и кнопка **Тест**. Кнопка «Тест»
отправляет тестовый постбек с фиктивным `click_id` и показывает результат обработки: так вы проверяете, что
весь путь от приёма запроса до записи в историю конверсий работает, не дожидаясь реального депозита. Рядом с
кнопкой платформа показывает тестовый `click_id`, по которому этот прогон можно найти в отчётах.

<Info>
  Список партнёрок фильтруется по статусу (Все, Активные, Неактивные) и по названию. Пустой список означает,
  что партнёрки ещё не подключены.
</Info>

## Готовая интеграция: Pocket Option

Страница Pocket Option собирает всё в одном месте: статус подключения, ссылки для регистрации и готовые
постбек-ссылки.

<Steps>
  <Step title="Подключите интеграцию" icon="plug">
    Одной кнопкой. После подключения вы сможете создавать ссылки для регистрации с трекингом, получать события
    (регистрация, депозит, повторный депозит, вывод средств, комиссия) и видеть их в карточке подписчика и в
    общей аналитике.
  </Step>

  <Step title="Создайте ссылку для регистрации" icon="link">
    В разделе **Tracking Links** вставьте ссылку регистрации из кабинета Pocket Option. Платформа сама добавит
    параметр `click_id` и покажет готовый Final URL, который вы отдаёте подписчикам.
  </Step>

  <Step title="Скопируйте постбек-ссылки в кабинет партнёрки" icon="copy">
    В разделе **Postback Configuration** для каждого события есть своя готовая ссылка. Раскройте нужное
    событие, скопируйте ссылку и вставьте её в постбеки в кабинете Pocket Option.
  </Step>
</Steps>

На карточке подключения виден параметр Click ID, в который партнёрка кладёт ваш `click_id`. При отключении
интеграции существующие ссылки для регистрации перестанут работать, но история событий в карточках
подписчиков сохранится.

## Кастомная партнёрка

Если готовой интеграции нет, подойдёт тип **Другая партнёрка**. Логика та же, просто вы настраиваете стыковку
вручную.

<Steps>
  <Step title="Укажите параметр click_id" icon="pen">
    Определите, в какой параметр ваша партнёрка записывает `click_id`. Без этого платформа не поймёт, кому из
    подписчиков принадлежит событие.
  </Step>

  <Step title="Возьмите готовые постбек-ссылки" icon="link">
    Платформа выдаёт по ссылке на каждое событие. Обычно нужны три: регистрация, первый депозит и повторный
    депозит.
  </Step>

  <Step title="Вставьте ссылки в кабинет партнёрки" icon="arrows-rotate">
    В настройках постбеков партнёрки подставьте наш `click_id`, тип события и сумму депозита в соответствующие
    параметры ссылки.
  </Step>
</Steps>

Схематично постбек-ссылка несёт три вещи: `click_id` подписчика, тип события и сумму депозита.

```
https://<ваша-постбек-ссылка>?click_id={click_id}&status=<событие>&amount={amount}
```

Здесь `{click_id}` и `{amount}` это макросы партнёрки, которые она заменяет реальными значениями в момент
отправки, а `<событие>` это статус, который платформа сопоставляет со своим типом конверсии.

<Note>
  Значения `{click_id}` и `{amount}` в фигурных скобках это переменные партнёрской сети, а не переменные
  BotFlow. Как именно называются эти макросы, смотрите в документации своей партнёрки: у разных сетей они
  разные.
</Note>

## Какие события приходят

Каждый постбек несёт тип события. Партнёрка присылает своё название статуса, платформа приводит его к своему
типу конверсии.

| Событие                    | Что это                                   |
| -------------------------- | ----------------------------------------- |
| **Регистрация**            | Клиент зарегистрировался у рекламодателя. |
| **FTD** (депозит)          | Первый депозит с суммой.                  |
| **RD** (повторный депозит) | Повторное пополнение с суммой.            |
| **Вывод**                  | Клиент вывел средства с платформы.        |
| **RevShare**               | Начисление комиссии по revshare.          |
| **Подтверждение email**    | Клиент подтвердил почту.                  |

Депозитные события (FTD и RD) несут сумму, поэтому именно они питают выручку и EPC. Внутренние события воронки
(подписка на бота, первое сообщение от подписчика, просмотр лендинга) фиксируются самой платформой и постбека
не требуют.

<Info>
  Не путайте клик по лендингу и запуск бота. Клик по лендингу это попадание на промо-страницу, оно может не
  дойти до бота. Запуск бота через `/start` создаёт подписчика (Subscriber) и открывает воронку. Постбек же
  привязывается к подписчику через `click_id` клика, по которому этот подписчик пришёл. Подробнее про путь
  клика смотрите в разделе [Трекер и кампании](/ru/tracker).
</Info>

## Авто-переходы в воронке по постбеку

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

В [Конструкторе воронок](/ru/constructor) на стрелке между блоками доступны системные события партнёрки:

| Событие-триггер         | Когда срабатывает                         |
| ----------------------- | ----------------------------------------- |
| **Регистрация**         | Пришёл постбек о регистрации.             |
| **Депозит**             | Пришёл постбек о первом депозите (FTD).   |
| **Повторный депозит**   | Пришёл постбек о повторном депозите (RD). |
| **Вывод**               | Пришёл постбек о выводе средств.          |
| **RevShare**            | Пришло начисление комиссии.               |
| **Подтверждение email** | Клиент подтвердил почту.                  |

Типичный сценарий: после регистрации подписчик переходит на шаг «помогаем внести первый депозит», после FTD
на шаг «доводим до повторного депозита», а ИИ ведёт диалог с учётом того, что уже произошло.

<Warning>
  Авто-переход работает только у подписчика, у которого есть `click_id` и запущена воронка в личке бота. Если
  подписчик не приходил через трекинговую ссылку, сопоставлять постбек будет не с чем.
</Warning>

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

Для FB-кампаний постбеки можно отправлять дальше, обратно в Facebook, через Conversion API. Так рекламный
алгоритм узнаёт о реальных депозитах и оптимизирует закупку под платящих клиентов.

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

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

## Проверка и отладка

Когда партнёрка говорит «мы отправили FTD», а вы его не видите, есть два инструмента.

<Columns cols={2}>
  <Card title="Кнопка «Тест»" icon="paper-plane">
    Отправляет тестовый постбек и показывает результат обработки. Быстрый способ убедиться, что приём событий в
    принципе работает.
  </Card>

  <Card title="Отчёт «Конверсии»" icon="receipt">
    В трекере, во вкладке «Отчёты», журнал показывает и входящие постбеки, и исходящие события в Facebook.
    Поиск идёт по точному `click_id`.
  </Card>
</Columns>

Для каждого входящего постбека в журнале виден результат обработки:

| Результат                   | Что означает                                                                 |
| --------------------------- | ---------------------------------------------------------------------------- |
| **Успех**                   | Событие сопоставлено с подписчиком и записано.                               |
| **Нет совпадения по клику** | `click_id` не найден: проверьте, что партнёрка передаёт правильный параметр. |
| **Дубль**                   | Такое событие уже приходило и не записывается повторно.                      |
| **Неверный статус**         | Тип события не сопоставлен: проверьте настройку статусов у партнёрки.        |
| **Ошибка**                  | Сбой обработки. Детали видны в строке журнала.                               |

<Tip>
  Чаще всего «постбек не пришёл» на деле означает «пришёл, но без совпадения по клику». Сначала проверьте
  журнал «Конверсии» по `click_id`: если строка есть с результатом «Нет совпадения», проблема в параметре
  `click_id` на стороне партнёрки, а не в приёме.
</Tip>

## Что дальше

<Columns cols={2}>
  <Card title="Трекер и кампании" icon="chart-line" href="/ru/tracker">
    Кампании, трекинговые ссылки, путь клика, метрики и отчёты.
  </Card>

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

  <Card title="ИИ-оператор" icon="robot" href="/ru/ai-operator">
    Как ИИ ведёт диалог с учётом регистрации и депозитов.
  </Card>

  <Card title="Подписчики" icon="users" href="/ru/subscribers">
    Карточка подписчика с историей событий и конверсий.
  </Card>
</Columns>
