game-lead.ru → Битрикс24. Создание лида по 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 и др.

Зачем использовать API?

В некоторых случаях имеющуюся интеграцию не получается использовать. Например иногда в коробочных версиях битрикс или когда не удается установить приложение Webjack в битрикс24.

Создайте входящий вебхук

Шаг 1. Перейдите в меню "Все приложения" → "Готовые сценарии" → "Другое"

Выберите "Входящий вебхук"

Выберите права доступа к "CRM", скопируйте "Вебхук для вызова rest api" и сохраните

С настройками на стороне битрикс мы закончили. Теперь можно переходить к настройкам передачи данных.

Отправка данных в Битрикс24 через Вебхук

Шаг 1 . Подготовим данные для отправки в Битрикс. Для этого добавьте действие "Form Urlencoded"

Добавьте параметры и их значения.
Основные параметры:

fields[TITLE] - Название лида (Обязательное поле)

fields[SOURCE_ID] - ID источника

fields[NAME] - Имя

fields[PHONE][0][VALUE] - Телефон

fields[PHONE][0][VALUE_TYPE] - Тип телефонного номера (Например: WORK)

fields[EMAIL][0][VALUE] - Email

fields[EMAIL][0][VALUE_TYPE] - Тип email (Например: WORK)

fields[COMMENTS] - Комментарий

fields[ASSIGNED_BY_ID] - ID ответственного

UF_CRM_1456385609 - Так указываются пользовательские поля. Код для каждого поля надо смотреть в Битрикс24

Полный список возможных полей можно посмотреть в документации Битрикс24 https://dev.1c-bitrix.ru/rest_help/crm/leads/crm_lead_fields.php

 

 

Шаг 2. Добавьте действие "HTTP-запрос"

Вставьте адрес входящего вебхука, скопированный в битрикс24. Добавьте в поле "Тело", данные, сформированные на предыдущем шаге.

Добавьте к нему строку crm.lead.add.json - для создания лидов в Битрикс

На этом настройка закончена. Теперь данные, которые будут поступать в вашу обработку будут отправляться в битрикс24 по API