Получение заявок из YClients Добавление ученика в MoyKlass

Интеграция

Получение заявок из YClients Добавление ученика в MoyKlass

В этой инструкции настроим связку YClients → MoyKlass: получение заявок из YClients, добавление ученика в MoyKlass. Ниже — шаги по порядку, с примерами.

Отдельные инструкции: источник «Получение заявок из YClients» · действие «Добавление ученика в MoyKlass»

Создайте обработку

В левом меню откройте «Обработки» и нажмите «+».

processing-01.png

В списке типов источника выберите «YClients» и нажмите кнопку «Выбрать».

Источник «YClients»

Заявки и уведомления из YClients начнут приходить на URL HTTP-источника. Создайте HTTP-источник, скопируйте URL и укажите его в приложении маркетплейса YClients.

Выбор типа источника

  1. Отметьте «HTTP» и нажмите «Выбрать».
    http-source.png

URL приёма

  1. Не меняя параметры, нажмите «Сохранить».
    https-source-2 (2).png
  2. Откройте вкладку «Источник данных» и скопируйте «URL».
    http-source-3.png

Приложение в YClients

  1. Откройте кабинет разработчика маркетплейса YClients и создайте личный кабинет.
  2. Заполните поля и нажмите «Зарегистрироваться».
    image_2026-03-09_13-10-06.png
  3. Нажмите «Создать приложение».
    image_2026-03-09_13-10-41.png
  4. Выберите тип «Непубличное» и нажмите «Далее».
    image_2026-03-09_13-26-09.png
  1. В разделе «Мои приложения» нажмите «Управление» на карточке приложения.
    image_2026-03-09_13-27-24.png
  2. В «Настройки подключения» в поле «Адрес, на который отправлять уведомления» вставьте скопированный «URL» и нажмите «Сохранить».
    image_2026-03-09_13-30-00.png
  3. В «Общая информация» скопируйте «Ссылка на приложение».
    image_2026-03-09_13-32-39.png
  4. Откройте ссылку в браузере и нажмите «Подключить».
    image_2026-03-09_13-33-17.png
  5. Нажмите «Продолжить» - в выбранном филиале будут установлены вебхуки.
    image_2026-03-09_13-33-27.png

Действие «MoyKlass»

В MoyKlass создаётся ученик через два HTTP-запроса: сначала токен по API-ключу, затем карточка с именем, телефоном и филиалом.

Перейдите в обработке во вкладку "Действия" и нажмите на кнопку "Добавить действие"
wj2-action-create-01.png

Получение токена

Действие настраивается через «HTTP-запрос». API-ключ возьмите в настройках MoyKlass.

  1. Выберите «HTTP-запрос» и нажмите «Выбрать».
  2. В поле «HTTP-метод» выберите POST.
  3. В поле «Адрес» укажите https://api.moyklass.com/v1/company/auth/getToken.
  4. В «Заголовки» добавьте Content-Type со значением application/json.
  5. В поле «Тело» передайте JSON с ключом apiKey и значением API-ключа из MoyKlass.
  6. Нажмите «Сохранить».

Отправка ученика

  1. Добавьте ещё одно действие «HTTP-запрос».
  2. В поле «HTTP-метод» выберите POST.
  3. В поле «Адрес» укажите https://api.moyklass.com/v1/company/users.
  4. В «Заголовки» добавьте Content-Type со значением application/json.
  5. Добавьте заголовок x-access-token. В значении нажмите «Фн», выберите «Парсер JSON» и разберите токен из ответа предыдущего запроса.


  6. В поле «Тело» нажмите «Фн» и выберите «Компоновщик JSON».

  7. Передайте name из сценария, filials - номер филиала из справочника MoyKlass, phone - номер без символа +.
  8. Чтобы убрать + у телефона, в значении нажмите «Фн» и выберите «Формат номера телефона».


  9. Нажмите «Сохранить».

Запустите обработку

  1. В обработку начнут поступать данные из настроенного источника.
  2. По очереди выполнятся все добавленные действия.
  3. Входящие данные, статус и история отобразятся в «Истории операций».

vk-ads-02.png