Когда бизнесу нужна кастомная интеграция сайта с CRM

Готовая CRM-форма часто закрывает базовую задачу: получить имя, телефон и комментарий. Но со временем бизнесу становится мало такой схемы. Нужно передавать товары, UTM, выбранную услугу, город, сумму заказа, статус оплаты, источник, несколько ответственных и контролировать ошибки. В этот момент обычного виджета уже может не хватать.

Кастомная интеграция сайта с CRM нужна не для “сложности ради сложности”, а когда бизнесу нужен контроль над заявкой.

Признаки, что готовой формы мало

• на сайте несколько разных форм;
• каждая форма должна попадать в свою воронку;
• нужно передавать UTM и страницу заявки;
• есть корзина или состав заказа;
• нужно проверять наличие товара;
• заявки нужно сохранять локально;
• CRM иногда недоступна, а заявку нельзя потерять;
• нужны статусы отправки и повторные попытки.

Локальная заявка как основа

Надёжный вариант — сначала сохранить заявку на сайте, а потом передать её в CRM.

lead_id: 1250
status: new
crm_status: pending
source_page: /services/
utm_source: yandex

Если CRM не ответила, заявка остаётся на сайте. Её можно отправить повторно или обработать вручную.

Очередь для отправки

Передача в CRM не всегда должна выполняться прямо в момент отправки формы. Если CRM отвечает медленно, пользователь не должен ждать 20 секунд.

form_submit
→ lead_saved
→ send_to_crm_job
→ crm_success или crm_failed

Очередь особенно полезна, когда кроме CRM есть письмо, Telegram, аналитика и другие интеграции.

UTM и источник

Кастомная интеграция позволяет аккуратно передавать источник обращения: UTM-метки, страницу, форму, referer, город, тип устройства. Для маркетинга это часто критично.

Маппинг полей

Нужно заранее описать, какое поле сайта куда попадает в CRM.

site.name → CRM.NAME
site.phone → CRM.PHONE
site.utm_source → CRM.UTM_SOURCE
site.service_code → CRM.UF_SERVICE
site.page_url → CRM.SOURCE_DESCRIPTION

Без такой таблицы интеграция быстро становится набором догадок в коде.

Ошибки и retry

Если CRM вернула временную ошибку, заявку можно повторить. Если ошибка валидации постоянная, нужно показать её в отчёте и исправить данные или маппинг.

• timeout — повторить;
• 429 — повторить позже;
• 500 — повторить;
• 400 — проверить данные;
• 401 — проверить токен;
• 403 — проверить права.

Когда кастомная интеграция не нужна

Если на сайте одна простая форма, заявок мало, аналитика базовая, а CRM-форма нормально встраивается в дизайн, можно не усложнять. Готовое решение быстрее и дешевле.

Чек-лист решения

1. Посчитать количество форм и сценариев.
2. Понять, какие данные нужны в CRM.
3. Проверить необходимость локального хранения заявок.
4. Описать маппинг полей.
5. Продумать очередь и retry.
6. Добавить статусы отправки.
7. Настроить логи без секретов.
8. Оставить готовую CRM-форму, если сложной логики нет.

Кастомная интеграция оправдана, когда заявка становится важной бизнес-сущностью, а не просто письмом с сайта. Чем больше данных, сценариев и ответственности, тем больше пользы от управляемой интеграции.