Приём заявок с сайта (форма)

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

Откройте Интеграции → Сайты и формы и нажмите нужную платформу. Мастер попросит выбрать оффер и начальный статус, покажет готовые адреса и сам найдёт поля после тестовой заявки.

Самостоятельное подключение бесплатно. Если не хотите настраивать сами — подключим форму под ключ: установим трекер, настроим одну форму и проверим тестовую заявку. Стоимость — по запросу: объём работ зависит от того, что на сайте уже сделано, поэтому сумму называет менеджер после вашей заявки. Подробнее — в статье «Услуги платформы и счета».

Tilda

1. В Partnetix нажмите Tilda, задайте название, адрес сайта, оффер и начальный статус лида.
2. Скопируйте код трекера из мастера.
3. В Tilda откройте Настройки сайта → Ещё → HTML-код для вставки внутрь HEAD, вставьте код, сохраните и переопубликуйте страницы.
4. В Tilda откройте Настройки сайта → Формы → Webhook и вставьте адрес из мастера целиком. «Посылать Cookies» включать не нужно: Partnetix их не читает. Если Tilda не передала техническое скрытое поле автоматически, добавьте в форму скрытое поле pnx_visitor_id без значения — трекер заполнит его сам.
5. Сохраните. Tilda сразу проверит адрес и должна показать успех — заявка при этом не создаётся, это только проверка связи.
6. Откройте нужный блок формы, отметьте для него созданный Webhook и переопубликуйте страницу.
7. Отправьте тестовую заявку. Мастер автоматически перейдёт к сопоставлению полей.
8. Укажите, какое поле формы содержит имя, телефон, email и дополнительные поля, затем нажмите «Активировать форму». В списках показано то, что вы ввели в тестовой заявке (например, «Василий»), а рядом — название поля у Tilda (input), чтобы не гадать.

Важно: один и тот же Webhook можно технически отметить у нескольких форм, но для предсказуемого маппинга создавайте в Partnetix отдельное подключение на каждую отличающуюся форму.

Трекер ставится один раз на сайт. Когда добавляете вторую форму того же домена, мастер не попросит повторно вставлять код в HEAD.

WordPress

Подключение состоит из двух частей, и обе обязательны:

1. WPCode — плагин, который исполняет выданный нами PHP-код. Ставится всегда.
2. Плагин формы — то, чем на сайте сделана сама форма. Именно он сообщает нам об успешной отправке. Если форма встроенная (блок «Форма»), второй плагин ставить не нужно — этот случай мы тоже поддерживаем.

Шаг 1. Поймите, чем сделана форма

Откройте в админке сайта раздел Плагины и посмотрите список:

Если плагина формы нет вообще, а форма на сайте есть — она сделана встроенным блоком. В редакторе страницы такой блок называется просто «Форма», у него нет названия плагина. Так устроены почти все сайты на WordPress.com и все сайты с плагином Jetpack. Отдельный плагин ставить не нужно, выбирайте Jetpack Forms.

Второй способ проверить: откройте страницу с формой, нажмите Ctrl+U (исходный код) и поищите wp-block-jetpack-contact-form — это встроенный блок, wpcf7 — Contact Form 7, wpforms — WPForms, elementor-form — Elementor.

Обратите внимание: у бесплатного Elementor форм нет вообще, виджет «Форма» есть только в Elementor Pro.

Шаг 2. Создайте подключение в Partnetix

Нажмите WordPress, выберите плагин формы из шага 1, укажите название, адрес сайта, оффер и начальный статус лида. Скопируйте выданный PHP-код.

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

Шаг 3. Установите WPCode и вставьте код

1. Плагины → Добавить плагин, в поиске WPCode.
2. Установите бесплатный WPCode и нажмите Активировать.
3. В меню появится Code Snippets. Откройте + Add Snippet → Add Your Custom Code (New Snippet) и выберите тип PHP Snippet.
4. Вставьте весь код из мастера, задайте название (например, «Partnetix»).
5. Справа в блоке Insertion выберите Auto Insert → Run Everywhere.
6. Включите тумблер Active справа сверху и нажмите Save Snippet.

Не вставляйте этот код в HTML-блок страницы, в «Заголовок и подвал» или в виджет: это серверный PHP, в HTML он просто не выполнится, а секретный адрес окажется на виду. Альтернатива для разработчика — functions.php дочерней темы.

Сразу проверьте, что код работает: откройте любую страницу сайта, нажмите Ctrl+U и поищите p.js. Если тег со скриптом есть — сниппет исполняется. Если нет — он не активен, вставлен не как PHP или не включён режим Run Everywhere.

Шаг 4. Проверьте, что форма на странице — та самая

• Jetpack Forms: форма добавлена блоком «Форма».
• Contact Form 7: после активации плагина в меню появится «Контактная форма». Возьмите там шорткод вида [contact-form-7 id="..."] и вставьте его на страницу блоком «Шорткод».
• WPForms: форма вставлена блоком WPForms или шорткодом [wpforms id="..."].
• Elementor Forms: форма собрана виджетом «Форма» в Elementor Pro.

Если на странице несколько форм, оставьте на время настройки одну — иначе легко отправить тест не с той формы.

Шаг 5. Отправьте тестовую заявку

Откройте форму на сайте и отправьте её как обычный посетитель, заполнив поля осмысленными значениями — по ним вы будете сопоставлять поля. Код не меняет форму и не обходит её проверки: Partnetix получает событие только после штатной успешной отправки.

Мастер обновится сам и предложит сопоставить поля. Укажите имя, телефон, email — и нажмите «Активировать форму».

Сниппет работает на стороне сервера WordPress, поэтому для WPForms не нужно отдельно включать AJAX. После успешного теста он запоминает выбранную форму и больше не отправляет в это подключение соседние формы сайта. Если форм несколько, настраивайте подключения по очереди: полностью завершите тест одной формы и только затем создавайте следующее.

Если тест не приходит

Проверьте по порядку:

1. На странице сайта в Ctrl+U нет p.js → сниппет не исполняется. Вернитесь к шагу 3: тип PHP Snippet, Auto Insert → Run Everywhere, тумблер Active.
2. p.js есть, а заявка не приходит → почти всегда выбран не тот плагин формы. Перепроверьте по шагу 1 и пересоздайте подключение с правильным выбором.
3. Форма на странице сделана другим плагином, чем вы выбрали (например, на странице встроенный блок, а в Partnetix указан Contact Form 7).
4. Для Elementor: стоит бесплатная версия, а не Pro.
5. Сайт на WordPress.com: плагины доступны только на платных тарифах. Если раздела «Плагины» нет — WPCode поставить не получится.

Проверка атрибуции

Тестовая заявка проходит без партнёрской метки — это нормально, она нужна только чтобы найти поля формы. А вот боевые заявки без метки лидом не становятся.

После активации откройте сайт:

1. по партнёрской ссылке и отправьте заявку;
2. отдельно с промокодом;
3. без партнёрской метки.

Первые две заявки должны появиться в разделе «Лиды» у выбранного оффера и статуса. Заявка без метки не создаётся: в партнёрской программе не должно быть «ничейных» лидов.

Если форма уже отправляет заявку напрямую в amoCRM или Битрикс24, отключать это не нужно. Partnetix создаст партнёрский лид у себя, несколько раз попробует найти готовую CRM-сделку по телефону/email и свяжет карточки. Для заявки с сайта новую сделку Partnetix автоматически не создаёт — поэтому дубля не будет. При необходимости администратор сможет нажать «Передать в CRM» в карточке лида.

В карточке подключения видны последний успешный приём и понятная причина ошибки. Подключение можно приостановить или перевыпустить его секретный адрес. После перевыпуска старый адрес сразу перестаёт работать — замените код/Webhook на сайте. Перевыпуск заодно снимает привязку к форме, если тест ушёл не с той формы.

Безопасность

• Не вставляйте публичный API-ключ в Tilda или JavaScript WordPress.
• Трекер хранит только случайный visitorId. Он не создаёт attribution cookies и не использует browser fingerprint.
• Секретный адрес показывается только при создании или перевыпуске подключения.
• В WordPress секретный адрес находится внутри PHP-сниппета и не выводится в HTML страницы.
• Введённое в тестовой заявке Partnetix показывает только в мастере сопоставления и удаляет сразу после активации формы. В журнале подключения этих значений нет.

Чем это отличается от публичного API

Форма сайта работает через выданный мастером Webhook и сама определяет партнёра по переходу или промокоду. Публичный API находится на вкладке Интеграции → API, использует X-Api-Key и предназначен для серверной интеграции CRM, 1С или собственной системы.