Подключение Bitrix24

Для кого

Администраторы TehProf Support, которые хотят интегрировать платформу поддержки с Bitrix24: авторизация через Bitrix24, создание задач, работа с CRM-сущностями и Смарт-процессами.

Что вы получите

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

Предварительные требования

• Портал Bitrix24 (облачный) с правами администратора
• Роль администратора в TehProf Support
• Базовое понимание структуры Bitrix24 (CRM, задачи, пользователи)

Пошаговая инструкция

Шаг 1: Установка приложения из Bitrix24

Подключение TehProf Support к Bitrix24 начинается с установки приложения на ваш портал.

Вариант 1 -- Через каталог приложений Bitrix24:

• Откройте ваш Bitrix24.

• Перейдите в "Маркет" (Приложения) -> Поиск.

• Найдите "TehProf Support" (или используйте прямую ссылку, предоставленную администратором платформы).

• Нажмите "Установить".

• Подтвердите запрос разрешений (подробнее на шаге 2).

• После установки приложение появится в левом меню Bitrix24.

Вариант 2 -- Ручная установка через OAuth:

Если приложение ещё не опубликовано в каталоге или требуется подключение к конкретному серверу:

• Получите от администратора платформы URL для установки.

• Откройте URL в браузере, авторизованном в Bitrix24.

• Bitrix24 запросит подтверждение разрешений.

• После подтверждения произойдёт обмен OAuth-токенами, и приложение появится в вашем Bitrix24.

При ручной установке администратор платформы может также предоставить:

• Client ID и Client Secret для OAuth-аутентификации.
• Webhook URL для входящих уведомлений от Bitrix24.

Шаг 2: Предоставление разрешений (scope)

При установке приложение запрашивает набор разрешений (scope) для работы с данными Bitrix24. Ниже описаны запрашиваемые разрешения и зачем они нужны:

• crm -- доступ к CRM (сделки, контакты, компании, лиды). Используется для отображения истории обращений в карточках CRM и создания сущностей из тикетов.
• task -- доступ к задачам. Позволяет создавать задачи в Bitrix24 из тикетов поддержки (например, для передачи работы разработчикам).
• user -- доступ к списку пользователей. Необходим для авторизации операторов и клиентов через Bitrix24, а также для отображения имён и фотографий.
• im -- доступ к внутренним чатам. Используется для отправки уведомлений операторам в чат Bitrix24 при создании тикетов или получении новых сообщений.
• placement -- возможность встраивать интерфейс в карточки CRM (см. шаг 5).

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

Подтвердите запрос, нажав "Разрешить" или "Установить".

Шаг 3: Проверка подключения

После установки перейдите в TehProf Support -> "Настройки" -> "Интеграции" -> "Bitrix24".

На этой странице отображается:

• Статус подключения -- "Подключено" (зелёный индикатор) или "Отключено" (красный).
• Портал -- адрес вашего Bitrix24 (например, mycompany.bitrix24.kz).
• Дата подключения -- когда было установлено приложение.
• Срок действия токена -- OAuth-токены имеют ограниченный срок действия. Система автоматически обновляет их. Если статус "Токен истёк", нажмите "Переподключить".
• Разрешения -- список предоставленных scope с отметками (доступен/недоступен).

Если статус "Подключено" и все разрешения отмечены, интеграция работает корректно.

Для проверки выполните тестовый вызов: нажмите "Тест подключения". Система отправит запрос к Bitrix24 API и покажет результат (имя текущего пользователя, количество пользователей на портале и т.д.).

Шаг 4: Создание задач из тикетов

Интеграция автоматически создаёт задачу в Bitrix24 при выбранном событии заявки. Откройте Настройки → Интеграции → Bitrix24 → Задачи и настройте:

• Когда заводить задачу — выключено, сразу при создании заявки либо при переходе в выбранный статус;
• Проект и ответственный по умолчанию — ID сущностей именно подключённого портала этого тенанта;
• Закрывать задачу вместе с заявкой;
• Соответствие состояний — двусторонняя карта «состояние задачи ↔ статус заявки».

После срабатывания в заявке появляется ссылка на задачу. Ручной кнопки с отдельной формой создания задачи в карточке заявки нет. Задача всегда создаётся в портале, подключённом к текущему тенанту; служебные настройки другого портала не используются.

Ниже аналогично настраиваются сделки: момент создания, направление/воронка, соответствие статусов заявки стадиям сделки и карта полей. Синхронизация стадий сделки идёт от заявки к CRM.

Шаг 5: Настройка CRM-встроек (placements)

CRM-встройки позволяют добавить элемент интерфейса TehProf Support прямо в карточки CRM-сущностей Bitrix24: сделки, лиды, контакты, компании.

Включение: "Настройки" -> "Интеграции" -> "Bitrix24" -> "CRM Placements" -> Включить.

Доступные placement-ы:

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

Настройте привязку:

• Выберите, какие placement-ы активировать.

• Для каждого укажите правило привязки (по email, по телефону, по ID контакта).

• Нажмите "Сохранить".

После сохранения в карточках CRM появятся новые вкладки с данными из TehProf Support.

Шаг 6: Смарт-процесс для лицензий (опционально)

Если ваша компания управляет лицензиями на программное обеспечение, можно использовать Смарт-процессы Bitrix24 для учёта лицензий с привязкой к тикетам поддержки.

Предварительно: в Bitrix24 должен быть создан Смарт-процесс "Лицензии" (или аналогичный) со стадиями: "Активна", "Истекает", "Истекла", "Продлена".

Настройка в TehProf Support:

• Перейдите в "Настройки" -> "Интеграции" -> "Bitrix24" -> "Смарт-процессы".

• Нажмите "Добавить интеграцию".

• Выберите Смарт-процесс из списка (система загрузит доступные СП из Bitrix24).

• Настройте маппинг полей: какие поля Смарт-процесса соответствуют данным клиента в TehProf Support (email, компания, тип лицензии).

• Включите опцию "Показывать лицензии в карточке клиента" -- при просмотре клиента в TehProf Support оператор увидит его активные лицензии.

• Включите опцию "Уведомлять об истечении" -- при смене стадии лицензии на "Истекает" система автоматически создаст тикет или уведомит оператора.

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

Что дальше

• Настройте автоматизацию для тикетов, связанных с CRM: "Настройка автоматизации"
• Выберите безопасный момент автоматического создания задач и сделок
• Проверьте проект, ответственного и карту состояний на тестовой заявке
• Обучите операторов переходить по уже созданной ссылке на задачу
• Изучите аналитику по источникам обращений -- какой процент тикетов приходит из CRM vs виджет vs мессенджеры