bothelp.io → Создание заявки в MacroCRM (API)

 

Список шагов:
Шаг 1.Добавления источника.
Шаг 2. Настройка отправки данных из bothelp.io.
Шаг 2.1  Настройте действие по отправке данных
Шаг 3. Настройка получения данных

Настройка получения данных из bothelp.io

Шаг 1. Добавления источника.
Выберите источник данных "HTTP-Запрос (Webhook)".

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

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

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

Шаг 2. Настройте отправку данных в вашем bothelp.io.

Перейдите в Боты

Редактировать

Нажмите  кнопку плюс "✢"

Выберите кнопку Действия "⚡︎"

 

Шаг 2.1  Настройте добавленое действие "Действия 1".

1. Нажмите на  "Действия 1".
2. Нажмите на кнопку "Добавить действие".
3. Из списка выберите "Отправить данные подписчика через Webhook".
4. Вставьте скопированную ссылку из webjack.ru "Шаг 1.2" в поле "Отправить данные подписчика через Webhook".
5. Нажмите на кнопку "Сохранить и закрыть".

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

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

Шаг 3.2  Настройте действие "JSON-парсер", как указано на рисунке ниже.
добавьте все необходимые  поля с данными в формате "JSON" приходящие из bothelp.io

												HTTP-запрос Тело	{"bothelp_user_id":2, "created_at":1718979405, "name":"TestName", "first_name":"TestFirstName", "last_name":"", "profile_link":"", "email":"", "phone":"79999999999", "ref":"", "utm_medium":"", "utm_source":"", "utm_campaign":"", "utm_term":"", "utm_content":"", "conversations_count":1,"first_contact_at":1718977647, "last_contact_at":1718979404,"user_id":"963133715", "messenger_username":"UserName", "created_at_show":"21/06/2024 14:16:45 UTC", "cuid":"8tz6.2"}

Чтобы получить  поля name, phone, messenger_username мы должны настроить JSON-парсер следующим образом:

Имя:	Путь:
Имя	["name"]
Телефон	["phone"]
Телеграм	["messenger_username"]

В поле "JSON" выберите значение поля "HTTP-запрос. Тело" из списка доступных полей.

В блок "Поля JSON" укажите настройки для получения списка нужных полей.
На скрине выше выбраны стандартные поля из телеграм подписчика.
Также можно добавить кастомные(доп. поля) которые вы создавали сами в боте.

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

На этом настройка получения данных о поступивших заявках из bothelp.io закончена.
Заявки для компании, для которой вы настроили отправку, будут поступать в обработку.
Далее можно настроить действия по отправке этих данных в 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