Получение заявок из формы на сайте Добавление ученика в MoyKlass

Интеграция

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

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

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

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

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

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

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

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

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

Источник «Форма на сайте»

Заявки с HTML-формы на любом сайте начнут поступать после установки скрипта. Укажите поля формы и вставьте скрипт в body. Адрес страницы, utm-метки и cookie аналитики приходят автоматически.

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

  1. В списке типов источника выберите «Форма на сайте» и нажмите «Выбрать».
    Получение заявок из формы на сайте: В списке типов источника выберите «Форма на сайте» и нажмите «Выбрать»

Поля формы

  1. Укажите «Название» источника.
  2. В блоке «Поля» нажмите «Добавить поле» и в «Название» укажите атрибут name у input, select или textarea.
    Получение заявок из формы на сайте: Добавьте поля формы и нажмите «Сохранить»
  3. При необходимости в «Параметры» добавьте GET-параметры страницы сверх utm-меток, а в «Cookie» - cookie сверх аналитики.
  4. Нажмите «Сохранить».

Скрипт на сайт

  1. Откройте вкладку «Источник данных», скопируйте «Скрипт» и вставьте его на сайт внутрь тега body.
    Получение заявок из формы на сайте: Скопируйте «Скрипт» и вставьте его на сайт внутрь тега body
  2. Откройте опубликованную страницу с формой и отправьте тестовую заявку.

Автоматические поля со страницы

Эти поля появляются в заявке без настройки в блоках «Поля», «Параметры» и «Cookie».

  • «Дата и время создания» - момент, когда заявка попала в обработку.
  • «Ссылка (полная)» - адрес страницы вместе со строкой запроса.
  • «Ссылка» - адрес страницы без параметров.
  • «Сайт» - схема и хост страницы, без пути и без параметров.
  • «Домен» - хост страницы.
  • «Заголовок страницы» - содержимое document.title.
  • «Параметры» - все собранные GET-параметры одной JSON-строкой.
  • «Cookie» - строка cookie браузера на момент отправки.

Отдельными полями всегда приходят utm-метки, если они были в адресе после установки скрипта:

  • «Параметр utm_source»
  • «Параметр utm_medium»
  • «Параметр utm_campaign»
  • «Параметр utm_content»
  • «Параметр utm_term»

Отдельными полями всегда приходят cookie аналитики, если они есть в браузере:

  • «Cookie _ga»
  • «Cookie _gid»
  • «Cookie _ym_uid»
  • «Cookie _ym_d»
  • «Cookie roistat_visit»
  • «Cookie roistat_first_visit»
  • «Cookie roistat_marker»
  • «Cookie roistat_marker_old»

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

  • Проверьте, что скрипт стоит внутри body опубликованной страницы, а не только в редакторе.
  • Названия в блоке «Поля» должны совпадать с атрибутом name у элементов формы.
  • Отправьте тест с живой страницы и при необходимости нажмите «Получить поля из последнего запроса».
  • Не удаляйте и не меняйте идентификатор в скопированном «Скрипт».

Действие «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: Входящие данные, статус и история отобразятся в «Истории операций»

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

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