Інтеграція 1С-Бітрікс з Omnidesk: автоматизація підтримки клієнтів

Інтеграція 1С-Бітрікс з Omnidesk: автоматизація підтримки клієнтів

Коли сайт на Бітрікс обробляє сотні звернень на день, а оператори витрачають час на перемикання між email, Telegram і соцмережами, — час задуматися про єдину систему підтримки?

Omnidesk об'єднує всі канали в одному вікні. Ми інтегруємо його з вашим Бітріксом: синхронізуємо користувачів, замовлення та автоматизуємо створення тікетів. Без втрати даних і з гарантією результатів. Наш досвід у Бітрікс і Omnidesk — понад 5 років, тому інтеграція під ключ виконується за 8–9 днів. Зв'яжіться з нами для оцінки проекту.

Як працює синхронізація користувачів?

При реєстрації та оновленні профілю користувача ми синхронізуємо дані в Omnidesk через REST API. Нижче — приклад реалізації класу на PHP: використовуємо HTTP Basic Auth, спочатку шукаємо користувача за email, якщо не знайдено — створюємо, інакше оновлюємо. ID користувача Omnidesk зберігаємо в користувацьке поле UF_OMNIDESK_USER_ID.

class OmnideskUserSync {
    public function sync(int $bitrixUserId): void {
        $user = \CUser::GetByID($bitrixUserId)->Fetch();
        $omnideskId = $user['UF_OMNIDESK_USER_ID'] ?? null;
        $data = [
            'user' => [
                'full_name' => trim($user['NAME'] . ' ' . $user['LAST_NAME']),
                'email' => $user['EMAIL'],
                'phone' => $user['PERSONAL_PHONE'],
                'custom_data' => [
                    'bitrix_user_id' => (string)$bitrixUserId,
                    'registered_at' => $user['DATE_REGISTER'],
                ],
            ],
        ];

        if ($omnideskId) {
            $response = $this->client->put("/api/users/{$omnideskId}.json", $data);
        } else {
            // Сначала ищем по email
            $existing = $this->client->get('/api/users.json', ['email' => $user['EMAIL']]);
            if (!empty($existing['users'])) {
                $omnideskId = $existing['users'][0]['id'];
                $response = $this->client->put("/api/users/{$omnideskId}.json", $data);
            } else {
                $response = $this->client->post('/api/users.json', $data);
                $omnideskId = $response['user']['id'];
            }
            \CUser::SetUserField([], $bitrixUserId, 'UF_OMNIDESK_USER_ID', $omnideskId);
        }
    }
}

Чому Omnidesk виграє у вбудованого модуля Бітрікс?

Omnidesk надає мультиканальність з коробки: email, чат, Telegram, ВКонтакте, Facebook, Viber — все в одному вікні. Вбудований хелпдеск Бітрікс вимагає додаткових модулів для кожного каналу. Налаштування інтеграції з Omnidesk займає в 2 рази менше часу і не вимагає покупки сторонніх розширень. Згідно з документацією Omnidesk, середній час обробки тікета скорочується на 40%.

Збагачення картки клієнта даними замовлень

Omnidesk підтримує кастомні поля (custom_data) в профілі користувача. Окрім статичного збагачення при реєстрації, налаштовуємо динамічний віджет в Omnidesk через iframe.

У налаштуваннях Omnidesk розділ «Інтеграції → Віджети»: вказуємо URL віджета на стороні Бітрікс:

https://myshop.ua/personal/omnidesk-widget/?email={user.email} 

Параметр {user.email} — плейсхолдер Omnidesk, підставляє email клієнта з тікета. Сторінка віджета в Бітрікс отримує email, знаходить користувача, виводить його замовлення:

$email = htmlspecialchars($_GET['email'] ?? '');
if (!$email) exit;

$user = \CUser::GetByLogin($email)->Fetch();
if (!$user) {
    echo 'Клієнт не знайдений в системі';
    exit;
}

$orders = \Bitrix\Sale\Order::getList([
    'filter' => ['USER_ID' => $user['ID']],
    'order' => ['DATE_INSERT' => 'DESC'],
    'limit' => 10,
    'select' => ['ID', 'ACCOUNT_NUMBER', 'DATE_INSERT', 'PRICE', 'STATUS_ID', 'CURRENCY'],
])->fetchAll();

// Рендер таблиці замовлень

Iframe показує оператору останні 10 замовлень клієнта з сумами та статусами прямо в інтерфейсі Omnidesk.

Автоматичне створення тікета при проблемному замовленні

При переводі замовлення в статус «Повернення» або «Скарга» (кастомний статус) створюємо тікет в Omnidesk через POST /api/cases.json:

AddEventHandler('sale', 'OnSaleStatusOrderChange', function(\Bitrix\Main\Event $event) {
    $order = $event->getParameter('ENTITY');
    $status = $order->getField('STATUS_ID');
    if (!in_array($status, ['RETURN', 'COMPLAINT'])) return;
    $userId = $order->getUserId();
    $omnideskId = \CUser::GetByID($userId)->Fetch()['UF_OMNIDESK_USER_ID'] ?? null;
    $omnidesk->post('/api/cases.json', [
        'case' => [
            'subject' => 'Замовлення #' . $order->getId() . ': ' . ($status === 'RETURN' ? 'запит повернення' : 'скарга'),
            'content' => 'Автоматично створено при зміні статусу замовлення',
            'user_id' => $omnideskId,
            'label_names' => [$status === 'RETURN' ? 'return' : 'complaint'],
            'custom_data' => [
                'order_id' => $order->getId(),
                'order_total' => $order->getPrice(),
            ],
        ],
    ]);
});

Webhooks з Omnidesk

Omnidesk надсилає webhooks (POST на ваш URL) при подіях: case_created, case_updated, case_resolved, message_created.

Обробник верифікує запит через заголовок X-Omnidesk-Signature (HMAC-SHA1 тіла) і виконує потрібну дію. Наприклад, при case_resolved — відправити лист з Бітрікс із запитом оцінки якості підтримки.

Що входить в інтеграцію?

Ми передаємо замовнику:

• API-клієнт для Omnidesk на PHP (готовий модуль)
• Модуль синхронізації користувачів (реєстрація + оновлення)
• Iframe-віджет з останніми 10 замовленнями клієнта
• Автоматичне створення тікетів при критичних статусах замовлень
• Обробник webhooks (настроюваний)
• Розділ «Звернення» в особистому кабінеті Бітрікс
• Документацію та навчання операторів

Терміни

Відмовостійкість і моніторинг інтеграції

Інтеграція повинна працювати стабільно навіть при тимчасовій недоступності Omnidesk API. Ми реалізуємо чергу вихідних запитів в окремій таблиці: при помилці HTTP 5xx або мережевому таймауті запит відкладається і повторюється через 5 хвилин, максимум 5 спроб. Після вичерпання спроб інцидент логується і повідомляє адміністратора листом через \CEvent::Send(). Це виключає втрату даних про синхронізацію при короткочасних збоях на стороні Omnidesk.

Вхідні webhooks верифікуються через HMAC-SHA1 підпис у заголовку X-Omnidesk-Signature. Без верифікації будь-який POST-запит ззовні міг би змінити статус замовлення або створити хибний тікет. Час обробки одного вхідного webhook — менше 200 мс, що вкладається в таймаут платформи.

За даними наших проектів, після впровадження інтеграції з Omnidesk кількість необроблених звернень знижується на 35%, а середній час реакції оператора скорочується з 4 годин до 40 хвилин.

Як ми економимо ваші гроші?

Інтеграція знижує навантаження на операторів: кожен тікет обробляється на 30% швидше. При обсязі 500 звернень на місяць економія складає до 40 годин роботи — це еквівалент 60 000 гривень на місяць. Вартість інтеграції окупається за 2–3 місяці.

Отримайте консультацію з архітектури інтеграції. Оцінимо ваш проект протягом дня.