5. Интеграция с Bitrix24

Доступ: Настройки → Servicedesk → Bitrix24 Integration URL: /servicedesk/bitrix24/integrations/

Вкладка "Bitrix24 Integration" позволяет настроить интеграцию с корпоративным порталом Битрикс24 для синхронизации заявок и задач.

5.1. Создание интеграции

Для создания новой интеграции нажмите кнопку "Add Integration" (Добавить интеграцию).

Поля:

• Клиент (обязательное) - клиент, для которого настраивается интеграция
• Bitrix24 Domain (обязательное) - домен корпоративного портала Битрикс24
• Пример: portal.company.local или mycompany.bitrix24.ru
• Webhook URL (обязательное) - URL вебхука для доступа к REST API корпоративного портала
• Формат: https://domain/rest/1/webhook_code/
• Создается в настройках Битрикс24: Приложения → Входящий вебхук
• Is Active (Bullet, по умолчанию: True) - включить или отключить интеграцию

Примечание: Домен в Webhook URL должен соответствовать указанному домену Bitrix24.

5.2. Управление интеграциями

• Редактирование: Нажмите на интеграцию в списке или используйте кнопку редактирования
• Удаление: Используйте кнопку удаления (требуется подтверждение)

5.3. Функционал интеграции

Создание задач в Битрикс24

• При создании заявки в системе ASK автоматически создается задача в Битрикс24
• Задача создается только для заявок клиента, для которого настроена интеграция
• Название задачи: "Заявка #ID: Название заявки"

Синхронизация исполнителя

• Если в заявке указан исполнитель, система ищет пользователя в Битрикс24 по email
• При совпадении email пользователь назначается исполнителем задачи в Битрикс24
• Изменения исполнителя синхронизируются в обе стороны

Синхронизация статусов

• Из системы в Битрикс24:
• Статусы типа CLOSE (закрывающие) → статус "Завершена" (5) в Битрикс24
• Статусы типа PAUSE (пауза) → статус "Отложена" (4) в Битрикс24
• Статусы типа WORK (в работе) → статус "В работе" (2) или по названию
• Из Битрикс24 в систему:
• Статус "Завершена" (5) → статус "Выполнен" в системе
• Статус "Отложена" (4) → статус типа PAUSE в системе
• Статус "Отменена" (6) → статус "Отменена" в системе
• Остальные статусы → поиск по названию

Синхронизация дедлайна

• Дедлайн заявки синхронизируется с дедлайном задачи в Битрикс24
• Изменения дедлайна синхронизируются в обе стороны

Синхронизация комментариев

• При добавлении комментария к заявке в системе, комментарий автоматически добавляется к задаче в Битрикс24
• При добавлении комментария к задаче в Битрикс24, комментарий автоматически добавляется к заявке в системе
• Комментарии синхронизируются в обе стороны с указанием автора

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

Для работы интеграции необходимо настроить вебхуки в Битрикс24:

1. Входящий вебхук (для отправки данных из ASK в Битрикс24):
2. Приложения → Входящий вебхук
3. Права доступа: Задачи (tasks), Пользователи (user), Комментарии (task.commentitem)
4. URL вебхука используется в настройках интеграции
5. Исходящий вебхук (для получения обновлений из Битрикс24):
6. Приложения → Исходящий вебхук
7. URL обработчика: https://ваш-домен/servicedesk/bitrix24/webhook/<uuid-интеграции>/
8. События: ONTASKADD, ONTASKUPDATE, ONTASKCOMMENTADD