Интеграции / РУКОВОДСТВО
Интеграция Битрикс24: что проверить до разработки
Подготовите карту полей и протокол проверки доставки, дублей и восстановления.
Рабочий инструментКарта интеграции и протокол приёмкиПерейти к шаблону ↓
В ЭТОМ МАТЕРИАЛЕ
В этом материале +
Надёжная интеграция начинается с правил владения данными. Определите, где создаётся сущность, как она узнаётся в другой системе и что происходит при повторе, конфликте или недоступности API. Успешный HTTP-ответ сам по себе ещё не означает корректную сделку.
Одна сущность — понятный источник правды
Заявка с сайта, контакт в Битрикс24 и контрагент в 1С не являются взаимозаменяемыми объектами. Опишите их соответствие: какие поля обязательны, какие идентификаторы связывают записи, кто может менять телефон, сумму и статус. Контракт нужен даже для «простой» передачи формы в CRM.
Для каждого поля назначьте источник. Например, CRM хранит этап переговоров, учётная система — подтверждённый платёж, а сайт — исходный текст обращения. Если обе системы могут изменять значение, потребуется правило конфликта. Синхронизация по последнему времени изменения не всегда соответствует бизнес-смыслу.
Повтор события не должен создавать повторную сделку
Для маршрута нужен устойчивый идентификатор операции и сохранённый результат. Повторная отправка с сайта или ручное восстановление не должны создавать дубль. Отдельно проверьте потерю события: Bitrix24 не повторяет онлайн-событие при ошибке обработчика. Восстановление проектируют через доступные механизмы, например offline events или сверку с источником.
Не скрывайте очередь ошибок. Ответственный должен видеть, какая заявка не дошла, почему и что нужно исправить. Проверяйте ограничения конкретного портала, доступность методов API и выданные права до согласования схемы: возможности облачной и коробочной установки и используемый тариф могут различаться.
Telegram — рабочий канал, CRM — история процесса
Сообщение в Telegram помогает быстро заметить событие. Но передача карточки в чат не подтверждает реакцию менеджера. Для контроля нужен переход к CRM и событие действия: назначение ответственного, ответ клиенту или новый следующий шаг.
Не отправляйте в общий чат лишние персональные данные. Разделите оперативные уведомления и управленческие отчёты по получателям. Опишите, как сотрудник прекращает получать уведомления после смены роли и где остаётся история решения.
Приёмка на неудобных примерах
Проверьте новую заявку, повторную отправку, отсутствующее обязательное поле, смену ответственного и временное отключение CRM. Повторите событие после восстановления и убедитесь, что запись появилась ровно один раз, а исходные данные сохранились.
Сверяйте результат в обеих системах по идентификаторам. Скриншот успешного запроса не проверяет маппинг полей, права и дальнейшую работу менеджера. В передаче проекта должны быть схема сущностей, перечень доступов, журнал ошибок и инструкция по восстановлению.
ПРИМЕНИТЬ К СВОЕЙ ЗАДАЧЕ
Карта интеграции и протокол приёмки
Владельцы полей, повторная обработка, сбои и подтверждение доставки. Есть заполненный пример и таблица для своей интеграции.
- Поле и его владелец
- Источник каждого значения и правило разрешения расхождений.
- Повтор и сбой
- Как найти исходную операцию и безопасно повторить её.
- Доставка подтверждена
- Результат проверяется в CRM, а ошибка остаётся доступна ответственному.
Заполненный пример: одна заявка отправлена повторно
Условный пример для обсуждения, не клиентский кейс.
- Вход
- Сайт повторяет ранее принятую заявку с тем же идентификатором.
- Проверка
- Обработчик находит связь с существующей CRM-записью.
- Результат
- Повтор не создаёт вторую карточку; статус и данные сверяются с CRM.
Не рассчитывайте на повторную доставку онлайн-события со стороны Bitrix24. Механизм восстановления и сверки согласуется для конкретного маршрута.
Markdown · открывается в текстовом редакторе
Что подготовить к обсуждению
- Облачная или коробочная версия и доступные методы
- Примеры заявок, сделок и учётных документов
- Правила дублей и владения полями
- Список получателей уведомлений и ответственный за ошибки
Источники и основания
Источники объясняют, как устроена технология. Подойдёт ли она вам, что потребуется для запуска и окупятся ли затраты — проверяем на данных вашей компании.
- Битрикс24: справочник REST API CRM
- Битрикс24: события, ограничения доставки и восстановление
- OpenTelemetry: наблюдаемость интеграций