Форма собирает услугу и комментарий, но в CRM приходит только имя. Или выбранный город попадает в поле, которое ожидает внутренний код. Интеграция может успешно создать запись, потеряв половину смысла обращения. Карта полей нужна, чтобы передавать правильные значения в правильные места и проверять результат.
Начните с назначения записи
Определите, что создаётся в CRM и как с этим работает менеджер. Контакт, обращение и сделка могут иметь разные поля. Не переносите весь набор формы в первый доступный объект, если сотрудники ждут сведения в другой карточке.
Для каждого значения запишите бизнес-смысл. Например, выбранная услуга помогает распределить обращение, а комментарий раскрывает задачу. Если поле используется для отчёта или автоматического действия, его формат особенно важен.
Различайте название и идентификатор
В интерфейсе CRM поле может называться «Направление», а API использовать другой ключ. У перечисления каждый вариант также может иметь отдельный идентификатор. Текст «Ремонт» не обязательно является допустимым значением для записи.
| Поле сайта | Что определить в CRM |
|---|---|
| Контакт | Тип и способ сопоставления с существующей записью |
| Услуга | Поле и допустимые варианты |
| Комментарий | Место хранения и ограничение длины |
| Источник | Отдельные поля по выбранной модели |
| Идентификатор заявки | Способ связи и проверки повторной передачи |
Получите перечень полей используемого объекта средствами CRM. Проверьте обязательность, тип и возможность изменения. Ключи пользовательских полей могут различаться между порталами. Их нельзя слепо копировать из чужого примера.
Опишите преобразование значения
Нужно согласовать телефон, дату, число, перечисление и многострочный текст. Для чисел важно значение разделителя и единица. Для даты часовой пояс и назначение. Не исправляйте данные универсальным удалением всех знаков, если это меняет смысл.
Отдельно задайте правило пустого поля. Отсутствие нового значения не обязательно означает очистку существующего. Если форма передаёт только часть сведений, интеграция должна обновлять только разрешённый набор, сохраняя остальную карточку.
Назначьте владельца полей
Часть данных ведёт сайт, часть менеджер. Если сотрудник уже уточнил имя или назначил ответственного, следующая отправка формы не должна безусловно отменять его работу. Укажите, какие поля заполняются только при создании, а какие можно обновлять.
Для двустороннего обмена нужны правила конфликтов. Если обе системы изменяют значение, время последнего запроса не всегда показывает достоверность. Можно разделить владельцев или использовать согласованные версии. Главное, чтобы решение было известно команде.
Предусмотрите неподдерживаемые варианты
На сайте появилась новая услуга, а в CRM ещё нет соответствующего значения. Обмен должен показать понятную причину и сохранить обращение. Случайная подстановка первого варианта исказит маршрутизацию и отчёт.
Для длинного комментария определите допустимую обработку. Если часть информации переносится в отдельное место, сотрудник должен её найти. Не обрезайте молча важный текст и не называйте такую передачу полной.
Проверьте карту на завершённых записях
Подготовьте заявки с разными услугами, пустым необязательным полем, длинным текстом и существующим контактом. Откройте созданные записи в CRM и сравните каждое значение. Успешный ответ API не гарантирует, что данные попали туда, где их ожидает менеджер.
Проверьте повтор, изменение поля сотрудником и неизвестный вариант. Журнал должен связывать заявку сайта с внешней записью и причиной ошибки. Секретные учётные данные в такой отчёт не включаются.
В QuickLanding можем подготовить карту передачи и реализовать обмен с проверкой границ обновления. Для оценки нужны формы, пример карточки CRM и правила работы менеджеров. Документ станет основой для приёмки и дальнейшего добавления новых услуг без случайной потери значений.
Документация и проверка сведений
Технические сведения сверены с документацией на 7 октября 2026 года. При настройке конкретного сервиса проверьте его текущую версию и действующие инструкции.
Материалы по соседним задачам
Коротко о важном
Достаточно одинаково назвать поля на сайте и в CRM?
Нет. API может использовать отдельные идентификаторы и типы. Проверьте технические ключи, варианты и права. Внешнее название помогает человеку, но не является универсальным правилом передачи.
Пустое поле формы должно очищать CRM?
Только если такое действие согласовано. Частичная форма часто не содержит обновления для существующего значения. Различайте отсутствие данных и намеренную очистку.
Как добавить новую услугу в форму?
Проверьте соответствующий вариант CRM и правила распределения. Обновите карту, затем протестируйте передачу. Неизвестное значение должно вызывать понятную обработку, а не случайную подстановку.
Разработка и SEO в QuickLanding. Помогаем разобраться в задаче и выбрать подходящий состав работ.
Об эксперте
