Битрикс24. Создание лида по API

Выберите “Источник данных”

Это могут быть лид-формы Facebook, ВКонтакте, myTarget (Одноклассники), Tilda, PlatformaLP и т.д.

Также в качестве "Источника данных" можно выбрать произвольные http-запросы. Это универсальный способ приема произвольных запросов от разных сервисов.

В зависимости от выбранного источника вам будет доступен перечень полей, которые будут поступать в обработку.

Например, если вы выбрали в качестве источника лид-формы Facebook, то вам будут доступны как минимум следующие поля:

ID лида, Дата и время создания, ID объявления, Название объявления, ID группы объявлений, Название группы объявлений, ID кампании, Название кампании, ID формы, Название формы, ID страницы, Название страницы, Full name, Phone number

Вы можете использовать любое из этих полей, при выполнении нужных вам действий.

Зачем использовать 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