Интеграция

Получение лидов из ВК Рекламы → Создание контакта и сделки в StoCRM

В этой инструкции мы по шагам с примерами разберём, как настроить оба сервиса и связать их между собой:

Настройте получение лидов из ВК Рекламы (VK Ads): подключение кабинета, выбор лид-форм и автоматический сбор заявок из рекламы.
Создание контакта и сделки в StoCRM через HTTP form-urlencoded: SID и POST https://ACCOUNT/api/external/v1/offer/new/with_contact по документации API.

Отдельные инструкции: источник «Получение лидов из ВК Рекламы» · действие «Создание контакта и сделки в StoCRM»

Создание подключений

Если вы ещё не создавали нужные подключения - не пропускайте этот блок: без них настроить интеграцию не получится. Если подключения уже есть в WebJack, можно сразу перейти к настройке источника и действия ниже.

Подключение VK Рекламы

Создание подключения

В меню откройте «Подключения» и нажмите «+».
Выберите тип «Реклама VK».
Укажите название подключения.
Нажмите «Подключить», если доступ есть у вас, или «Подключить по ссылке», если доступ у другого пользователя.

Доступ к кабинету

Для личного кабинета выберите «Предоставить доступ к аккаунту»; для агентского - «Предоставить доступ к аккаунту клиента».
Нажмите «Предоставить доступ» и завершите авторизацию в VK Ads.

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

В левом меню откройте «Обработки» и нажмите «+».

integrations: В левом меню откройте «Обработки» и нажмите «+»

В списке типов источника выберите «Лиды Рекламы VK» и нажмите кнопку «Выбрать».

Источник «Лиды Рекламы VK»

Заявки из лид-форм ВК Рекламы (VK Ads) начнут поступать в обработку после выбора подключения и нужных форм.

Подключение и формы

В поле «Подключение» выберите подключение к рекламному кабинету ВК Рекламы (VK Ads).
Если нужны лиды только с части форм - отметьте их галочками.

Получение лидов из ВК Рекламы: Если нужны лиды только с части форм - отметьте их галочками

Если нужны лиды со всех лид-форм - ничего не отмечайте.

Получение лидов из ВК Рекламы: > Пустой список форм означает сбор заявок со всех лид-форм кабинета

Сохранение

Нажмите «Сохранить».

Получение лидов из ВК Рекламы: Нажмите «Сохранить»

Тестирование источника

Чтобы отправить тестовый лид из сервиса "ВК Реклама"

Перейдите в кабинет https://ads.vk.ru/
В левом меню выберите пункт "Лид-формы и опросы"
Нажмите на кнопку в виде конверта "Отправить тестовый лид", напротив нужной лид-формы.

Действие «Создание контакта и сделки в StoCRM»

StoCRM создаёт контакт и сделку одним external API запросом. Передайте SID и поля offer/new/with_contact form-urlencoded.

Перейдите в обработке во вкладку "Действия" и нажмите на кнопку "Добавить действие"
actions: Перейдите в обработке во вкладку Действия и нажмите на кнопку Добавить действие

SID

В StoCRM получите SID для external API.
Замените ACCOUNT на адрес вашего аккаунта StoCRM.

Параметры запроса

Действие настраивается через «HTTP-запрос».

Выберите «HTTP-запрос» и нажмите «Выбрать».
В поле «HTTP-метод» выберите POST.
В поле «Адрес» укажите https://ACCOUNT/api/external/v1/offer/new/with_contact.
В блоке «Параметры» передайте SID и поля контакта и сделки.
В «Заголовки» добавьте Content-Type со значением application/x-www-form-urlencoded.
Нажмите «Сохранить».

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

В обработку начнут поступать данные из настроенного источника.
По очереди выполнятся все добавленные действия.
Входящие данные, статус и история отобразятся в «Истории операций».

integrations: Входящие данные, статус и история отобразятся в «Истории операций»