У типичной растущей компании есть CRM для продаж, ERP или бухгалтерская система для счетов и склада, инструмент email-маркетинга, интернет-магазин и helpdesk. Каждый хорошо работает сам по себе. Между ними люди копируют и вставляют: клиент, введённый в CRM, снова вводится в бухгалтерской системе, заказ перепечатывается для отгрузки, лид из формы выгружается в таблицу и импортируется куда-то ещё.
Эта ручная работа медленная, порождает ошибки и приводит к тому, что никто не видит одного клиента одинаково. Интеграция через API устраняет это. В статье объясняется, как, на разобранном примере.
Что такое API и вебхук
- API (программный интерфейс приложения): определённый способ, которым одна программа запрашивает у другой данные или отправляет их. Большинство современных инструментов предлагают REST API на простых веб-запросах.
- Вебхук: обратное направление. Вместо того чтобы постоянно спрашивать «есть ли что-то новое?», система сама обращается к вам в момент события, например нового заказа или закрытой сделки.
Разобранный пример: от лида до счёта
Представьте сервисную компанию с формой на сайте, CRM и бухгалтерской системой. Хорошо интегрированный поток выглядит так:
- Посетитель заполняет контактную форму на сайте.
- Вебхук отправляет данные на уровень интеграции, который создаёт контакт и сделку в CRM и добавляет человека в нужный маркетинговый список.
- Когда менеджер отмечает сделку как выигранную, CRM отправляет событие.
- Уровень интеграции создаёт клиента и черновик счёта в бухгалтерской системе, используя сумму и детали сделки.
- Когда счёт оплачен, бухгалтерия уведомляет уровень интеграции, который обновляет сделку и запускает приветственную цепочку писем.
- Всё журналируется, а сбой вызывает оповещение, а не тихо теряет данные.
Никто ничего не вводит заново, и каждая система показывает одного и того же клиента и один и тот же статус.
Три способа интеграции
| Подход | Как работает | Лучше всего подходит для |
|---|---|---|
| Готовые коннекторы | Встроенные интеграции или приложения из маркетплейса | Распространённых пар популярных инструментов со стандартными потребностями |
| Платформы автоматизации | Визуальные инструменты, связывающие приложения через триггеры и действия | Простых потоков с умеренным объёмом |
| Индивидуальное промежуточное ПО | Специально написанный код между системами | Сложного сопоставления, больших объёмов, устаревших систем, строгой надёжности |
Начинайте с самого простого подхода, который покрывает ваши потребности, и переходите к индивидуальному промежуточному ПО, когда этого требуют логика или надёжность.
Сложность – в данных, а не в соединении
- Сопоставление данных. «Клиент» в CRM может быть «Аккаунтом» в ERP. Поля различаются по формату, длине и смыслу. Решите, что чему соответствует.
- Единый источник истины. Для каждого типа данных решите, какая система им владеет. Две системы, правящие одно поле, ведут к конфликтам.
- Идентификаторы. Используйте стабильный ключ (например, ID клиента или налоговый номер) для сопоставления записей, а не имена, которые везде пишутся по-разному.
- Дубликаты. Решите, как их находить и объединять, до синхронизации, а не после.
- Качество данных. Интеграция неряшливых данных лишь быстрее распространяет беспорядок. Сначала очистите.
Надёжность и безопасность
- Повторы и очереди: если система недоступна несколько минут, сообщения ждут и доставляются позже, а не теряются.
- Идемпотентность: если одно и то же сообщение приходит дважды, результатом не должны стать два счёта.
- Обработка ошибок и оповещения: сбои должны быть видимы и устранимы.
- Аутентификация: используйте безопасные методы вроде OAuth2 или ключей API, хранящихся в хранилище секретов, но никогда не в открытом виде в коде или таблицах.
- Минимальные привилегии: у учётной записи интеграции должен быть доступ только к нужному.
- Мониторинг и журналы: знайте, сколько сообщений обработано, какие завершились ошибкой и почему.
- Лимиты запросов: соблюдайте их, иначе интеграцию заблокируют в самый неподходящий момент.
Совет: прежде чем что-либо строить, нарисуйте поток данных на одной странице: какая система его запускает, какие поля передаются, какая система чем владеет и что происходит при ошибке. Большинство проблем интеграции видно на этой странице.
Типичные ошибки
- Синхронизировать всё в обе стороны «на всякий случай».
- Нет владельца интеграции после запуска.
- Жёстко прописанные учётные данные и настройки.
- Игнорирование изменений API у производителя, из-за чего всё ломается через месяцы.
Чем мы можем помочь
Alficom строит «цифровые мосты» между вашими CRM, ERP и маркетинговыми инструментами: разработка REST- и SOAP-API, интеграции со SaaS, оркестрация вебхуков и потоки данных в реальном времени. Когда готовых коннекторов недостаточно, мы создаём индивидуальное промежуточное ПО, которое справляется со сложным сопоставлением и даже связывает старые системы с современными облачными приложениями.