Подключение форм Ninja Forms на сайте WordPress к ClubIS через Lead API.
Отдельный обработчик в ClubIS для Ninja Forms не нужен: после отправки формы плагин отправляет данные на /api/lead. Для этого требуется платное расширение Webhooks (описание, инструкция).
Предварительно: подготовка ClubIS и имена параметров заявки.
Если на сайте уже есть Jetpack — проще вариант из Lead API: WordPress (блок Форма → /api/jetpack).
Базового Ninja Forms недостаточно: нужен именно add-on Webhooks.
В форме должны быть поля, из которых можно передать в ClubIS хотя бы телефон или e-mail (оба — лучше). Имя и фамилию рекомендуется передавать отдельно.
Подписи полей на сайте могут быть любыми — важны имена параметров в webhook (см. ниже).
| Параметр | Значение |
|---|---|
| Remote URL | https://ваш_сервер/api/lead?USER_ID=xxx&USER_HASH=yyy |
| Remote Method | POST |
xxx и yyy — служебный пользователь с доступом к Lead API. Порт в URL указывайте, только если он нестандартный и открыт снаружи.
Вместо пары USER_ID / USER_HASH можно передать token в query URL, если так настроена площадка.
{field:phone}).| Key (параметр ClubIS) | Что передать |
|---|---|
Phone |
телефон |
Email |
|
Name |
имя |
Lastname |
фамилия |
Source |
источник заявки (текст, например Сайт WordPress / Ninja Forms) |
Полный список полей — в техническом описании. Дополнительные поля из ARGS сохраняются в описание сделки и в заметку (если заметки включены в настройках Lead API).
Опцию Encode ARGS as a JSON string не включайте: Lead API ожидает обычные параметры формы (application/x-www-form-urlencoded), не JSON-тело.
Сохраните форму и опубликуйте страницу сайта.
Адрес webhook видит только WordPress при отправке; посетитель остаётся на сайте и видит сообщение об успехе из Ninja Forms.
order_id и profile_id (подробнее).Если заявки нет: включите Run in Debug Mode в действии Webhooks (ошибки API могут показаться после отправки), проверьте URL, ключи авторизации, имена Key в ARGS и что телефон или e-mail реально уходят.
Ключи в URL webhook хранятся в настройках WordPress — используйте отдельного служебного пользователя только для Lead API.