Руководство пользователя HubEx

Краткие инcтрукции по работе, основные понятия и первые шаги по освоению платформы.

Интеграция с Битрикс 24

В этом разделе вы научитесь:

В системе HubEx возможна интеграция с Битрикс 24. Рассмотрим подробнее, как это сделать:

  1. Для начала Вам необходимо зайти в консоль администратора, сделать это можно, нажав на иконку пользователя в правом верхнем углу, где затем нажать "Консоль администратора".
  2. После того, как Вы зашли в Консоль Администратора, Вам потребуется зайти в разделе "Интеграция" на вкладку "Служебные пользователи".
  3. Теперь Вам необходимо активировать Пользователя API. Переключив тумблер, выберите какие роли получат возможность использовать интеграцию со сторонними системами (рекомендуем выдавать такие права только Начальнику сервисной службы, либо Администратору). Также выберите участки, информацию по которым хотите интегрировать. Осталось нажать на кнопку "Сгенерировать" и скачать токен доступа.
  4. В скачанном текстовом документе скопируйте ключ.
  5. Теперь зайдите в разделе "Интеграция" на вкладку "Ключи". Создайте 2 ключа:
    • С названием "hubex_token", в поле "Значение" которого введите код из скачанного файла;
    • С названием "request_path", в поле "Значение" которого введите "HubEx.INT.Bitrix24.Api/Api/webhook".
    После создания двух ключей вкладка "Ключи" должна выглядеть так:
  6. Теперь перейдите на сайт Битрикс 24, где, например, с помощью поиска перейдите на вкладку "Вебхуки". Нажмите на кнопку "Добавить вебхук", после чего выберите "Входящий вебхук". На открывшейся странице с правами доступа, Вам необходимо выбрать только пункты "Задачи" и "Задачи(расширенные права)", а затем внизу страницы нажать кнопку сохранить.
  7. После того, как Вы сохранили новый вебхук, у Вас появится ссылка, которую вам необходимо скопировать до "/profile/".
  8. Осталось зайти обратно в Консоль администратора на вкладку "Webhook'и", где нажать "Добавить webhook".
  9. Укажите желаемое название для нового Вебхука, а затем в поле "URL webhook'a" введите "http://localhost:19081/${request_path}/${hubex_token}/?bitrix24Url=", где после знака равно (без пробелов) вставьте адрес, скопированный с Битрикс 24. Осталось привязать новый Вебхук к событию или же к определенной стадии заявки. Нажмите кнопку "Активировать", чтобы сразу же использовать новый вебхук. После введения всей информации, не забудьте нажать кнопку "Сохранить."
  10. Теперь при создании заявки в HubEx, заявка будет появляться и в Битрикс 24. Чтобы найти её, достаточно зайти на вкладку "Задачи и проекты" на сайте Битрикс 24. Стоит отметить, что если у вас уже были созданы заявки, то новая заявка отобразится в конце списка. Нажав на название заявки, Вы сможете увидеть подробную информацию.