Интеграция
Получение заявок из форм Makeforms → Добавление ученика в MoyKlass
В этой инструкции мы по шагам с примерами разберём, как настроить оба сервиса и связать их между собой:
- Настройка приёма заявок из Makeforms: выбор источника по имени, URL HTTP-вебхука и разбор полей через Парсер JSON. Сохраните настройки и отправьте тестовую заявку.
- Настройка добавления ученика в MoyKlass через HTTP: получение токена по API-ключу и создание карточки с именем, телефоном и филиалом из сценария.
Отдельные инструкции: источник «Получение заявок из форм Makeforms» · действие «Добавление ученика в MoyKlass»
Не хотите настраивать сами? Сделаем бесплатно
Напишите, какие сервисы нужно связать. Специалист настроит интеграцию, проверит, что данные доходят, и оставит вам готовый процесс.
Создайте обработку
В левом меню откройте «Обработки» и нажмите «+».
Источник «Makeforms»
Заявки из Makeforms начнут поступать после выбора «Makeforms» в списке источников. Сохраните источник, скопируйте URL и укажите его в Settings → Integration → Webhook.
Выбор типа источника
- В списке типов источника выберите «Makeforms» и нажмите «Выбрать».
URL приёма
- Не меняя параметры, нажмите «Сохранить».
- Откройте вкладку «Источник данных» и скопируйте «URL».
Webhook в Makeforms
- В Makeforms откройте «Settings» → «Integration» → «Webhook» и нажмите «Add a webhook».
- В «Endpoint» вставьте скопированный «URL», выберите форму, метод «POST» и формат «JSON».
- Нажмите «Save» и отправьте тестовую заявку.
Парсер JSON
- Если образца JSON нет, отправьте тестовую заявку. Откройте вкладку «Экземпляры данных», откройте нужную строку и скопируйте значение, например из «Тело (строка)».
- Добавьте действие «Парсер JSON» и нажмите «Выбрать».
- В поле «JSON» нажмите значок выбора переменной и выберите поле с JSON, например «Источник данных Тело (строка)».
- Вставьте скопированный образец в поле «Пример».
- Нажмите «Сохранить» под полем «Пример».
- Кликами отметьте нужные элементы, чтобы собрать список «Поля».
- Проверьте «Название» полей и дополнительные настройки: «Тип», «Путь».
- Нажмите «Сохранить».
Полная настройка действия: Парсер JSON.
Если заявка не приходит
- Проверьте, что в списке выбран именно этот сервис, а не общий «HTTP».
- Скопированный «URL» вставьте целиком, параметры из него не удаляйте.
- Сохраните настройки в стороннем сервисе и отправьте тест с опубликованной страницы.
- Убедитесь, что метод запроса POST и формат данных совпадает с выбранным в инструкции.
Действие «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- номер без символа+. - Чтобы убрать
+у телефона, в значении нажмите «Фн» и выберите «Формат номера телефона».
- Нажмите «Сохранить».
Запустите обработку
- В обработку начнут поступать данные из настроенного источника.
- По очереди выполнятся все добавленные действия.
- Входящие данные, статус и история отобразятся в «Истории операций».
Застряли на подключении или полях?
Соберём обработку «Получение заявок из форм Makeforms → Добавление ученика в MoyKlass», проверим тест и запустим.