u-on.ru → Битрикс24. Создание лида по API

 

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

Ощая схема получения данных из U-ON следующая:

1. На наш вебхук приходит уведомление о событии произошедшем в U-ON (оно содержит какие-то данные, но далеко не все которые обычно требуются)

2. Из сообщения извлекаем идентификатор заявки или обращения.

3. Отправляем запрос в U-ON, чтобы получить полные сведения об обращении или заявке, по которой пришло уведомление

4. Парсим из ответа нужные поля

5. Настраиваем действие по отправке данных по назначению.

 

Шаг 1. Настроить прием данных от U-ON на вебхук.

Выберите источник данных "HTTP-Запрос (Webhook)".

Нажмите на кнопку "Добавить"

В список параметров добавьте 1 параметр (r_id), как указано на рисунке ниже

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

Скопируйте ссылку.

 

Шаг 2. Настройте отправку уведомлений в личном кабинете u-on.ru.

Перейдите в меню "Интеграция".  Выберите пункт "API / WebHooks"

Выбирите тип уведомления, который хотите отправлять на вебхук, например "Создание обращения". Вставьте скопированную ссылку в поле "URL", как указано на рисунке ниже.

В следующих действиях мы настроем получение дополнительных данных по обращению или заявке.

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

Выберите действие "HTTP-запрос"

Адрес: 
https://api.u-on.ru/{api}/request/{r_id}.json - если вы хотите получить данные по заявке
либо
https://api.u-on.ru/{api}/lead/{r_id}.json - если вы хотите получить данные по заявке

Ключ api можно взять тут https://{id}.u-on.ru/api.php
{id} - ваш id в u-on.ru

В следующем шаге мы настроем получение самих данных по обращению либо заявке.

Шаг4. Создаем в обработке действие JSON-Парсер:

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

Добавьте в настройки поле  "HTTP-запрос[Содержимое ответа]" и добавьте все поля которые необходимы для получения данных.

id - ["request"][0]["id"]
dat_lead - ["request"][0]["dat_lead"]
dat - ["request"][0]["dat"]
dat_close - ["request"][0]["dat_close"]
status_id - ["request"][0]["status_id"]
status - ["request"][0]["status"]
office_id - ["request"][0]["office_id"]
office_name - ["request"][0]["office_name"]
travel_type_id - ["request"][0]["travel_type_id"]
travel_type - ["request"][0]["travel_type"]
manager_id - ["request"][0]["manager_id"]
manager_surname - ["request"][0]["manager_surname"]
manager_sname - ["request"][0]["manager_sname"]
manager_name - ["request"][0]["manager_name"]
source_id - ["request"][0]["source_id"]
source - ["request"][0]["source"]
Нажмите на кнопку "Сохранить".

На этом настройка получения данных о поступивших заявках из u-on.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