game-lead.ru → Создание заявки в MacroCRM (API)

 

Настройка получения данных из game-lead.ru

Список Шагов:
Шаг 1. Добавления источника

Шаг 2. Настройка отправки данных из game-lead.ru

Шаг 3. Отправка тестового лида из game-lead.ru

Шаг 4. Настройка получения данных

Шаг 1.  Добавления источника

 

Шаг 1.1 Нажмите на кнопку "Добавить".
Шаг 1.2 Выберите источник данных "HTTP-Запрос (Webhook)".

Шаг 1.3 Не изменяя параметров, нажмите кнопку "Сохранить"

Шаг 1.4 Скопируйте ссылку.

 

Шаг 2. Настройка отправки данных из game-lead.ru
Настройте отправку заявок из game-lead.ru.

Перейдите в Настройки вашего проекта в  game-lead.ru.

1. Выбирите  пункт меню "Проекты"
2. Нажмите в вашем проекте на кнопку "Настроить"

1. Выберите пункт меню "Интеграции".
2. Перейдите в блок Вебхук GameLead. Укажите ваш адрес webhook в поле"Укажите url" из шага Шаг 1.4
3. Нажмите на кнопку "Сохранить "
4. Нажмите на кнопку "Сохранить". 

Шаг 3. Отправка тестового лида из game-lead.ru
Отправьте Тестовый лид из game-lead.ru.
После того как отправили тестовый лид, зайдите в обработку в webjack.ru:

1. Перейдите  в блок "Источник данных".
2. Нажмите  кнопку Изменить.
3. Нажмите кнопку Получить. После нажатия на кнопку получить появится параметр "GameLead"
4. Нажмите кнопку Сохранить.

На скринах ниже показано как это сделать.

Шаг 4. Настройка получения данных 
Добавляем в обработке действие JSON-Парсер:

Шаг 4.1 Выберите пункт меню "Парсер"

Шаг 4.2 Добавьте  в поле JSON  "Параметр GameLead".
Добавьте все необходимые  поля с данными в формате "JSON" приходящие из game-lead.ru.
Ниже мы видем какие данные приходят в параметр GameLead

Параметр GameLead

{"contact":"+7(999) 999-9999", "present":"\u041f\u043e\u0434\u0430\u0440\u043e\u043a", "ref":"https:\/\/game-lead.ru\/e8991e16fa08d899d2f5f97b9fbd4ad9?", "coupon":"NMJK-ERTN", "unix_time":"1718777487"}

Ниже мы рассмотрим пример как получить данные из  полей contact, present, coupon
Чтобы получить их мы должны настроить JSON-парсер следующим образом:

Имя:	Путь:
contact	["contact"]
Выигрыш	["present"]
Купон	["coupon"]

Подробнее про парсинг данных вы можете посмотреть у нас в инструкции:
Парсинг данных в формате JSON

Нажмите на кнопку "Сохранить".

На этом настройка получения данных о поступивших заявках из game-lead.ru закончена.
Заявки для квиза, для которого вы настроили отправку, будут поступать в обработку.
Далее можно настроить действия по отправке этих данных в amoCRM, Bitrix24, Telegram и др.

Настройка действия по отправке данных в MacroCRM

Для передачи данных вам потребуется добавить в MacroCRM строку с названием сайта

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

Сделать это можно в MacroCRM в разделе "Компания → Интеграции"

Далее для настройки вам понадобится Сайт (Домен) и App_secret (Защищенный ключ).

Подготовка данных для отправки в MacroCRM

Для отправки данных в MacroCRM нужно выполнить несколько простых подготовительных шагов.

Шаг 1. Отформатировать текущую дату в виде нужном MacroCRM

В обработке Webjack добавьте действие "Форматирование даты" со следующими настройками

Шаг 2. Посчитать Хеш MD5

Добавьте действие "Хэш MD5" добавьте в поле "Данные" три значения без пробелов между ними:

- Сайт(Домен)
- Дата
- App_secret

Как показано на рисунке

Шаг 3. Сформировать данные для отправки.

Добавьте действие "Form Urlencoded". И добавьте в него требуемы поля.

Минимально необходимые поля указаны на рисунке:

Перечень полей, которые можно заполнить можно найти в документации MacroCRM по ссылке https://help.macrodigital.ru/manual/integracii/sait_kompanii/integracija_s_saitom.html

Ниже мы перечислим, поля которые уже успешно передавали в интеграциях:

domain - имя сайта, который вы добавили на страницу интеграций
time - время, в формате unix timestamp, мы формировали его в первом действии
token - Хэш MD5, который мы сформировали во 2 действии
action - "buy" - форма подачи заявки на покупку
name - имя клиента
phone - телефон клиента
email - емайл клиента
tags - теги через запятую
message - Комментарий к заявке
utm_source - utm метки
utm_medium - utm метки
utm_campaign - utm метки
 

Отправка данных в MacroCRM

Теперь осталось только отправить сформированные данные в MacroCRM. Для этого добавьте действие "HTTP-запрос" со следующими настройками:

Метод: POST
Адрес: 
https://api.macroserver.kz/estate/request/ - если ваша MacroCRM находиться в Казахстане
https://api.macroserver.ru/estate/request/ - если ваша MacroCRM находится в России
Тело: В это поле передаем данные сформированные в предыдущем действии.
Заголовок:
Content-Type: application/x-www-form-urlencoded

Если все настройки сделаны правильно, то после поступлении лида в источник, данные будут автоматически переданы в MacroCRM