Интеграция
Получение заявок из LP Generator → Добавление ученика в MoyKlass
В этой инструкции мы по шагам с примерами разберём, как настроить оба сервиса и связать их между собой:
- Настройка приёма заявок из LP Generator: HTTP-источник с параметрами формы, плагин «Произвольный код» и вызов скрипта после отправки.
- Настройка добавления ученика в MoyKlass через HTTP: получение токена по API-ключу и создание карточки с именем, телефоном и филиалом из сценария.
Отдельные инструкции: источник «Получение заявок из LP Generator» · действие «Добавление ученика в MoyKlass»
Создайте обработку
В левом меню откройте «Обработки» и нажмите «+».
В списке типов источника выберите «lpgenerator.ru» и нажмите кнопку «Выбрать».
Источник «lpgenerator.ru»
Заявки из форм LP Generator начнут приходить на URL HTTP-источника. с параметрами формы, вставьте скрипт в плагин сайта и вызовите его после отправки формы.
Параметры HTTP
- Задайте настройки HTTP-запроса как на скриншоте.
- Добавьте параметры:
name,phone,email,form_fields,form_info. При необходимости добавьтеutm_source,utm_medium,utm_campaign,utm_content,utm_term,roistat.
- Нажмите «Сохранить».
- Откройте вкладку «Источник данных» и скопируйте «URL».
Плагин на сайте LP Generator
- Откройте настройки сайта.
- Добавьте новый плагин.
- Выберите тип «Произвольный код».
- Вставьте скрипт в поле «Произвольный код BODY» и замените
ВСТАВЬТЕ_СКОПИРОВАННЫЙ_URLна скопированный «URL».
function webjack(name, phone, email, form_fields, form_info) {
try {
var wj_webhook = 'ВСТАВЬТЕ_СКОПИРОВАННЫЙ_URL';
webjack_send_webhook(wj_webhook, name, phone, email, form_fields, form_info);
swal("Спасибо!\nВаша заявка отправлена.\nВ ближайшее время мы с Вами свяжемся!", "", "success");
} catch (err) {
console.log(err);
}
}
function webjack_send_webhook(wj_webhook, name, phone, email, form_fields, form_info) {
try {
var xhr = new XMLHttpRequest();
var body =
'name=' + encodeURIComponent(name) +
'&phone=' + encodeURIComponent(phone) +
'&email=' + encodeURIComponent(email) +
'&form_fields=' + encodeURIComponent(JSON.stringify(form_fields)) +
'&form_info=' + encodeURIComponent(form_info) +
'&utm_source=' + webjack_get_url_parameter('utm_source') +
'&utm_medium=' + webjack_get_url_parameter('utm_medium') +
'&utm_campaign=' + webjack_get_url_parameter('utm_campaign') +
'&utm_content=' + webjack_get_url_parameter('utm_content') +
'&utm_term=' + webjack_get_url_parameter('utm_term') +
'&roistat=' + webjack_get_cookie('roistat_visit');
xhr.open("POST", wj_webhook, true);
xhr.setRequestHeader('Content-type', 'application/x-www-form-urlencoded');
xhr.send(body);
} catch (err) {
console.log(err);
}
}
function webjack_get_url_parameter(name) {
try {
name = name.replace(/[\[]/, '\\[').replace(/[\]]/, '\\]');
var regex = new RegExp('[\\?&]' + name + '=([^&#]*)');
var results = regex.exec(location.search);
return results === null ? '' : decodeURIComponent(results[1].replace(/\+/g, ' '));
} catch (err) {
console.log(err);
}
}
function webjack_get_cookie(name) {
try {
var matches = document.cookie.match(new RegExp(
"(?:^|; )" + name.replace(/([\.$?*|{}\(\)\[\]\\\/\+^])/g, '\\$1') + "=([^;]*)"
));
return matches ? decodeURIComponent(matches[1]) : undefined;
} catch (err) {
console.log(err);
}
}
Формы на сайте
- Откройте настройку формы.
- В действии после отправки выберите «Выполнение JavaScript кода».
- Вставьте вызов
webjack(name, phone, email, fields, "");.
- Повторите для всех нужных форм и опубликуйте страницу.
Действие «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- номер без символа+. - Чтобы убрать
+у телефона, в значении нажмите «Фн» и выберите «Формат номера телефона».
- Нажмите «Сохранить».
Запустите обработку
- В обработку начнут поступать данные из настроенного источника.
- По очереди выполнятся все добавленные действия.
- Входящие данные, статус и история отобразятся в «Истории операций».