Создание входящего вебхука
Чтобы создать новый вебхук, перейдите в раздел Приложения → Разработчикам → Другое → Входящий вебхук.
В открывшемся окне выберите права CRM и скопируйте URL-адрес вебхука из поля Вебхук для вызова rest api, он будет использоваться в дальнейшей настройке интеграции.
По завершении настроек Сохраните изменения.
Затем перейдите в административную панель Agora, в раздел Настройки интеграции.
Скопированный ранее URL необходимо разбить на 3 части и вставить в разные поля:
- до цифры (включая символ «/») — в Портал Битрикс24;
- цифру — в ID администратора;
- оставшуюся часть (без символа «/») — в поле Ключ вебхука.
Останется только установить или оставить пустым чекбокс Отправлять вебхук о регистрации пользователя, выбрать Статус создания лида и Статус создания сделки — при каких статусах заказа в Agora будет создаваться лид и сделка в Битрикс24, а затем Сохранить настройки.
Добавление поля ИНН
Чтобы начать добавление поля ИНН, в разделе Лиды нужно:
- Зайти в карточку лида.
- Кликнуть по кнопке Создать поле.
- В выпадающем списке выбрать тип поля Число.
- Добавить название поля — «ИНН», выставить чекбокс Показывать всегда, затем Сохранить изменения.
- Далее необходимо кликнуть правой кнопкой мыши рядом с полем ИНН и выбрать Просмотреть код (актуально для браузера Google Chrome).
- После этого нужно нажать на курсор в правой части экрана и навести на поле ИНН в левой части экрана.
- После наведения будет выделена строка в области с кодом. Рядом с выделенной строкой необходимо найти идентификатор поля ИНН, который который содержит в себе UF_CRM. Строку с кодом внутри кавычек "" вместе с цифрами нужно скопировать.
- Перейти в административной панели проекта Agora в раздел Настройки интеграции и вставить скопированные данные в поле Код поля ИНН в Bitrix24 в формате UF_CRM_ХХХХХХХХХХХХХ, где Х — цифры кода. По итогу настроек Сохранить изменения.
Добавление бизнес-процесса для лидов в Битрикс24
Далее нужно вернуться в любой лид Битрикс24 и перейти во вкладку Роботы.
В колонке Качественный лид найдите кнопку Редактировать в дизайнере Бизнес-процессов и кликните по ней.
Откроется окно визуализации бизнес-процессов. К уже отображающейся схеме перетащите к стрелке после блока Начало из вкладки Конструкции блок Условие.
Затем перетащите к стрелке после правого блока Условие блок Создание новой сделки из раздела CRM.
Кликните по значку у левого блока Условие. В открывшемся окне укажите:
- Тип условия — Поле документа;
- Поле документа — Название лида;
- Условие — не равно;
- Значение — введите: «Название_проекта.ru — Создан заказ на платформе».
Нажмите Сохранить.
В правом Условии нужно указать:
- Тип условия — Поле документа;
- Поле документа — Название лида;
- Условие — равно;
- Значение — введите: «Название_проекта.ru — Создан заказ на платформе».
Сохраните изменения.
Блок Создание новой сделки должен быть заполнен так:
- Название — {{Название лида}}
- Сумма — {{Возможная сумма сделки}}
- Комментарий — {{Комментарий}}
- Лид — {{ID}}
- Покупатель магазина — {{Имя}}{{Отчество}}{{Фамилия}}
- Контакт — {{Контакт}}
- Компания — {{Компания}}
Настройки формы необходимо Сохранить.
После этого нужно Сохранить и сам шаблон бизнес-процесса.
Теперь интеграция Agora с Битрикс24 может считаться завершенной. Она готова к полноценной работе: лид будет создаваться при регистрации на сайте и создании заказа на сайте, а сделка формироваться после оплаты. Вебхук остается доступным до тех пор, пока не будет удален администратор, его создавший.