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

# Интеграция Phonexa: отправка лидов через Publisher API

> Подключите Phonexa к LanderLab, чтобы в реальном времени отправлять лиды в кампании Phonexa с помощью учётных данных Publisher API.

> Подключите Phonexa к лендингам в LanderLab, чтобы в реальном времени отправлять данные лидов прямо в ваши кампании Phonexa. Всё, что для этого нужно, — учётные данные Publisher API из платформы Phonexa.

## Что такое Phonexa?

Phonexa — универсальная платформа для performance-маркетинга, которой пользуются лидогенераторы, паблишеры и рекламодатели для управления дистрибуцией лидов, коллтрекингом, email-маркетингом и не только. Продукт LMS Sync отвечает за отправку лидов: он позволяет паблишерам в реальном времени отправлять лиды в кампании Phonexa через HTTP POST.

Когда вы подключаете Phonexa к лендингу в LanderLab, каждый собранный лид автоматически отправляется в вашу кампанию Phonexa с использованием учётных данных Publisher API. LanderLab берёт на себя API-подключение, поэтому писать собственный код или вручную строить серверные интеграции не нужно.

<Note>
  Интеграции Phonexa **не** сохраняются глобально. Каждая интеграция настраивается отдельно для лендинга, поэтому для каждого лендинга, с которого нужно отправлять лиды, придётся создать новое подключение Phonexa.
</Note>

***

## Как добавить Phonexa

Настройка Phonexa проходит в три шага: настройте подключение, сопоставьте поля и проверьте итоговый payload перед подключением.

### Шаг 1. Настройте подключение

<Steps>
  <Step title="Откройте свой лендинг">
    Перейдите в **Landing Pages** и нажмите на **название лендинга**, к которому хотите добавить интеграцию Phonexa.
  </Step>

  <Step title="Откройте вкладку Integrations">
    Нажмите **Add Integration**, чтобы открыть панель интеграций.
  </Step>

  <Step title="Выберите интеграцию Phonexa">
    В списке доступных интеграций найдите **Phonexa integration** (с подписью «Send leads to Phonexa in real time») и нажмите на неё. Откроется мастер настройки.
  </Step>

  <Step title="Заполните данные подключения">
    Введите следующие данные:

    | Поле | Описание |
    | :- | :- |
    | **Name** | Название этой интеграции (например, «Phonexa - Auto Loans»). Помогает узнать её в списке интеграций. |
    | **API URL** | URL эндпоинта для отправки лидов в вашем продукте Phonexa (например, `api.phonexa.com/...`). Указан в спецификации Publisher API в Phonexa. |
    | **API ID** | Числовой Publisher API ID (например, `12345`). Это уникальный идентификатор, присвоенный вашему аккаунту паблишера в Phonexa. |
    | **API Password** | API-пароль, связанный с вашим Publisher API ID. Задаётся и управляется внутри Phonexa. |

    <Tip>
      Чтобы найти **API URL**, **API ID** и **API Password**, войдите в аккаунт Phonexa, откройте **LMS Sync**, затем **Publisher Products API**. Выберите продукт, в который хотите отправлять лиды. URL для отправки, API ID и API Password указаны в разделе Lead Specs вашей API-документации. Их также можно найти в профиле паблишера в настройках API Access.
    </Tip>
  </Step>

  <Step title="Нажмите Continue">
    Нажмите **Continue**, чтобы перейти к сопоставлению полей.
  </Step>
</Steps>

***

### Шаг 2. Сопоставьте поля

На этом шаге вы выбираете, какие поля включить в запрос и как они будут называться при отправке в Phonexa.

<Steps>
  <Step title="Выберите и настройте поля">
    LanderLab автоматически включает набор стандартных полей LanderLab. У каждого поля есть флажок для включения или исключения и столбец **Sent As**, где можно переименовать ключ под ожидания Phonexa.

    Стандартные поля LanderLab:

    | Поле формы | Sent As (ключ по умолчанию) | Описание |
    | :- | :- | :- |
    | **LL Lander URL** | `ll_lander_url` | Полный URL лендинга, на котором был посетитель. |
    | **LL Visitor IP** | `ll_visitor_ip` | IP-адрес посетителя. |
    | **LL Visitor User Agent** | `ll_visitor_user_agent` | Информация о браузере и устройстве посетителя. |
    | **LL Submission Time UTC** | `ll_submission_time_utc` | Дата и время отправки лида (в UTC). |
    | **LL Variant ID** | `ll_variant_id` | ID варианта A/B-теста, который увидел посетитель. |

    Включайте и отключайте любые поля флажками. Значение **Sent As** измените так, чтобы оно совпадало с названиями полей в API-спецификации Phonexa.

    <Tip>
      Если на лендинге есть **квиз-воронка** или **форма**, все добавленные вами поля формы (имя, email, телефон, адрес и любые пользовательские поля) автоматически появятся в этом списке рядом со стандартными полями LanderLab. Их можно включать, отключать и переименовывать так же, как стандартные. Убедитесь, что значения **Sent As** в точности совпадают с названиями полей в API-спецификации Phonexa. Phonexa отклоняет лиды с полями в неверном формате или без обязательных значений.
    </Tip>
  </Step>

  <Step title="Добавьте пользовательские поля (необязательно)">
    В разделе **Additional fields** нажмите **+ Add field**, чтобы добавить в запрос дополнительные пары «ключ — значение». Это удобно для статических значений: sub ID, идентификаторов источника трафика или любого пользовательского параметра, который требует ваша кампания Phonexa.
  </Step>

  <Step title="Нажмите Continue">
    Нажмите **Continue**, чтобы перейти к проверке.
  </Step>
</Steps>

***

### Шаг 3. Проверьте и подключите

<Steps>
  <Step title="Проверьте интеграцию Phonexa">
    Последний шаг показывает полную сводку того, что будет отправляться в Phonexa по каждому лиду. Вы увидите:

    * **тип отправки** и название интеграции
    * раздел **конфигурации** с API URL, API ID и API Password
    * раздел **сопоставления полей** со списком всех полей и соответствующих им переменных шаблона (например, `{{LL Lander URL}}`, `{{LL Visitor IP}}`)

    Внимательно проверьте всё, чтобы конфигурация и названия полей совпадали с ожиданиями вашей кампании Phonexa. Если что-то не так, нажмите **Back** и вернитесь к предыдущим шагам.
  </Step>

  <Step title="Нажмите Connect Phonexa">
    Если всё выглядит верно, нажмите **Connect Phonexa**, чтобы сохранить и активировать интеграцию.
  </Step>
</Steps>

***

## Где найти API-данные Phonexa

Если вы не уверены, где найти API URL, API ID и API Password, выполните следующие шаги:

1. Войдите в аккаунт [Phonexa](https://app.phonexa.com).
2. Откройте **LMS Sync** в левой боковой панели.
3. Нажмите **Publisher Products API**.
4. Выберите продукт, к которому хотите подключиться.
5. В разделе **Lead Specs** вы найдёте **URL для отправки** (ваш API URL), **API ID** и **API Password**.

API ID и API Password также можно найти в профиле паблишера в настройках **API Access**. Нажмите кнопку **Show** рядом с полем API Password, чтобы показать значение.

<Warning>
  Если вы измените или сбросите API Password в Phonexa, старый пароль перестанет работать. Не забудьте обновить пароль в LanderLab после сброса.
</Warning>

***

## Советы по интеграции с Phonexa

* **Точно совпадайте по названиям полей** — Phonexa проверяет все входящие поля по API-спецификации вашего продукта. Используйте столбец **Sent As** на шаге 2, чтобы переименовать поля в точном соответствии с документацией Phonexa.
* **Проверьте обязательные поля** — в API-спецификации вашего продукта Phonexa чётко отмечено, какие поля обязательны. Лиды без обязательных полей или со значениями в неверном формате будут отклонены.
* **Используйте тестовый режим при настройке** — Phonexa поддерживает тестовый режим: добавьте в payload параметр `testMode=1`. Для этого можно использовать раздел **Additional fields** на шаге 2 и добавить его как статическую пару «ключ — значение». Перед запуском в работу удалите его.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.