Инструкция по интеграции 1С-Битрикс с сервисом Webjack

Инструкция по интеграции сайтов на 1С-Битрикс с платформой интеграций Webjack, используя модуль "Webjack — интеграция с инфоблоками, веб-формами и почтовыми событиями".

Сервис Webjack позволяет без программистов выполнить интеграцию с основными популярными CRM и так же отправить данные в Telegram или например Google Таблицы. У сервиса есть бесплатный демо период в 5 дней, у модуля есть тестовый период в 14 дней, чего достаточно для настройки тестовых интеграций и проверки работы. Приступим к описанию основных шагов, необходимых для настройки.

Модуль устанавливается из маркетплейса Битрикс и не требует какой-то дополнительной настройки. Необходимо установить модуль на сайт через админ-часть сайта или используя маркетплейс с вводом адреса сайта в форме.

Для начала необходимо зарегистрироваться в сервисе Webjack после регистрации вы попадете на страницу "Обработки", на которой необходимо справа нажать на кнопку "Создать". Скриншот:

Вводим название обработки, понятное для вас и нажимаем на кнопку "Сохранить". Далее нас перенаправит на общую страницу настроек обработки. Для того чтобы начать получать данные необходимо изначально создать источник данных. Скриншот:

На странице выбора "Источника данных" находим пункт: "Запрос (Webhook)" и выбираем его. Скриншот:

После выбора нам необходимо выбрать HTTP-метод "POST", остальные поля необходимо заполнять только если у вас есть какие-то свои ограничения или кастомные настройки. После выбора метода нажимаем на кнопку "Сохранить". Скриншот:

После сохранения у вас должен появиться адрес Webhook, который автоматически генерируется сервисом. Страница должна выглядеть следующим образом, скриншот:

Далее нам необходимо создать действие, скриншот:

Выбираем тип действия "JSON" - Парсер, скриншот:

Далее необходимо заполнить настройки, с помощью которых данные переданные с сайта на CMS 1C-Bitrix, будут обработаны сервисом для дальнейшей передачи.

Пример заполнения данных для форм на сайте, у которых есть поля: "Имя", "Телефон", "E-mail", "Комментарий". Скриншот:

Обратите внимание на правый столбец "Действие при отсутствии". Если вам нужны строгие права валидации получаемых данных, тогда необходимо выбрать чек-бокс "Прервать обработку", иначе выставляем чек-боксы как на скриншоте с пунктом "Вернуть пустое значение". Соответственно при таком значении, если в присланном JSON, не будет данных в любом из пунктов, то обработка все равно завершится и данные отправятся далее. После внесения всех настроек нажимаем на кнопку "Сохранить".

Следующим пунктом приведем телефон к одному виду, для того чтобы все телефоны имели у нас одинаковый вид. Для этого необходимо добавить еще одно действие: "Добавить действие" - "Преобразования" - "Номер телефона". Скриншот:

На следующей вкладке необходимо заполнить следующими настройками, скриншот:

Кроме того на данной вкладке вы можете сделать собственные преобразования номера телефона, которые требуются именно вам.

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

Для того чтобы создать сделку в amoCRM, нам необходимо изначально создать контакт, а следующим действием создать сделку.

Создадим новое действие: "Добавление контакта в amoCRM", скриншот:

После добавления необходимо авторизоваться в AmoCRM, и заполнить поля для создания контактов. Кроме того можно сразу выбрать обработку дублей, как создавать ID и что использовать в виде имени контакта. Скриншот первых настроек:

Ниже в настройках выбираем поля "Телефон" и "E-mail", скриншот:

После чего нажимаем на кнопку "Сохранить". На этом создание действия с добавлением контакта в AmoCRM завершено. И можно переходить к действию "Создание сделки".

Переходим к добавлению нового действия: "Добавить" - "AmoCRM" - "Добавление сделки в AmoCRM". На страницах настроек выбираем уже авторизованную AmoCRM, и заполняем настройки:

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

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

Добавляем новое действие: "Добавить" - "AmoCRM" - "Добавление примечания в AmoCRM" и добавляем следующие настройки (на примере поля комментарии у формы):

Приведенный пример выше на скриншоте показывает как добавить поле "комментарий" в примечание к сделке. Вы так же можете изменить данные настройки под ваши требования.

На этом настройка в сервисе Webjack завершена и нам необходимо теперь внести настройки в модуль в админ-части сайта.

Для этого переходим по пути: "Настройки" - "Настройки модулей" - "Интеграция с сервисом WebJack". На странице настроек у нас есть несколько типов настроек, мы можем отправлять данные по одному url в Webjack, либо отдельно для каждого типа события.

Скриншот:

URL для отправки необходимо скопировать со страницы "Обработки" в сервисе Webjack и вставить в поле "Адрес для HTTP-запроса". Здесь вы можете сделать как отдельные так и общие. Наш пример покажем на основе общего одного URL. После вставки URL-адреса необходимо нажать "Применить" на странице настроек.

После добавления URL-адреса необходимо выбрать веб-формы или инфоблоки куда записываются заявки с форм сайта. Скриншот:

Можно выбрать как отдельно какой-то один пункт, или выбрать сразу несколько, если допустим у вас формы работают как на инфоблоках, так и на веб-формах. После выбора необходимо сохранить.

На этом настройки завершены и осталось только включить обработку в сервисе Webjack, скриншот:

После включения можно начинать тестировать отправку форм и проверять результат обработки как в сервисе Webjack, так и в amoCRM.

В сервисе Webjack есть раздел "Журнал операций" куда будут записываться последние операции и их статус. Покажем на примере:

Если при обработке возникли проблемы, вы можете открыть любую операцию и посмотреть статусы, которые будут описаны в сервисе.

По всем вопросам касающихся интеграции Webjack с сайтом на 1С-Битрикс вы можете писать нам на почту: [email protected].