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

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

Инструкция по интеграции Битрикс24 и HubEx

Назначение интеграции

Интеграция между Битрикс24 и HubEx позволяет автоматизировать передачу данных между системами:

Преимущества интеграции:


Подготовка к настройке

Перед началом убедитесь, что:

  1. У вас есть права администратора в Битрикс24 и HubEx.

  2. В HubEx создан служебный пользователь для API-доступа.


Настройка в Битрикс24

1. Установка приложения HubEx

  1. Перейдите в Маркетплейс Битрикс24 → найдите приложение HubEx → установите его.

  2. Откройте приложение. В нём доступны два раздела:

    • Создание робота (для автоматизации создания заявок).

    • Генерация токена (для связи аккаунтов).

2. Настройка робота для создания заявок

2.1 В Битрикс24, в приложении HubEx нажмите «Создать робота».

2.2 Перейдите в CRM → Роботы.

2.3 Выберите воронку и стадию, при переходе на которую должна создаваться заявка.

2.4 Нажмите «+» под стадией → выберите «Другие роботы».

2.5 Найдите робота «[HubEx] Создание заявки HubEx».

2.6 Настройте параметры:

2.7 Сохраните изменения.

3. Создание токена для интеграции

  1. Вернитесь в приложение HubEx в Битриск24 → нажмите «Создать новый токен».

  2. Скопируйте сгенерированный токен (он понадобится для настройки в HubEx).


Настройка в HubEx

1. Получение API-ключа

  1. Войдите в Консоль администратора HubEx.

  2. Перейдите в Интеграции → Служебные пользователи.

  3. Сгенерируйте токен доступа (API-ключ) и сохраните его.

Подробнее читайте в статье: Служебные пользователи

2. Связывание аккаунтов

  1. Откройте веб-приложение HubEx → вкладка «Интеграция с Б24».

  2. Заполните поля:

    • API-ключ HubEx: вставьте токен из консоли администратора.

    • Токен интеграции: вставьте токен из Битрикс24.

  3. Нажмите «Проверить подключение».

  4. После успешной проверки настройте:

    • Тип заявки в HubEx.

    • Воронку Битрикс24 для автоматизации.

    • Стадию на которую будет переведена сделка в Битрикс24.

  5. Сохраните изменения.


Проверка работы интеграции

  1. Тест создания заявки:

    • Переведите сделку на заданную стадию в Битрикс24.

    • Убедитесь, что заявка появилась в HubEx с корректными данными.

  2. Тест завершения заявки:

    • Завершите заявку в HubEx (стадия, которая в жизненном цикле заявки указана как Конечная стадия).

    • Проверьте, что сделка в Битрикс24 перешла на указанную стадию.


Перечень полей, которые приходят из Битрикс24 при создании заявки

  1. Название сделки в Битрикс24 переносится в поле Комментарий в HubEx

  2. Комментарий из сделки в Битрикс24 переносится в поле Комментарий в HubEx

  3. Тип заявки в HubEx задается при создании робота

  4. Критичность выбирается по заявке HubEx по умолчанию

  5. Компания-заказчик в заявке HubEx заполняется по компании из сделки Битрикс24. В случае, если такой компании нет в HubEx - будет создана новая компания


Частые вопросы (FAQ)

Q1: Что делать, если заявка не создается?

Q2: Как изменить стадию для создания заявки?

Q3: Где найти токены для повторной настройки?


Заключение

Интеграция Битрикс24 и HubEx значительно упрощает взаимодействие между отделами. Если у вас возникнут вопросы, обратитесь в поддержку HubEx или Битрикс24.

Готово! Ваши системы теперь работают согласованно. 🚀