Архитектура интеграции и синхронизации по API

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

Схема интеграции сайта с CRM по API

Что такое архитектура интеграции по 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.

Ошибки, конфликты и безопасность

Два сервера обмениваются данными через API

Большинство проблем интеграций возникает не в «счастливом сценарии», а на сбоях. Что нужно предусмотреть заранее:

  • Повторы и очередь. Если CRM недоступна, заявка не должна теряться – её ставят в очередь и отправляют повторно.
  • Защита от дублей. Повторная отправка не должна создавать вторую сделку; нужен уникальный идентификатор записи.
  • Конфликты. Если одна и та же запись изменена в двух системах, должно быть заранее определено, какая система главная для каждого поля.
  • Логи и уведомления. Каждый обмен фиксируется, об ошибках узнаёт ответственный, а не клиент.
  • Безопасность. Аутентификация, ключи доступа с минимальными правами, HTTPS, проверка входящих вебхуков.
  • Изменения API. Внешние сервисы обновляют API; интеграцию нужно сопровождать, а не «сделать и забыть».

С чего начать проект интеграции

  1. Перечислить системы и сущности, которые нужно связать.
  2. Для каждой сущности определить направление обмена и главную систему.
  3. Выбрать способ синхронизации: пакетно, по событиям или в реальном времени.
  4. Описать поведение при ошибках, дублях и конфликтах.
  5. Зафиксировать всё в техническом задании и проверить на тестовых данных.

Если интеграция уже работает, но заявки теряются или данные расходятся, начните с проверки логов обмена – подробнее в статье «Почему не приходят заявки с сайта». Сопровождение действующих интеграций входит в техническую поддержку сайтов, а нестандартные связки мы делаем в рамках нетривиальной разработки.

Частые вопросы

Чем интеграция по API отличается от синхронизации?

Интеграция – это схема связи систем через их API. Синхронизация – механизм, который поддерживает данные в этих системах согласованными: направление, частота обновления и правила разрешения конфликтов.

Какой способ синхронизации выбрать для сайта и CRM?

Для заявок и заказов – событийный (вебхуки), чтобы данные приходили сразу. Для каталога, цен и остатков обычно достаточно пакетной синхронизации по расписанию.

Можно ли интегрировать сайт с Битрикс24 или amoCRM без плагинов?

Да. Обе CRM предоставляют REST API и вебхуки, поэтому обмен можно реализовать напрямую с учётом ваших полей, воронок и источников заявок.

Что делать, если заявки с сайта не доходят до CRM?

Проверить логи обмена, доступность API CRM, корректность ключей и наличие очереди повторной отправки. Если логов нет – их стоит добавить в первую очередь.

Авторы
Роман Кусты
Роман Кусты
Руководитель компании, менеджер проектов, разработчик
Авторы
Роман Кусты
Роман Кусты
Руководитель компании, менеджер проектов, разработчик
MAX