Передача заявок из сайтов на MODX в другие сервисы → Envybox. Создание лида
Получайте заявки оставленные в формах сайтов, сделанных на MODX
и на основе этих данных создавайте сделки в Envybox
Шаг 1. Добавьте “Источник данных”, для этого нажмите на кнопку "Добавить"
в качестве "Источника данных" нужно выбрать "форма":
[Опционально] Можно заполнить раздел "Параметры" и раздел "Cookies"
Перечислите названия UTM-меток и других параметров визита посетителя сайта, которые вам необходимо получать вместе с заявкой.
Например:
utm_source
utm_medium
utm_campaign
utm_content
utm_term
Перечислите названия Cookie, которые надо получить из сеанса пользователя. Например, для получения кода роистат укажите:
roistat_visit
Нажмите на кнопку "Сохранить"
Шаг 2. Разместите полученный код на каждой странице сайта, где находятся формы перед закрывающим тегом </body>:
Шаг 4. Отправьте тестовую заявку.
Заполните и отправьте форму на сайте.
После этого в журнале операций должна появиться новая запись
Шаг 5. Заканчите настройку источника
Снова зайдите в настройки источника данных. Нажмите на кнопку "Изменить".
Нажмите на кнопку "Получить"
Это действие добавит все поля, которые пришли в вашем тесте, в настройки источника. Нажмите наа кнопку "Сохранить"
На этом настройка источника закончена, можно приступать к настройке действий, которые вы хотите выполнить с данными заявки.
Создание лида в 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. После заполнения всех полей нажимаем кнопку "Сохранить".
Запустите обработку
Нажмите на кнопку "Запустить"
С этого момента данные будут обрабатываться.
Как все будет работать?
- В обработку будут поступать данные из настроенного вами "Источника данных"
- Поочередно будут выполняться все действия, которые вы настроили
- Все поступающие в обработку данные, а также статус и история их обработки будут отражаться в "Истории операций"
В случае возникновения каких-либо ошибок в процессе обработки, вы получите письмо-уведомление на email.
Если вы обнаружили ошибку или неточность в описании, либо что-то не понятно, напишите нам в чат на сайте. Мы внесем правки.