Вконтакте. Лид-формы → Создание заявки в MacroCRM (API)

 

Выберите Источник "VK. Лид-формы"

Выберите пользователя Вконтакте

Нажмите на кнопку выбора для поля "Пользователь VK"

Нажмите на кнопку “Подключить”

Авторизуйтесь в ВКонтакте (пользователь должен имеет доступ к лид-формам страницы и к рекламной кампании)

Укажите название для подключения к ВКонтакте

Нажмите кнопку “Выбрать”

Выберите группу ВКонтакте

Нажмите на кнопку выбора поля "Группа VK".

Выберите группу ВКонтакте и нажмите кнопку "Получить токен"

Нажмите "Разрешить"

После этого выберите вашу группу и нажмите кнопку "Выбрать"

Выберите лид-формы

После выбора группы будут отображены все ее лид-формы.

Если необходимо получать заявки только с некоторых форм, то надо отметить нужные.

Если требуется получать заявки со всех форм, то ничего не отмечайте. 

После того как пользователь заполнит лид-форму, данные будут автоматически поступать в Webjack.

Нажмите кнопку "Сохранить". Интеграция завершена.

Если данные не поступают в обработку Webjack, то тогда необходимо проверить подключение по инструкции ниже

Проверка подключения

Необходимо проверить действительно ли ВКонтакт подключил форму (в некоторых случаях ВКонтакте не делает этого)
Для этого необходимо зайти в настройки группы ВКонтакте и убедится, что напротив сервера WebJack горит зеленая галочка

Если напротив сервера WebJack стоит красная галочка, то значит подключение НЕ установлено.

Какие права в группе надо иметь?

Чтобы подключить группу и получить данные из лид-форм необходимо иметь в группе права "Администратор".

Альтернативные способы подключения

Если автоматически подключение не установлено, то есть 2 способа:

Вариант 1. Можно удалить созданный сервер WebJack и попробовать провести подключение описанным выше способом заново.

Вариант 2. Скопировать код подтверждения из настроек ВКонтакте и установить его в настройках WebJack

Адрес, который должен быть в настройках ВКонтакте: https://webjack.ru/webhooks/vk/group/

Выберите нужную группу из списка и нажмите на кнопку "Установить код подтверждения"

Вставьте код подтверждения, скопированный из ВКонтакте и нажмите на кнопку "Сохранить"

После этого нажмите на кнопку "Подтвердить" в настройках группы ВКонтакте

Если все сделано верно, то должна появится зеленая галочка.

После этого зайдите во вкладку "Типы событий"

И отметьте галочкой пункт "Lead forms: Новая заявка"

После этого ВКонтакте будет отправлять лиды в обработку WebJack.

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