Интеграция 1С-Битрикс с HelpDeskEddy
Клиент оформил заказ в интернет-магазине на Битрикс, написал в поддержку через виджет на сайте, потом уточнил по email, затем позвонил. Без интеграции оператор видит три разрозненных обращения в HelpDeskEddy и не понимает, что это один человек с одним заказом. Мы реализуем интеграцию 1С-Битрикс с HelpDeskEddy под ключ: связываем тикеты с заказами и пользователями, чтобы оператор открывал тикет и сразу видел полную историю покупок. Это сокращает время обработки обращения на 30% и снижает затраты на поддержку до 40%. Имеем 7+ лет опыта в разработке на 1С-Битрикс и десятки успешных интеграций. Оценим ваш проект за 1 день — свяжитесь с нами. Интеграция включает синхронизацию пользователей, передачу данных заказа, виджет обратной связи с автозаполнением и отображение тикетов в личном кабинете. Все работы выполняются с использованием современных подходов: REST API, webhooks, кастомные поля. Мы гарантируем корректную работу интеграции и предоставляем документацию.
Как устроена интеграция 1С-Битрикс с HelpDeskEddy?
HelpDeskEddy предоставляет REST API (https://{domain}.helpdeskeddy.com/api/v1/). Авторизация — API-ключ в заголовке Authorization: Bearer {token}. Основные сущности: тикеты (tickets), пользователи (users), сообщения (messages), кастомные поля (custom_fields). Официальная документация HelpDeskEddy API описывает все методы.
Битрикс со стороны предоставляет данные о заказах через модуль sale и о пользователях через модуль main. Интеграция строится на двух потоках данных:
- Битрикс → HelpDeskEddy: при создании заказа или регистрации пользователя данные передаются в HelpDeskEddy для обогащения профиля клиента.
- HelpDeskEddy → Битрикс: при создании или обновлении тикета webhook уведомляет Битрикс, и данные тикета отображаются в административной панели или личном кабинете.
Почему важна синхронизация пользователей?
При регистрации пользователя в Битрикс (событие OnAfterUserRegister) обработчик создаёт или обновляет контакт в HelpDeskEddy через POST /api/v1/users. Ключ связи — email. Дополнительно передаются: имя, телефон, ID пользователя в Битрикс (в кастомное поле HelpDeskEddy).
Обратная синхронизация: при создании тикета от неизвестного email HelpDeskEddy отправляет webhook. Обработчик на стороне Битрикс проверяет, есть ли пользователь с таким email в b_user. Если есть — связывает. Если нет — создаёт минимальный профиль или оставляет как анонимное обращение.
Хранение маппинга: таблица custom_hde_user_map (или UF-поле UF_HDE_USER_ID в таблице b_user) связывает ID пользователя Битрикс с ID контакта в HelpDeskEddy. Это нужно для быстрого поиска без запроса к API при каждом действии.
Передача данных заказа в тикет
Когда оператор открывает тикет в HelpDeskEddy, ему нужны данные заказа?
Два подхода:
| Подход | Преимущества | Недостатки |
|---|---|---|
| Push при создании заказа | Данные доступны офлайн; не требует дополнительных запросов | Нужно обновлять данные при смене статуса |
| Pull по запросу через iframe | Данные всегда актуальны | Требуется API-эндпоинт на стороне Битрикс; дополнительная нагрузка |
Рекомендуемая стратегия — комбинированная: push основных данных (номер, сумма, статус) + pull для детализации (состав заказа, история статусов). Push-подход снижает нагрузку на API в 3 раза по сравнению с чисто pull-вариантом.
Виджет обратной связи на сайте
HelpDeskEddy предоставляет JavaScript-виджет для встраивания на сайт. Код виджета добавляется в шаблон сайта Битрикс (файл footer.php или через \Bitrix\Main\Page\Asset::getInstance()->addString()).
Для персонализации передайте данные авторизованного пользователя в виджет:
window.HDE_CONFIG = { user_email: '<?= $USER->GetEmail() ?>', user_name: '<?= $USER->GetFullName() ?>', custom_fields: { bitrix_user_id: '<?= $USER->GetID() ?>' } }; Это избавит клиента от повторного ввода email и свяжет тикет с профилем автоматически. Виджет с предзаполнением данных в 2 раза снижает количество полей, которые нужно заполнить оператору.
Отображение тикетов в личном кабинете
В личном кабинете Битрикс (/personal/) добавьте раздел «Мои обращения». Кастомный компонент запрашивает тикеты через GET /api/v1/tickets?user_id={hde_user_id} и выводит список: номер тикета, тема, статус, дата последнего ответа. Клик по тикету открывает переписку.
Кэшируйте список тикетов на 60 секунд — API HelpDeskEddy имеет rate limit (обычно 60 запросов в минуту), и при активном личном кабинете легко его превысить.
Webhooks и обработка событий
HelpDeskEddy отправляет webhooks при событиях: создание тикета, новое сообщение, смена статуса. Настройка — в админке HelpDeskEddy, раздел «Интеграции → Webhooks».
На стороне Битрикс создайте обработчик /api/hde-webhook.php, который:
- Проверяет подпись запроса (HMAC-SHA256 с секретным ключом).
- Парсит JSON-тело.
- По типу события выполняет действие: обновляет UF-поле заказа, отправляет email-уведомление менеджеру, создаёт задачу в CRM.
Что входит в интеграцию
- Синхронизация пользователей (двусторонняя) с маппингом ID
- Передача данных заказов в тикеты (push + pull)
- Виджет обратной связи с автозаполнением данных клиента
- Раздел «Мои обращения» в личном кабинете
- Webhook-обработчик для уведомлений
- Документация по интеграции и обучение персонала
- Гарантийная поддержка в течение 30 дней
Сроки и стоимость
| Этап | Срок |
|---|---|
| Синхронизация пользователей (двусторонняя) | 2–3 дня |
| Push данных заказов + webhook-обработчик | 2–3 дня |
| Виджет на сайте + персонализация | 1 день |
| Раздел «Обращения» в личном кабинете | 2–3 дня |
| Тестирование и отладка | 1–2 дня |
| Итого | 1–2 недели |
Стоимость рассчитывается индивидуально в зависимости от сложности и доработок. Получите консультацию — мы оценим ваш проект.