Интеграция
Получение заявок из форм WPForms → Добавление ученика в MoyKlass
В этой инструкции мы по шагам с примерами разберём, как настроить оба сервиса и связать их между собой:
- Настройка приёма заявок из форм WPForms: HTTP-источник с URL вебхука, дополнение Webhooks в конструкторе формы и разбор полей через Парсер JSON.
- Настройка добавления ученика в MoyKlass через HTTP: получение токена по API-ключу и создание карточки с именем, телефоном и филиалом из сценария.
Отдельные инструкции: источник «Получение заявок из форм WPForms» · действие «Добавление ученика в MoyKlass»
Не хотите настраивать сами? Сделаем бесплатно
Напишите, какие сервисы нужно связать. Специалист настроит интеграцию, проверит, что данные доходят, и оставит вам готовый процесс.
Создайте обработку
В левом меню откройте «Обработки» и нажмите «+».
Источник «WPForms»
Заявки из форм WPForms начнут поступать на URL HTTP-источника. Сохраните источник, скопируйте URL, укажите его в Webhooks формы и разберите JSON действием «Парсер JSON».
Выбор типа источника
- Отметьте «HTTP» и нажмите «Выбрать».
URL приёма
- Не меняя параметры, нажмите «Сохранить».
- Откройте вкладку «Источник данных» и скопируйте «URL».
Webhook в WPForms
- В WordPress откройте «WPForms» → «Addons», найдите «Webhooks» и нажмите «Install Addon» / «Activate».
- Откройте «WPForms» → «All Forms» и нажмите «Edit» у нужной формы.
- Откройте «Settings» → «Webhooks» и включите «Enable Webhooks».
- В «Request URL» вставьте скопированный «URL».
- В «Request Method» выберите «POST».
- В «Request Format» выберите «JSON».
- В «Request Body» добавьте строки: в «Key» укажите имя поля, в «Select Field» выберите поле формы.
- Нажмите «Save» и отправьте тестовую заявку с опубликованной страницы.
Парсер JSON
- Добавьте действие «Парсер JSON».
- В поле «JSON» укажите тело запроса из источника.
- Вставьте образец в «Пример», отметьте нужные элементы в дереве и нажмите «Сохранить».
Полная настройка действия: Парсер JSON.
Если заявка не приходит
- Проверьте, что установлена лицензия Elite и дополнение «Webhooks» активно.
- Убедитесь, что у формы включён «Enable Webhooks», в «Request URL» вставлен скопированный «URL» и в «Request Method» выбран «POST».
- В «Request Body» должна быть хотя бы одна пара «Key» + «Select Field».
- Не удаляйте параметры из «URL» источника.
- Сохраните форму и отправьте тест с опубликованной страницы, а не только из конструктора.
Действие «MoyKlass»
В MoyKlass создаётся ученик через два HTTP-запроса: сначала токен по API-ключу, затем карточка с именем, телефоном и филиалом.
Перейдите в обработке во вкладку "Действия" и нажмите на кнопку "Добавить действие"
Получение токена
Действие настраивается через «HTTP-запрос». API-ключ возьмите в настройках MoyKlass.
- Выберите «HTTP-запрос» и нажмите «Выбрать».
- В поле «HTTP-метод» выберите
POST. - В поле «Адрес» укажите
https://api.moyklass.com/v1/company/auth/getToken. - В «Заголовки» добавьте
Content-Typeсо значениемapplication/json. - В поле «Тело» передайте JSON с ключом
apiKeyи значением API-ключа из MoyKlass.
- Нажмите «Сохранить».
Отправка ученика
- Добавьте ещё одно действие «HTTP-запрос».
- В поле «HTTP-метод» выберите
POST. - В поле «Адрес» укажите
https://api.moyklass.com/v1/company/users. - В «Заголовки» добавьте
Content-Typeсо значениемapplication/json. - Добавьте заголовок
x-access-token. В значении нажмите «Фн», выберите «Парсер JSON» и разберите токен из ответа предыдущего запроса.
- В поле «Тело» нажмите «Фн» и выберите «Компоновщик JSON».
- Передайте
nameиз сценария,filials- номер филиала из справочника MoyKlass,phone- номер без символа+. - Чтобы убрать
+у телефона, в значении нажмите «Фн» и выберите «Формат номера телефона».
- Нажмите «Сохранить».
Запустите обработку
- В обработку начнут поступать данные из настроенного источника.
- По очереди выполнятся все добавленные действия.
- Входящие данные, статус и история отобразятся в «Истории операций».
Застряли на подключении или полях?
Соберём обработку «Получение заявок из форм WPForms → Добавление ученика в MoyKlass», проверим тест и запустим.