Главное за минуту
- Опишите каждое поле формы: название, тип, обязательность и пример значения.
- Передавайте отдельно данные клиента, контекст страницы и рекламный источник.
- Согласуйте, куда попадёт заявка: лид, сделка, контакт или несколько сущностей.
- Принимайте работу тестами: заполненная форма, UTM, дубль и ошибка CRM.
01
Сначала опишите путь данных, а не форму
Интеграция сайта с Битрикс24 работает предсказуемо, когда у каждого значения есть назначение. Маркетологу нужно определить, что увидит менеджер, что нужно для аналитики и что должно остаться техническим журналом.
Разделите данные на три группы: сведения о клиенте, параметры обращения и контекст визита. Не заставляйте посетителя заполнять то, что сайт может передать автоматически: URL страницы, UTM, referer, время отправки и идентификатор формы.
02
Карта соответствия полей
Она связывает подписи на сайте с полями CRM и исключает потерю данных при доработках.
03
Какие поля включить в техническое задание
Соберите карту соответствия до передачи задачи. В ней важно не только название, но и формат, источник и правило обработки пустого значения.
Данные клиента
Имя, телефон, email, компания. Укажите маску телефона, допустимые символы и обязательность. Телефон лучше нормализовать в международный формат.
Параметры обращения
Тема, товар, комментарий, бюджет, удобный канал связи. Для списков передайте разработчику значения и их CRM-идентификаторы.
Контекст маркетинга
Название формы, страница отправки, URL, UTM, referer, client ID и время. Эти значения скрытые и не должны редактироваться посетителем.
04
Минимальная карта полей для CRM
Не копируйте все поля формы в одну строку комментария. Для фильтров, роботов и отчётов нужны отдельные поля CRM. Служебные параметры также передавайте раздельно: так можно сравнить кампании и найти страницу с проблемной конверсией.
| Поле на сайте | Поле в CRM | Правило |
|---|---|---|
| Телефон | Контакт: телефон | Обязательное, очистить пробелы и проверить формат |
| Название формы | Пользовательское поле | Передавать скрыто: «Расчёт», «Заказать звонок» |
| Страница отправки | Пользовательское поле | Полный URL, не только название раздела |
| UTM и referer | Поля источника | Сохранять первое и текущее значение по согласованному правилу |
05
Что написать разработчику
Задача должна описывать бизнес-результат, карту полей и сценарии ошибок. Фраза «подключить форму к CRM» не определяет ни сущность, ни правила для дублей, ни требования к аналитике.
Готовое сообщение
Цель: передавать заявки формы «Получить расчёт» в Битрикс24 без ручного переноса.
Сущность: создавать лид; при найденном телефоне не создавать дубль, а добавлять комментарий к существующему лиду и уведомлять ответственного.
Поля: имя, телефон, email, комментарий, название формы, URL страницы, товар, utm_source, utm_medium, utm_campaign, referer, дата отправки.
Правила: телефон обязателен; UTM брать из URL и хранить в cookie 30 дней; если меток нет, передавать пустое значение, не «undefined».
Приёмка: проверить обычную заявку, заявку с UTM, повторный телефон и недоступность CRM; ошибка не должна показываться пользователю как успешная отправка.
06
Как принять интеграцию формы с CRM
Проверяйте не только факт создания карточки. Цель — получить данные, по которым продажа может связаться с клиентом, а маркетинг — объяснить источник обращения.
- 1Отправьте форму с тестовыми именем, телефоном и email.
- 2Откройте созданную сущность и сверяйте каждое поле с картой.
- 3Перейдите по URL с UTM и убедитесь, что метки попали в CRM.
- 4Повторите отправку с тем же телефоном и проверьте правило дубля.
- 5Смоделируйте ошибку API: форма не должна сообщать об успешной заявке.
07
Два правила, которые экономят разборы
Заранее договоритесь о названиях и форматах. Тогда разработчик не угадывает смысл параметра, а маркетолог может сверить результат без доступа к коду.
Имена полей
form_name, page_url, product_name, utm_sourceИспользуйте латиницу и один стиль. Отображаемое название в CRM может быть русским.
Пустые значения
null вместо «не указано»Зафиксируйте, какие поля могут быть пустыми и что делать, если CRM временно недоступна.
08
Когда нужна помощь подрядчика
Подключайте разработчика, если форм несколько, есть нестандартные поля, требуется поиск дублей, очередь повторной отправки или распределение заявок по направлениям. В таких сценариях CRM-форма редко заменяет серверную интеграцию сайта.
Карта полей согласована с продажами; обязательность определена; UTM и URL передаются отдельно; сущность CRM выбрана; правило дублей описано; есть тест на ошибку CRM; назначен ответственный за приёмку.
FAQ
Частые вопросы
Какие поля обязательны в форме?
Обычно достаточно телефона или email. Остальные данные запрашивайте, только если они влияют на обработку заявки.
Нужно ли передавать все UTM-метки?
Да, минимум source, medium, campaign, content и term. Также полезны referer и URL страницы.
Куда лучше создавать заявку: в лид или сделку?
Зависит от процесса продаж. Выберите сущность вместе с руководителем отдела продаж до начала разработки.
Что делать при дубле по телефону?
Зафиксировать правило: создать новую сущность, обновить существующую или добавить комментарий ответственному менеджеру.
