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

Передавайте данные из u-on.ru

 

и на основе этих данных создавайте заявки в MacroCRM

 

Создайте "Обработку"

Создайте "Обработку" в Webjack. В ней настраивается что/откуда получать и куда/как передавать.

Нажмите кнопку “Создать”,

дайте название для "Обработки" и нажмите "Cохранить"

Добавьте “Источник данных”

Добавьте “Источник данных”, нажмите кнопку “Добавить

 

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

Настройка действия по отправке данных в 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

Запустите обработку

Нажмите на кнопку "Запустить"

С этого момента данные будут обрабатываться.

Как все будет работать?

  1. В обработку будут поступать данные из настроенного вами "Источника данных"
  2. Поочередно будут выполняться все действия, которые вы настроили
  3. Все поступающие в обработку данные, а также статус и история их обработки будут отражаться в "Истории операций"

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

Если вы обнаружили ошибку или неточность в описании, либо что-то не понятно, напишите нам в чат на сайте. Мы внесем правки.