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

Для кого

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

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

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

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

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

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

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

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

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

1. Откройте ваш Bitrix24.
2. Перейдите в "Маркет" (Приложения) -> Поиск.
3. Найдите приложение TehProf.kz Support либо откройте его по кнопке Установить из Marketplace в Настройки → Интеграции → Bitrix24.
4. Нажмите "Установить".
5. Подтвердите запрос разрешений (подробнее на шаге 2).
6. После установки приложение появится в левом меню Bitrix24.

Вариант 2 -- Локальное приложение:

Если нужно поставить приложение вручную, пока портал не подключён:

1. В TehProf.kz Support откройте Настройки → Интеграции → Bitrix24 и найдите блок Локальная установка (он показывается, если для вашего кабинета доступен адрес локальной установки).
2. В Bitrix24 откройте Приложения → Разработчикам → Другое → Локальное приложение.
3. Скопируйте из TehProf.kz Support значения URL обработчика и URL приложения при первой установке в форму Bitrix24.
4. Подтвердите разрешения — приложение появится в вашем Bitrix24.

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

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

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

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

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

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

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

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

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

• Статус подключения -- "Подключено" (зелёный индикатор) или "Не подключён".
• Портал -- адрес вашего Bitrix24 (например, mycompany.bitrix24.kz).
• Лицензия и число сотрудников портала, если Bitrix24 их вернул.
• Разрешения API -- раскрывающийся список предоставленных разрешений (scope).

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

Для проверки нажмите кнопку обновления рядом со статусом: система отправит запрос к Bitrix24 API и покажет «Подключено!» с именем пользователя либо «Ошибка подключения».

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

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

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

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

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

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

CRM-встройки добавляют вкладку TehProf.kz Support прямо в карточки Bitrix24. Отдельно включать их не нужно: при установке приложение само регистрирует вкладку «Поддержка» в карточках:

• сделки;
• лида;
• контакта;
• компании;
• счёта;
• задачи.

Если вкладка не появилась, переустановите приложение — регистрация повторится.

Что дальше

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