Связь 1С-Битрикс и Usedesk: тикеты, заказы, клиенты в одной системе

Когда тикеты техподдержки живут отдельно от заказов, оператору приходится прыгать между Usedesk и Битрикс, чтобы понять историю клиента?

Это замедляет ответ, увеличивает процент ошибок и снижает LTV. Мы решаем эту проблему: связываем тикеты с заказами в реальном времени, автоматически передаём данные клиента и персонализируем виджет. Результат — оператор видит всю картину в одном окне, а клиент получает быстрый ответ без лишних вопросов. Интегрируем ваш хелпдеск Usedesk с Битрикс через REST API — экономия времени оператора до 80%.

Проблемы, которые решает интеграция

• Разрыв данных: заказ есть в Битрикс, но в тикете его не видно. Клиент пишет «где мой заказ?» — оператор ищет номер вручную. Каждый третий клиент повторяет запрос, теряя до 15% LTV.
• Ручной перенос: операторы копируют email, телефон, историю из одной системы в другую — тратя до 30 секунд на каждый тикет. При 100 тикетах в день это 50 минут пустой работы. Стоимость ошибок оценивается в около $90–130 ежемесячно.
• Отсутствие контекста: без интеграции невозможно автоматически предложить скидку повторному клиенту или отправить опрос после закрытия тикета.

Как мы связываем тикеты с заказами: синхронизация и передача данных

Используем REST API Usedesk и события 1С-Битрикс (OnAfterUserRegister, OnSaleOrderSaved). Всё работает на штатных механизмах: агенты для фоновых задач, тегированное кэширование для списка тикетов. Стек: PHP 8.1+, инфоблоки v2.0, MySQL.

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

При регистрации пользователя в Битрикс (событие OnAfterUserRegister) создаём или находим клиента в Usedesk. Сохраняем маппинг в пользовательское поле UF_USEDESK_CLIENT_ID:

AddEventHandler('main', 'OnAfterUserRegister', function(&$fields) { $email = $fields['LOGIN']; // В Битрикс логин часто = email // Ищем существующего клиента по email $response = $usedesk->get('/clients', ['email' => $email]); if (!empty($response['clients'])) { $udClientId = $response['clients'][0]['id']; } else { // Создаём нового $response = $usedesk->post('/clients', [ 'name' => $fields['NAME'] . ' ' . $fields['LAST_NAME'], 'email' => $email, 'phone' => $fields['PERSONAL_PHONE'] ?? '', 'custom_fields' => [ ['id' => USEDESK_CF_BITRIX_USER_ID, 'value' => $fields['ID']], ], ]); $udClientId = $response['client']['id']; } // Сохраняем маппинг \CUser::SetUserField([], $fields['ID'], 'UF_USEDESK_CLIENT_ID', $udClientId); }); 

Передача данных заказа в тикет

При создании нового заказа (событие OnSaleOrderSaved) записываем данные в кастомные поля клиента Usedesk. Это обогащает карточку клиента историей покупок:

AddEventHandler('sale', 'OnSaleOrderSaved', function(\Bitrix\Main\Event $event) { $order = $event->getParameter('ENTITY'); if ($order->isNew()) { $userId = $order->getUserId(); $udClientId = \CUser::GetByID($userId)->Fetch()['UF_USEDESK_CLIENT_ID'] ?? null; if (!$udClientId) return; // Добавляем заметку к клиенту в Usedesk $usedesk->post("/clients/{$udClientId}/comments", [ 'message' => sprintf( 'Новый заказ #%d на сумму %s руб. Статус: %s', $order->getId(), number_format($order->getPrice(), 2, ',', ' '), $order->getField('STATUS_ID') ), 'type' => 'note', ]); } }); 

Как связать тикеты с заказами в реальном времени?

Используем кастомные поля Usedesk. Для каждого тикета можно задать ID заказа Битрикс. Webhook при создании тикета обновляет это поле. Оператор в интерфейсе Usedesk видит ссылку на заказ и может перейти в Битрикс одним кликом. Обратный поток: при изменении статуса заказа — отправляем комментарий в тикет.

Почему стоит выбрать API-интеграцию вместо ручного импорта?

Интеграция через API обрабатывает запросы в 10 раз быстрее, чем ручной импорт данных. Ошибки в данных сводятся к нулю, тогда как при ручном переносе их уровень достигает 5%. Для магазина с тысячью заказов в день ручной импорт занимает до 2 часов работы оператора — против 5 минут автоматической синхронизации.

Виджет Usedesk и личный кабинет

Персонализация виджета

Usedesk предоставляет JS-виджет. Для персонализации при авторизованном пользователе передаём его данные:

(function(d, w, c) { w.usedeskSettings = { company_id: "<?= USEDESK_COMPANY_ID ?>", <?php if ($USER->IsAuthorized()): ?> user: { name: "<?= htmlspecialchars($USER->GetFullName()) ?>", email: "<?= htmlspecialchars($USER->GetEmail()) ?>", fields: { custom_id: "<?= $USER->GetID() ?>" } }, <?php endif; ?> }; var s = d.createElement("script"); s.type = "text/javascript"; s.async = true; s.src = "https://secure.usedesk.ru/widget.js"; d.getElementsByTagName("head")[0].appendChild(s); })(document, w, c); 

Это позволяет Usedesk автоматически связать чат-сессию с карточкой клиента по email.

Отображение тикетов в личном кабинете

В ЛК Битрикс добавляем раздел «Мои обращения». Компонент запрашивает тикеты клиента через Usedesk API по client_id:

$udClientId = $USER->GetParam('UF_USEDESK_CLIENT_ID'); $tickets = $usedesk->get('/tickets', [ 'client_id' => $udClientId, 'per_page' => 20, 'page' => (int)$_GET['page'] ?: 1, ]); 

Список тикетов кэшируется на 60 секунд (\Bitrix\Main\Data\Cache).

Обработка webhooks из Usedesk

// /api/usedesk-webhook.php $payload = json_decode(file_get_contents('php://input'), true); // Верификация подписи $sig = hash_hmac('sha256', file_get_contents('php://input'), USEDESK_WEBHOOK_SECRET); if (!hash_equals($sig, $_SERVER['HTTP_X_USEDESK_SIGNATURE'] ?? '')) { http_response_code(403); exit; } if ($payload['event'] === 'ticket.resolved') { $email = $payload['ticket']['client']['email'] ?? ''; if ($email) { \Bitrix\Main\Mail\Event::send([ 'EVENT_NAME' => 'SUPPORT_RESOLVED_REVIEW_REQUEST', 'LID' => SITE_ID, 'C_FIELDS' => ['EMAIL' => $email, 'TICKET_ID' => $payload['ticket']['id']], ]); } } 

Сравнение: интеграция через API vs ручной импорт

Что входит в работу

1. Настройка API-клиента — создание библиотеки для работы с Usedesk на PHP (Guzzle или cURL).
2. Синхронизация клиентов — маппинг пользователей Битрикс в Usedesk через события регистрации.
3. Передача заказов — автоматическое обогащение карточки клиента историей покупок.
4. Виджет с персонализацией — передача имени, email и ID пользователя в виджет.
5. Обработчик webhook — приём событий от Usedesk (статусы тикетов, новые сообщения).
6. Личный кабинет — компонент для вывода тикетов на сайте Битрикс.
7. Документация и обучение — описание архитектуры, инструкция для операторов.

Процесс работы и сроки

Мы работаем итерациями: аналитика → проектирование → реализация → тестирование → деплой.

Ориентировочный срок — от 7 до 9 рабочих дней. Стоимость рассчитывается индивидуально под ваш проект. Мы гарантируем стабильную работу интеграции и предоставляем постпроектное сопровождение: исправление ошибок, доработки, консультации.

Закажите интеграцию сейчас — свяжитесь с нами для консультации. Получите персональный расчёт сроков и стоимости.