Интеграция сайта с CRM: поля, дубли и SLA
Практическая архитектура формы → очередь → CRM: источники, идентификаторы, дедупликация, маршрутизация, ошибки, privacy и приёмка.
Главное за 30 секунд
Интеграция должна гарантированно принимать заявку, сохранять источник и поднимать тревогу при сбое. Прямая отправка формы в CRM без очереди, идентификатора и журнала ошибок удобна только до первого падения внешнего API.
Начните с бизнес-события
Опишите, что считается заявкой: отправленная форма, подтверждённый телефон, запись на встречу или оплаченный заказ. Затем определите, какой объект создаётся в CRM — контакт, сделка, обращение или несколько связанных сущностей.
Не переносите структуру формы один к одному. Поле интерфейса может быть временным, а CRM требует нормализованные справочники и стабильные идентификаторы.
Обязательные данные
- Уникальный ID события и время на сервере.
- Контакты в нормализованном виде и язык формы.
- Страница, форма, услуга и свободный комментарий.
- UTM, referrer, click ID и первый/последний известный источник.
- Согласие, версия политики и техническая информация, необходимая для расследования ошибки.
Что решить до разработки формы
Сначала откройте страницу услуги на телефоне и сформулируйте, что менеджеру нужно узнать для первого полезного ответа. Для запроса на сайт это может быть тип проекта, существующий адрес, нужные языки и способ связи. Просьба сразу заполнить длинное техническое задание способна остановить человека до обращения. Дополнительные сведения можно собрать после первого контакта. Пример короткого пути пользователя есть в разборе страницы услуги.
Отдельно запишите, что видит посетитель после отправки. Сообщение об успехе допустимо после подтверждённого приёма заявки сервером. Если CRM временно недоступна, сохранённое событие должно дожидаться повторной передачи, а ответственная команда должна видеть ошибку. Текст на экране и фактическое состояние заявки должны совпадать.
Архитектура с защитой от потерь
- Сайт валидирует ввод и отправляет данные на собственный backend.
- Backend присваивает ID, сохраняет событие и быстро отвечает пользователю.
- Очередь или worker передаёт событие в CRM.
- CRM возвращает идентификаторы созданных объектов.
- Мониторинг отслеживает задержки, повторы и постоянные ошибки.
Правила дедупликации
Сначала защититесь от повторной доставки одного события по idempotency key. Затем ищите существующий контакт по нормализованному телефону и email. Решение о новой сделке принимайте отдельно: повторный клиент может создавать новый коммерческий интерес.
Не объединяйте людей только по имени. Общий корпоративный номер или семейный email тоже требует осторожной модели.
Маршрутизация и SLA
- Услуга и регион определяют воронку или направление.
- Язык и график определяют ответственного менеджера.
- CRM ставит задачу первого контакта с дедлайном.
- Просроченная заявка эскалируется руководителю.
- Результат контакта обязателен и используется в отчёте качества.
Ошибки, о которых команда должна узнать
- CRM недоступна или отвечает слишком долго.
- Токен истёк, права изменились, справочник не принимает значение.
- Событие прошло, но объект не создан.
- Очередь растёт быстрее обработки.
- Доля заявок сайта и CRM расходится.
Privacy и безопасность
Передавайте данные по HTTPS, ограничивайте роли, маскируйте контакты в логах и не помещайте секреты в клиентский код. Срок хранения и процесс удаления должны быть зафиксированы. Для конкретных требований законодательства привлекайте профильного юриста.
Приёмка интеграции
- Протестировать все формы, языки, обязательные и необязательные поля.
- Повторить один запрос и проверить отсутствие технического дубля.
- Отключить тестовую CRM и проверить очередь, retry и alert.
- Сверить UTM и источник с аналитикой.
- Проверить задачу, ответственного, SLA и отчёт руководителя.
Протокол приёмки для владельца бизнеса
Составьте таблицу из четырёх колонок: форма и страница, действие клиента, ожидаемая карточка в CRM, ответственный за проверку. Для каждой услуги и языковой версии отправьте тестовую заявку с безопасными вымышленными данными. Сверьте время, услугу, источник, комментарий и назначение менеджера. После проверки пометьте тестовые карточки, чтобы они не попали в отчёт реальных обращений.
Испытайте повторное нажатие, медленную сеть и ошибку сервера. При сбое пользователь должен получить понятное сообщение, а команда сохранить возможность расследования. Когда все сценарии пройдены, проверьте тот же путь на опубликованном домене. Локальный тест формы не доказывает, что настройки production-сервера и доступы CRM совпадают с тестовой средой.
В еженедельной сверке разделяйте принятые сервером заявки, доставленные в CRM, назначенные менеджеру и обработанные. Разница между этапами показывает место потери. Клик по кнопке и событие аналитики не равны подтверждённой заявке. Если нужен сайт сразу с таким путём обращения, состав работ можно обсудить на странице разработки сайтов TIPA; для существующего сайта начните с проверки формы и передачи событий.
Клиент отправил форму, а звонка нет: как найти заявку
Попросите клиента назвать примерное время и страницу обращения, используя только необходимые сведения. Зафиксируйте обращение вручную с пометкой о проверке, чтобы сотрудник мог продолжить разговор. Техническое расследование ведите по идентификаторам и времени. Сообщение об успешной отправке на сайте само по себе не подтверждает создание сделки и назначение ответственного.
Пройдите цепочку последовательно: запрос браузера, принятие сервером, сохранение события, очередь передачи, ответ CRM, созданная карточка, назначение и уведомление. На каждом шаге нужен наблюдаемый результат. Если событие в серверном журнале отсутствует, проверьте форму и сеть. Если событие сохранено, а CRM отказала, изучите код ошибки и обязательные поля. Если карточка существует, проверьте права сотрудника, фильтры списка и его задачи.
Условный сценарий: после добавления обязательного поля в CRM сайт продолжает показывать сообщение об успехе, а события попадают в очередь ошибок. Ответственный исправляет сопоставление полей, повторяет передачу сохранённых событий и сверяет созданные карточки. Ручную заявку клиента связывают с исходным событием, чтобы повторная доставка не вызвала два звонка. Фактическую причину устанавливают по журналам, а этот пример используют как вариант проверки.
После исправления отправьте вымышленную заявку через каждую затронутую форму, проверьте карточку и завершение задачи сотрудником. Отдельно испытайте повторную отправку и временную недоступность CRM в тестовом контуре. Для контроля назначьте владельца очереди ошибок, порог задержки и способ уведомления. В отчёте сверяйте принятые сервером события с доставленными и ожидающими обработки. Проверка заканчивается, когда пропущенные обращения разобраны, а причина сбоя устранена. Организацию такого обмена можно включить в автоматизацию обработки заявок.
Первичные источники и документация
Следующий шаг
Если хотите применить схему к своему проекту, получите схему интеграции сайта и CRM. Сначала зафиксируем исходные данные и критерии готовности, затем оценим объём работ.
По теме
Если решаете связанную задачу, продолжите с конкретным сценарием:
Посчитайте стоимость под вашу задачу
Ориентир. Точная смета — после аудита процессов.
Бесплатная диагностика за 24–48 часов: посмотрим ситуацию, скажем что даст результат, дадим смету.
