Интеграция Битрикс24 с Omnidesk
Поддержка работает в Omnidesk, продажи — в Битрикс24. Когда клиент пишет в поддержку, агент не видит историю сделок. Когда менеджер звонит клиенту, он не знает, что тот вчера написал гневное обращение. Две системы, два контекста, ноль связи — и клиент чувствует, что разговаривает с двумя разными компаниями.
Интеграция объединяет данные: тикеты из Omnidesk отображаются в CRM, а информация о клиенте из CRM доступна агентам поддержки.
Что передаётся
| Данные | Omnidesk → Битрикс24 | Битрикс24 → Omnidesk |
|---|---|---|
| Тикеты | Создание дела в таймлайне CRM | — |
| Статусы тикетов | Обновление активности | — |
| Переписка | Комментарии в таймлайне | — |
| Контактные данные | — | ФИО, телефон, компания, менеджер |
| Сделки | — | Список активных сделок клиента |
| Теги и приоритеты | Передаются как поля активности | — |
Архитектура интеграции
Omnidesk поддерживает REST API и вебхуки. Схема:
- Вебхук из Omnidesk — срабатывает при создании тикета, смене статуса, новом сообщении.
- Middleware — принимает событие, идентифицирует клиента по email/телефону в CRM.
- Запись в Битрикс24 — создание или обновление активности в таймлайне контакта.
- Обратный канал — middleware по запросу агента отдаёт данные из CRM в интерфейс Omnidesk.
Привязка тикетов к контактам CRM
При создании тикета в Omnidesk middleware выполняет:
- Извлечение email клиента из тикета.
- Поиск контакта в Битрикс24 по email (метод
crm.contact.listс фильтром). - Если контакт найден — создание дела типа «обращение в поддержку» с данными: номер тикета, тема, канал (email/чат/мессенджер), приоритет.
- Если не найден — создание лида или контакта (настраивается).
- Привязка к открытой сделке контакта, если такая есть.
Результат: менеджер в CRM видит все обращения клиента в поддержку прямо в карточке.
Мультиканальность
Omnidesk принимает обращения из разных каналов: email, виджет на сайте, Telegram, VK, Facebook, Instagram. Все каналы сходятся в один тикет. Интеграция передаёт в CRM информацию о канале — менеджер видит, откуда клиент обратился.
Если клиент написал из Telegram, а потом ответил на email — это один тикет в Omnidesk и одна активность в CRM. Без дублирования.
Синхронизация статусов
Жизненный цикл тикета отражается в CRM:
- Открыт — дело создано, статус «В работе».
- В ожидании — ждём ответа клиента, статус обновлён.
- Решён — дело закрыто, в таймлайне отметка с датой и временем решения.
- Переоткрыт — дело снова активно, менеджер видит, что проблема вернулась.
Теги из Omnidesk (например, «баг», «биллинг», «отмена») передаются как категории дела. Это позволяет фильтровать и анализировать обращения в CRM.
Назначение агентов
Omnidesk распределяет тикеты между агентами по правилам: по отделу, по нагрузке, по тематике. Интеграция передаёт в CRM имя агента, ответственного за тикет. Менеджер знает, к кому обратиться за деталями.
Обратная логика: если в CRM за клиентом закреплён конкретный менеджер, эта информация передаётся в Omnidesk. Агент поддержки видит, кто ведёт клиента, и при необходимости подключает его к переписке.
Контекст для агентов
В карточку клиента в Omnidesk добавляется виджет с данными из CRM:
- Компания — название и отрасль.
- Тариф / продукт — что клиент использует.
- Сумма сделок — общая ценность клиента.
- Стадия текущей сделки — если идут переговоры или онбординг.
- Менеджер — имя и контакт.
Агент принимает решения с контекстом. Клиент на этапе подписания крупного контракта получает приоритет. Клиент с просроченной оплатой — направляется к менеджеру.
Аналитика обращений в CRM
Данные из Omnidesk обогащают CRM-аналитику:
- Количество обращений на клиента — пользовательское поле, обновляется автоматически.
- Среднее время решения — для оценки качества поддержки по клиенту.
- Частота обращений — растущий тренд может сигнализировать о проблеме с продуктом или риске оттока.
- Тематика обращений — на основе тегов. Если клиент 5 раз писал про биллинг — это сигнал.
Руководитель видит сводку в CRM без необходимости заходить в Omnidesk.
Автоматические сценарии
На основе событий из Omnidesk запускаются бизнес-процессы Битрикс24:
- Негативный тикет (тег «жалоба» или низкая оценка CSAT) — задача менеджеру: «Связаться с клиентом».
- Тикет от VIP-клиента — уведомление руководителю.
- Тикет не закрыт 72 часа — эскалация через CRM.
- Новый тикет во время активной сделки — уведомление менеджеру, ведущему сделку.
Обработка ошибок
- Контакт не найден в CRM — создаётся лид с данными из тикета. Лог для ручной проверки.
- Дубль вебхука — дедупликация по ID тикета и timestamp.
- Omnidesk API недоступен — очередь запросов с повтором. Данные не теряются.
- Несоответствие email — если клиент пишет с нового адреса, не привязанного к CRM, создаётся новая активность с пометкой «контакт не идентифицирован».
Безопасность
Вебхуки Omnidesk верифицируются по подписи (HMAC). Токены API хранятся на сервере middleware. Передача — HTTPS. Логи с персональными данными ротируются каждые 90 дней.
Настраиваем интеграцию под конкретные процессы: от базовой передачи тикетов в CRM до полной связки с контекстом для агентов, аналитикой и автоматическими эскалациями.