Архитектура интеграции и синхронизации по API
Коротко. Интеграция по API – это то, какие системы связаны и через какие методы. Синхронизация – то, как и когда данные между ними обновляются: пакетно по расписанию, по событиям (вебхукам) или в реальном времени. Для сайта, CRM и интернет-магазина почти всегда нужно и то и другое: схема обмена, выбранный способ синхронизации, обработка ошибок и конфликтов. Ниже – как это устроено и что продумать до старта разработки.

Что такое архитектура интеграции по API
API (Application Programming Interface) – программный интерфейс, через который одна система запрашивает или передаёт данные другой. Архитектура интеграции описывает, какие системы участвуют в обмене, какие сущности передаются (заявки, клиенты, товары, заказы, остатки), в каком формате и по каким правилам.
Хорошая архитектура позволяет подключать новые сервисы, не переписывая основной код сайта или CRM: каждый компонент выполняет свою функцию и может быть заменён без влияния на остальные.
Для бизнеса это означает понятный результат: менеджеры работают в одной системе, не переносят данные вручную, а руководитель видит в CRM полную картину по заявкам и источникам. Чем раньше продумана архитектура, тем дешевле дальнейшие доработки.
Чем интеграция отличается от синхронизации
Эти понятия часто смешивают. Интеграция – это сам факт и схема связи между системами. Синхронизация – механизм, который поддерживает данные в разных системах согласованными: чтобы заказ с сайта появился в CRM, а изменённый статус сделки вернулся на сайт.
- Интеграция отвечает на вопрос «что с чем связано и через какие методы API».
- Синхронизация отвечает на вопрос «как часто, в каком направлении и что делать при расхождениях».
Три способа синхронизации данных
Пакетная (по расписанию)
Одна система периодически опрашивает API другой и забирает изменения – например, раз в несколько минут проверяет новые заказы. Просто в реализации и устойчиво к временным сбоям, но данные обновляются с задержкой. Подходит для выгрузки каталога, цен и остатков.
Событийная (вебхуки)
Система-источник сама отправляет уведомление, когда что-то изменилось: создана заявка, сменился статус сделки. Данные приходят почти сразу, нагрузка ниже, чем при частом опросе. Это основной способ передачи заявок с сайта в Битрикс24 и amoCRM – обе CRM поддерживают вебхуки и REST API.
В реальном времени (постоянное соединение)
Клиент держит открытое соединение (например, WebSocket) и получает данные мгновенно. Нужно для чатов, онлайн-табло и диспетчерских интерфейсов; для типовой связки «сайт – CRM» обычно избыточно и сложнее в поддержке.
| Способ | Скорость обновления | Сложность | Типичные задачи |
|---|---|---|---|
| Пакетная | С задержкой (по расписанию) | Низкая | Каталог, цены, остатки, отчёты |
| Событийная (вебхуки) | Почти сразу | Средняя | Заявки, заказы, статусы сделок |
| Реальное время | Мгновенно | Высокая | Чаты, онлайн-мониторинг, диспетчерская |
Типовые сценарии для сайта и бизнеса
- Сайт → CRM: заявки из форм, звонков и чатов попадают в CRM с UTM-метками и источником. Подробно – на странице интеграции сайта с CRM.
- Интернет-магазин ↔ CRM: заказы уходят в CRM, статусы и оплаты возвращаются на сайт. Пример требований – в статье «Пример ТЗ на синхронизацию интернет-магазина с CRM».
- Учётная система ↔ сайт: товары, цены и остатки обновляются пакетно, заказы – по событию.
- Сайт ↔ внешние сервисы: платёжные системы, доставка, телефония, мессенджеры.
Для конкретных CRM есть отдельные страницы: интеграция сайта с Битрикс24 и интеграция сайта с amoCRM.
Ошибки, конфликты и безопасность

Большинство проблем интеграций возникает не в «счастливом сценарии», а на сбоях. Что нужно предусмотреть заранее:
- Повторы и очередь. Если CRM недоступна, заявка не должна теряться – её ставят в очередь и отправляют повторно.
- Защита от дублей. Повторная отправка не должна создавать вторую сделку; нужен уникальный идентификатор записи.
- Конфликты. Если одна и та же запись изменена в двух системах, должно быть заранее определено, какая система главная для каждого поля.
- Логи и уведомления. Каждый обмен фиксируется, об ошибках узнаёт ответственный, а не клиент.
- Безопасность. Аутентификация, ключи доступа с минимальными правами, HTTPS, проверка входящих вебхуков.
- Изменения API. Внешние сервисы обновляют API; интеграцию нужно сопровождать, а не «сделать и забыть».
С чего начать проект интеграции
- Перечислить системы и сущности, которые нужно связать.
- Для каждой сущности определить направление обмена и главную систему.
- Выбрать способ синхронизации: пакетно, по событиям или в реальном времени.
- Описать поведение при ошибках, дублях и конфликтах.
- Зафиксировать всё в техническом задании и проверить на тестовых данных.
Если интеграция уже работает, но заявки теряются или данные расходятся, начните с проверки логов обмена – подробнее в статье «Почему не приходят заявки с сайта». Сопровождение действующих интеграций входит в техническую поддержку сайтов, а нестандартные связки мы делаем в рамках нетривиальной разработки.
Частые вопросы
Чем интеграция по API отличается от синхронизации?
Интеграция – это схема связи систем через их API. Синхронизация – механизм, который поддерживает данные в этих системах согласованными: направление, частота обновления и правила разрешения конфликтов.
Какой способ синхронизации выбрать для сайта и CRM?
Для заявок и заказов – событийный (вебхуки), чтобы данные приходили сразу. Для каталога, цен и остатков обычно достаточно пакетной синхронизации по расписанию.
Можно ли интегрировать сайт с Битрикс24 или amoCRM без плагинов?
Да. Обе CRM предоставляют REST API и вебхуки, поэтому обмен можно реализовать напрямую с учётом ваших полей, воронок и источников заявок.
Что делать, если заявки с сайта не доходят до CRM?
Проверить логи обмена, доступность API CRM, корректность ключей и наличие очереди повторной отправки. Если логов нет – их стоит добавить в первую очередь.