Получение заявок из форм Formaloo Добавление ученика в MoyKlass

Интеграция

Получение заявок из форм Formaloo → Добавление ученика в MoyKlass

В этой инструкции мы по шагам с примерами разберём, как настроить оба сервиса и связать их между собой:

  1. Настройка приёма заявок из Formaloo: выбор источника по имени, URL HTTP-вебхука и разбор полей через Парсер JSON. Сохраните настройки и отправьте тестовую заявку.
  2. Настройка добавления ученика в MoyKlass через HTTP: получение токена по API-ключу и создание карточки с именем, телефоном и филиалом из сценария.

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

Не хотите настраивать сами? Сделаем бесплатно

Напишите, какие сервисы нужно связать. Специалист настроит интеграцию, проверит, что данные доходят, и оставит вам готовый процесс.

Получить бесплатную настройку Или следуйте инструкции ниже

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

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

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

Источник «Formaloo»

Заявки из Formaloo начнут поступать после выбора «Formaloo» в списке источников. Сохраните источник, скопируйте URL и укажите его в профиль → Webhook.

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

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

URL приёма

  1. Не меняя параметры, нажмите «Сохранить».
    Получение заявок из форм Formaloo: Не меняя параметры, нажмите «Сохранить»
  2. Откройте вкладку «Источник данных» и скопируйте «URL».
    Получение заявок из форм Formaloo: Откройте вкладку «Источник данных» и скопируйте «URL»

Webhook в Formaloo

  1. В Formaloo откройте меню профиля и выберите «Webhook».
  2. Перейдите на вкладку «Add new integration», вставьте скопированный «URL» и включите событие отправки формы.
  3. Сохраните интеграцию и отправьте тестовую заявку.

Парсер JSON

  1. Добавьте действие «Парсер JSON».
  2. В поле «JSON» укажите тело запроса из источника.
    Получение заявок из форм Formaloo: В поле «JSON» укажите тело запроса из источника
  3. Вставьте образец в «Пример», отметьте нужные элементы в дереве и нажмите «Сохранить».
    Получение заявок из форм Formaloo: Вставьте образец в «Пример» и нажмите «Сохранить»
    Получение заявок из форм Formaloo: В дереве JSON отметьте нужные элементы

Полная настройка действия: Парсер JSON.

Если заявка не приходит

  • Проверьте, что в списке выбран именно этот сервис, а не общий «HTTP».
  • Скопированный «URL» вставьте целиком, параметры из него не удаляйте.
  • Сохраните настройки в стороннем сервисе и отправьте тест с опубликованной страницы.
  • Убедитесь, что метод запроса POST и формат данных совпадает с выбранным в инструкции.

Действие «MoyKlass»

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

Перейдите в обработке во вкладку "Действия" и нажмите на кнопку "Добавить действие"
actions: Перейдите в обработке во вкладку Действия и нажмите на кнопку Добавить действие

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

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

  1. Выберите «HTTP-запрос» и нажмите «Выбрать».
    Добавление ученика в MoyKlass: Выберите «HTTP-запрос» и нажмите «Выбрать»
  2. В поле «HTTP-метод» выберите POST.
  3. В поле «Адрес» укажите https://api.moyklass.com/v1/company/auth/getToken.
  4. В «Заголовки» добавьте Content-Type со значением application/json.
  5. В поле «Тело» передайте JSON с ключом apiKey и значением API-ключа из MoyKlass.
    Добавление ученика в MoyKlass: В поле «Тело» передайте 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» и разберите токен из ответа предыдущего запроса.
    Добавление ученика в MoyKlass: Добавьте заголовок x-access-token. В значении нажмите «Фн», выберите «Парсер JSON» и разберите токен из ответа предыдущего запроса
    Добавление ученика в MoyKlass: Добавьте заголовок x-access-token. В значении нажмите «Фн», выберите «Парсер JSON» и разберите токен из ответа предыдущего запроса
    Добавление ученика в MoyKlass: Добавьте заголовок x-access-token. В значении нажмите «Фн», выберите «Парсер JSON» и разберите токен из ответа предыдущего запроса
  6. В поле «Тело» нажмите «Фн» и выберите «Компоновщик JSON».
    Добавление ученика в MoyKlass: В поле «Тело» нажмите «Фн» и выберите «Компоновщик JSON»
    Добавление ученика в MoyKlass: В поле «Тело» нажмите «Фн» и выберите «Компоновщик JSON»
  7. Передайте name из сценария, filials - номер филиала из справочника MoyKlass, phone - номер без символа +.
  8. Чтобы убрать + у телефона, в значении нажмите «Фн» и выберите «Формат номера телефона».
    Добавление ученика в MoyKlass: Чтобы убрать + у телефона, в значении нажмите «Фн» и выберите «Формат номера телефона»
    Добавление ученика в MoyKlass: Чтобы убрать + у телефона, в значении нажмите «Фн» и выберите «Формат номера телефона»
    Добавление ученика в MoyKlass: Чтобы убрать + у телефона, в значении нажмите «Фн» и выберите «Формат номера телефона»
  9. Нажмите «Сохранить».

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

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

integrations: Входящие данные, статус и история отобразятся в «Истории операций»

Застряли на подключении или полях?

Соберём обработку «Получение заявок из форм Formaloo → Добавление ученика в MoyKlass», проверим тест и запустим.