Вконтакте. Лид-формы → Envybox. Создание лида

Получайте заявки из лид-форм ВКонтакте (Приложение "Форма сбора заявок")

и на основе этих данных создавайте сделки в Envybox

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

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

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

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

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

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

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

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

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


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

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


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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Создание лида в Envybox.

1. Подготовка данных для отправки.

1.1. В разделе "Действия" нажмите кнопку "Добавить".

1.2. Выберите в разделе "JSON" пункт "Компоновщик".

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

 

Ниже представлен список обязательных и необязательных полей для передачи.

  • method “create” - метод создания заявки (обязательное поле)
  • pipeline_id - идентификатор воронки сделки(необязательное поле) если не указано - используется воронка по - умолчанию
  • employee_id - ответственный сотрудник, который будет указан ответственный у созданной сделки,не обязательное поле,если не указано будет доступна всем для взятия в работу
  • inbox_type_id - идентификатор типа входящего обращения,если не указан, используется значение по - умолчанию
  • visit_id - идентификатор визита, если клиент использует виджеты Envybox на сайте, позволяет получить дополнительную информацию автоматически о сохраненном посетителе, забирается из Cookie посетителя, наименование WhiteCallback_visit
  • region - название региона(текстом), в котором находится клиент; передается на русском языке согласно субъектам РФ, Украины,Казахстана, (Москва и Санкт - Петербург являются отдельными регионами согласно классификации, их можно передать именно в таком виде)
  • timezone - часовой пояс, в формате UTC(указывается в диапазоне от UTC - 12: 00 до UTC + 12: 00), по - умолчанию Московское время(значение UTC + 03: 00); при одновременном указании и часового пояса и региона,приоритетным считается часовой пояс; если регион и часовой пояс не указаны, но передано значение идентификатора визита(visit_id) будет использован регион, определенный автоматически согласно параметрам визита
  • record_link - Ссылка на запись - прикрепится к лиду

values - массив значений полей

  • Список доступных полей
  •   name - имя
  •   phone - телефон
  •   email - email
  •   comment - комментарий
  •   utm_source - значение utm метки utm_source
  •   utm_medium - значение utm метки utm_medium
  •   utm_campaign - значение utm метки utm_campaign
  •   utm_content - значение utm метки utm_content
  •   utm_term - значение utm метки utm_term
  •   google_client_id - Google Client ID
  •   yandex_client_id - Yandex Client ID
  •   tags - тег сделки
  •  

custom - массив произвольных полей(передаются объекты полей)

    •  
    • input_id - идентификатор поля
    • value - значение
    • contact_data - контактные данные
    • type - тип контактных данных(viber, instagram, whatsapp, telegram, vkontakte, facebook, skype, note, position, work_phone, home_phone)

Для типа “work_phone” можно указать добавочный номер - addon

1.4. После указания всех необходимых данных нажмите кнопку "Сохранить".

2. Отправка данных в Envybox.

2.1. В разделе "Действия" нажмите кнопку "Добавить".

2.2. Выберите в разделе "HTTP" пункт "Запрос".

2.3. Заполните поля http запроса как показано на скриншоте.

Метод: POST

Адрес: после https:// укажите урл вашего аккаунта в Envybox, к примеру test.envycrm.com

api_key можно получить в интерфейсе CRM в разделе "Настройки" - "Интеграция" - "API"

2.4. После заполнения всех полей нажимаем кнопку "Сохранить".

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

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

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

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

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

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

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