
В исходных задачах требуется новое направление для обращений нескольких сайтов, а механизм передачи прямо оставлен для проверки. Поэтому ниже нет утверждения, что все формы используют один вебхук или один API. Учебная схема содержит сайты А/Б и условную целевую воронку. Реальные идентификаторы, ключи подключения и клиентские заявки не используются.
Составить реестр точек
Перечислите сайты, страницы и типы обращений: общий вопрос, запрос по товару, модальная форма, обратный звонок и заказ, если они реально существуют. У каждой точки должен быть владелец и ожидаемый результат. Не считайте одинаковый дизайн доказательством общего обработчика. Визуально одинаковые формы могут происходить из разных поколений шаблонов.
Для каждой записи укажите тип сущности CRM. Лид, сделка, контакт и элемент смарт-процесса имеют разный смысл. Требование «новая воронка» нельзя механически применить к любой сущности. Сначала определите, что создаётся сейчас и что должно создаваться после изменения. Нельзя случайно сменить весь режим работы CRM ради настройки одного канала.
Реестр должен включать альтернативные и редкие пути: мобильный шаблон, форму в подвале, повторное открытие модалки, отправку из сохранённой корзины. Именно они часто остаются на старом направлении. Не нужно сразу обследовать весь интернет-сайт без границ; используйте фактический список компонентов и ссылок, затем проверяйте обнаруженные точки.
| Точка | Механизм | Ожидаемый результат |
|---|---|---|
| Форма сайта А | Нужно подтвердить | Сущность и новое направление |
| Модальная форма | Нужно подтвердить | Тот же согласованный маршрут |
| Заказ магазина | Отдельная интеграция возможна | Состав и сумма сохранены |
| Форма сайта Б | Может отличаться | Своя принадлежность источника |
Определить фактический механизм
Посмотрите код вставки, сетевой запрос и серверный путь в разрешённой среде. Встроенная CRM-форма может отправлять данные по своему механизму, а собственная форма обращаться к сайту, который затем создаёт запись. Вебхук является способом подключения, но не описывает всю бизнес-логику. Не публикуйте его URL: он способен содержать секрет доступа.
Официальная справка Битрикс24 описывает выбор создаваемой сущности во встроенной CRM-форме и воронки для сделки. Это относится к соответствующему продукту, а не автоматически к произвольному HTML-блоку сайта. Для собственной интеграции проверяют действующий контракт и место, где выбирается направление. Точные параметры API нельзя придумывать по похожему названию поля.
Зафиксируйте, где хранится маршрут: в кабинете формы, настройке сайта, серверной конфигурации или отдельном правиле. Если источников несколько, новая воронка должна быть применена в нужных местах без изменения несвязанных каналов. Не копируйте ключ подключения из соседнего проекта только потому, что его форма уже работает.
Подготовить целевое направление
Проверьте существование нужной сущности и воронки, стадии, права подключения и доступ ответственных. Запись может успешно создаться, но не быть видна сотруднику из-за роли. Это не равно потере заявки. Приёмка должна различать отсутствие записи и отсутствие права её увидеть. Используйте разрешённую учебную учётную запись и не запрашивайте чужую сессию.
Уточните, какие автоматизации запускаются при поступлении в новую область. Туннели, роботы и уведомления могут менять итоговый результат. Не переносите реальные заявки для эксперимента. На учебной записи проверьте согласованный минимальный путь и отметьте непроверенные внешние действия. Создание в новой воронке не должно неожиданно отправить сообщение настоящему клиенту.
Ответственный и источник обращения тоже требуют явного решения. Смена воронки не обязана менять их автоматически, если такова модель. Нельзя считать первый доступный сотрудник правильным запасным значением. Если назначение зависит от сайта или типа формы, сохраните эту принадлежность в реестре и проверьте после переключения.
Разделить новые и существующие обращения
Перенаправление будущих отправок не означает перенос старых сделок. История, задачи и автоматизации существующих записей могут требовать отдельной процедуры. Не выполняйте массовую миграцию данных как побочный эффект изменения формы. В этой статье основная задача относится к маршруту новых обращений и сверке незавершённого хвоста передачи.
Определите границу переключения по времени и версии конфигурации. Для заявок, уже стоящих в очереди, нужно решить, применяется сохранённый маршрут или новый. Оба варианта могут быть допустимы по процессу, но нельзя оставлять выбор случайному моменту обработки. Реестр должен объяснять, где искать запись, созданную около границы изменения.
Если старая интеграция не завершилась, не создавайте новую копию вслепую. Неизвестный сетевой результат требует проверки по устойчивому ключу или документированному механизму повторов. Миграция направления должна сохранять существующую защиту от дублей, а не обходить её прямым альтернативным запросом.
Подготовить управляемую конфигурацию
Для собственных форм полезно одно доверенное сопоставление «тип обращения и сайт → разрешённый маршрут», если оно соответствует архитектуре. Браузер не должен свободно задавать внутренний идентификатор воронки. Он передаёт разрешённый контекст, а сервер выбирает конфигурацию. Это сохраняет контроль и упрощает проверку области изменения.
Если встроенные формы настраиваются отдельно в кабинете, не притворяйтесь, что одна серверная константа управляет ими всеми. Отметьте каждый источник и примените изменение штатным способом. История настройки должна позволять понять, что было изменено и как вернуть прежнее значение. Не сохраняйте секреты и клиентские данные в общем плане.
Сделайте минимальный эксперимент до массового переключения: одна учебная точка, одна разрешённая запись и проверка внешнего результата. Он подтверждает права, формат и доступность новой области. Если эксперимент не прошёл, остальные независимые материалы можно подготовить, но нельзя объявлять всю группу переведённой по факту сохранённой настройки.
Проверить одну точку полностью
Отправьте синтетические данные через фактический интерфейс на разрешённой учебной среде. Проверьте валидацию, сетевой результат, созданную сущность, воронку, ответственного и существенные поля. Для заказа дополнительно сравните состав и валюту. Успешный ответ формы сам по себе не доказывает правильное направление.
Проверьте повторное открытие и ошибку отправки. Форма должна сохранять ввод по своим правилам и не создавать дубль при повторе. Если новое направление имеет другие обязательные поля, ошибка должна быть понятной и наблюдаемой. Нельзя молча отправлять такую заявку обратно в старую воронку только ради зелёного ответа.
Затем используйте подготовленный сценарий для остальных точек с тем же механизмом. Не повторяйте исследование архитектуры заново для каждой кнопки. Но фактическая отправка каждой независимой конфигурации нужна, чтобы подтвердить покрытие. Общая библиотека уменьшает число разных технических проверок, а не отменяет проверку того, что конкретная форма к ней подключена.
Пройти все сайты и состояния
Для каждого сайта проверьте обычную форму, модалку и мобильный вариант из реестра. Укажите результат в одной таблице, а не создавайте десятки несвязанных отчётов. Важен обозримый статус: подготовлено, локально проверено, подтверждено в CRM или требуется доступ. Не смешивайте эти состояния одним словом «готово».
Проверьте формы после динамической подгрузки и переходов без перезагрузки. Старый код вставки может оставаться в кэше или отдельном шаблоне. Одна исправленная главная не подтверждает страницы товара и статьи. Выберите типажи, использующие разные источники, и сохраните минимально достаточную матрицу.
Если есть языковые версии, убедитесь, что технический маршрут не зависит от текста перевода. Источник и название обращения могут локализоваться, но принадлежность сайта должна быть устойчивой. Нельзя случайно направить всю локаль в другую область только из-за общего запасного значения. Реестр помогает увидеть такие различия до массовой проверки.
Сверить хвост и период переключения
После изменения сопоставьте обращения сайта и CRM за ограниченный период вокруг границы. Используйте устойчивые ключи, а не только общее количество. Пропуск и дубль способны дать одинаковую сумму строк. Каждая запись должна иметь объяснимый итог: создана в ожидаемой области, ожидает уточнения или отклонена по видимому правилу.
Старое направление может ещё содержать законные обращения до границы. Не удаляйте их и не переносите автоматически только ради чистой таблицы. Сначала отделите ожидаемую историю от реально ошибочного маршрута. Исправление существующей записи может затронуть работу сотрудников и требует отдельной авторизации, если не входило в согласованный объём.
Проверьте новые поступления после возвращения в штатный режим. Успешное восстановление одной старой заявки не подтверждает текущий поток. Наблюдение должно показывать, что все активные точки отправляют в новую область и отставание не растёт. Интервалы и допустимая задержка определяются проектом, без универсального числа минут из статьи.
Обновить наблюдение и инструкции
Уведомления и отчёты могут продолжать смотреть старую воронку. Тогда новые заявки есть, а ответственный считает поток остановленным. Обновите только те наблюдения, которые относятся к изменённому маршруту, и проверьте права просмотра. Не расширяйте доступ всем сотрудникам автоматически ради видимости новой области.
В диагностике достаточно типа формы, сайта, версии маршрута и категории результата. Полные контакты и сообщения посетителей не нужны для проверки покрытия. Секреты вебхуков и токены не должны попадать в скриншоты. Для публичной иллюстрации используйте условные сайты А/Б и безопасные статусы.
Редакторская или операционная инструкция должна объяснять, где искать новые обращения и как сообщить о пропуске. Техническая заметка хранит источники конфигурации, границу изменения и способ контрольной сверки. Это помогает сопровождать процесс без повторного исследования всех форм при следующем изменении направления.
Подготовить возврат конфигурации
Если новая точка не проходит проверку, нужен способ вернуть прежний маршрут только в затронутой области. Сохраните предыдущие значения и ответственного до переключения. Но возврат настройки не удаляет уже созданные записи и не отменяет запущенные действия CRM. Эти последствия проверяют отдельно; нельзя считать откат конфигурации полным возвратом бизнес-истории.
После стабилизации уберите устаревшие активные пути, если они больше не должны принимать новые обращения. Старый обработчик, оставленный «на всякий случай», может продолжать получать формы из кэша и делить поток. Сначала подтвердите отсутствие нужных потребителей, затем применяйте разрешённую процедуру отключения, сохраняя понятный ответ для ошибочного старого вызова.
Подготовить итоговую матрицу
| Проверка | Подтверждение |
|---|---|
| Все точки перечислены | Нет неизвестных активных форм в области задачи |
| Механизмы определены | Встроенные и собственные пути не смешаны |
| Целевая область доступна | Права и обязательные данные проверены |
| Каждая конфигурация отправлена | Сохранённый результат найден в CRM |
| Хвост сверён | Нет необъяснённых пропусков и дублей |
| Наблюдение обновлено | Новые записи видны ответственным |
Если доступа к учебной CRM нет, для каждой точки сохраните ожидаемый тип сущности, целевое направление и этап, до которого дошла проверка. Локальная валидация и ответ обработчика отмечаются отдельно от чтения сохранённой записи. После получения доступа сверяйте те же контрольные обращения по устойчивому ключу. Не создавайте новые копии только для замены отсутствующей отметки о результате прежней попытки.
Задача завершена по покрытию и фактическому результату, а не по одной изменённой настройке. Все формы сохраняют своё назначение и данные, новые обращения приходят в согласованную область, а история и незавершённые попытки обработаны по явному правилу. Это делает переключение проверяемым и не превращает его в бесконечный поиск забытых кнопок.
Связанный разбор: Разработка API для интернет-магазина: обмен и контроль ошибок.
Документация и источники
- Битрикс24: как создать и настроить CRM-форму: Встроенная CRM-форма выбирает создаваемую сущность; для сделки задаётся воронка. Своя интеграция требует отдельной проверки механизма.