Интеграция
Получение заявок из U-ON.ru → Добавление ученика в MoyKlass
В этой инструкции мы по шагам с примерами разберём, как настроить оба сервиса и связать их между собой:
- Приём заявок из U-ON.ru через HTTP webhook с r_id: затем запрос полной заявки через U-ON API для получения всех полей обращения в сценарии.
- Настройка добавления ученика в MoyKlass через HTTP: получение токена по API-ключу и создание карточки с именем, телефоном и филиалом из сценария.
Отдельные инструкции: источник «Получение заявок из U-ON.ru» · действие «Добавление ученика в MoyKlass»
Создайте обработку
В левом меню откройте «Обработки» и нажмите «+».
В списке типов источника выберите «u-on.ru» и нажмите кнопку «Выбрать».
Источник «u-on.ru»
U-ON.ru присылает webhook с r_id новой заявки. По r_id запросите полную заявку через U-ON API.
URL вебхука
- Выберите нужный тип источника и нажмите «Выбрать».
- Нажмите «Сохранить».
- Скопируйте «URL» целиком - адрес уже содержит параметры приёма данных.
Webhook и API U-ON
- В U-ON.ru настройте webhook на скопированный URL источника.
- Webhook передаст параметр r_id новой заявки.
- Добавьте действие «HTTP-запрос» для получения полной заявки через U-ON API по r_id.
Действие «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- номер без символа+. - Чтобы убрать
+у телефона, в значении нажмите «Фн» и выберите «Формат номера телефона».
- Нажмите «Сохранить».
Запустите обработку
- В обработку начнут поступать данные из настроенного источника.
- По очереди выполнятся все добавленные действия.
- Входящие данные, статус и история отобразятся в «Истории операций».