ТЗ на интеграцию сайта с CRM

Что передать разработчику: источники, поля, повторы, ошибки и приемка. Скачайте шаблон ТЗ и изучите условный пример заполнения.

Скачать шаблон ТЗ Посмотреть пример заполнения

Опишите путь одной заявки

Хорошее ТЗ объясняет, какое событие запускает передачу, где должна появиться запись и кто начнет работу. По одному обезличенному примеру согласуйте поля, правила повторов, отказ и приемку. Выбор способа подключения делайте после этой проверки.

Источник и событие: Адрес сайта, форма и момент передачи. Например, успешная проверка формы, а не каждое нажатие кнопки. Перечислите все формы первой версии.
Получатель и результат: Название CRM, тип записи, воронка, начальный статус и ответственный. Уточните, создается ли новый контакт или используется существующий.
Границы первого этапа: Что входит: одна форма, несколько сайтов, заказ, вложения? Что пока остается ручным? Двусторонний обмен и перенос старой базы выделите отдельно.

Составьте карту полей

Для каждого поля нужны источник, место в CRM, обязательность, формат и действие при пустом или неверном значении. Реальные названия полей и доступ к ним проверяют в выбранной CRM.

Контакт: Телефон или email из формы. Согласуйте проверку и правило сопоставления клиента. Совпадение контакта само по себе не означает повтор заказа.
Содержание обращения: Текст задачи и согласованные поля заказа. Задайте допустимый объем и обработку неподдерживаемого формата; не удаляйте содержание молча.
Источник: Страница, код формы и разрешенные метки. Передавайте нужные значения; не копируйте полный адрес с секретными параметрами.
Идентификатор события: Один идентификатор для одной принятой отправки и ее технических повторов. Новая заявка получает новый идентификатор. Место хранения связи с записью CRM согласуйте отдельно.
Статус и ответственный: Значения определяет правило проекта, а не свободный текст посетителя. Укажите действие, если нужный сотрудник или стадия недоступны.

Разделите повтор и новую заявку

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

Временный отказ: Согласуйте надежное место ожидания, интервал и предел повторов. После исчерпания попыток ответственный получает задачу на ручную обработку. Не обещайте посетителю сохранение, если оно не подтверждено.
Ошибка полей или доступа: Не повторяйте неизмененный неверный запрос бесконечно. Сохраните безопасное описание причины, назначьте исправление и способ возобновления.
Проверка и наблюдение: Журнал содержит время, идентификатор события, результат, номер попытки и ссылку на запись при успехе. Срок хранения, доступ и состав данных согласуются. Ключи и токены в журнал не попадают.

Пример: форма запроса услуги

Условное ТЗ для одной формы. Имена, контакты и правила ниже демонстрационные. Это не рабочие данные клиента и не описание уже выполненного внедрения. Перед запуском значения и доступные возможности нужно проверить.

Задача: После проверки формы «Запрос услуги» принять обращение и передать его в выбранную CRM. Первая версия передает данные только с сайта в CRM; оплаты, файлы и старая база исключены.
Поля: Имя: «Тестовый клиент»; email: client@example.com; задача: «Нужен сайт услуг». В CRM: имя контакта, email и описание новой сделки. Поля и формат проверяются до настройки.
Маршрут: Источник «Сайт», согласованная воронка продаж, начальная стадия «Новая заявка». Ответственный менеджер назначается владельцем процесса. Это условные значения, не коды API.
Повторы: Событие demo-enquiry-001 передается повторно с тем же идентификатором. Ожидаем одну сделку. Новое обращение с тем же email и другим событием создает новую сделку, связанную с прежним контактом.
Сбой и восстановление: В тестовой среде отключить прием CRM. Обращение остается в согласованном хранилище ожидания. После восстановления сверить результат и передать его без лишней сделки. Ответственный видит ошибку и итог.

Скачать заполненный пример

Реальное основание для обсуждения заказа: в ДОРОГЕ форма создает запись со статусом «Новый» и источником «Сайт». Резерв топлива, поставки и касса являются отдельной логикой. Кейс показывает экран с демонстрационными данными.

ДОРОГА: сайт и CRM заказов

Проверьте результат по шести сценариям

Новая заявка: одна запись, согласованные поля, источник, статус и доступ назначенного сотрудника.
Неверное обязательное поле: понятная ошибка; отсутствует некорректная сделка и ложное подтверждение приема.
Повтор того же события: одна сделка, результат повторной передачи можно найти в журнале.
Новое событие прежнего клиента: применяется согласованное правило контакта, новая задача не теряется.
Временный отказ и потерянный ответ CRM: обращение обнаруживается, результат сверяется, после восстановления нет лишней записи.
Передача команде: инструкция, необходимые доступы, ответственные, контроль ошибок и условия поддержки получены.

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

Вопросы к ТЗ

Нужно знать названия API-методов?

Для первичного ТЗ достаточно описать источник, действие и результат. Технический способ, доступные поля и ограничения выбранной CRM проверяет исполнитель. Названия методов добавляют в техническое приложение после проверки.

Достаточно написать «без дублей»?

Нет. Повтор одной отправки и новая задача прежнего клиента требуют разных правил. Укажите, когда использовать существующий контакт, когда создавать новую сделку и как распознать повтор события.

Обязательно нужен собственный обработчик?

Нет. Сначала проверяют штатную форму и готовое подключение. Отдельная разработка нужна, если они не закрывают согласованные поля, маршрут и обработку отказов.

Кто должен получать сообщение об ошибке?

Назначьте ответственного за технический сбой и сотрудника, который продолжит работу с обращением вручную. Уточните канал, условия эскалации и порядок восстановления.

Можно приложить рабочую базу и токен?

Для обсуждения используйте обезличенный пример. Рабочий доступ оформляют отдельно с необходимыми правами. Ключи не размещают в публичном ТЗ, браузерном коде или журнале ошибок.

Этот пример уже внедрен у клиента?

Пример ниже условный. Он показывает способ заполнения ТЗ и ожидаемую приемку. Кейс ДОРОГИ отдельно подтверждает создание заказа с сайта; это не подтверждение всех правил из примера.

Что уточнить для вашей CRM

Первичный разбор BYstudio бесплатный. Пришлите адрес сайта, название CRM и обезличенный пример результата. Разберем готовое подключение и объем доработки. Полное ТЗ не требуется для первого обращения.

Способы подключения сайта к CRM

Надежный прием заявок

Готовая CRM или собственная система

Документация для технического приложения

Возможности конкретной CRM проверяйте по актуальной документации. Например, у Битрикс24 есть правила настройки CRM-форм, поиск совпадений контактов и ограничения REST. Поиск контакта и защита от повтора события решают разные задачи.

Документация проверена 21 октября 2026. Правила примера выше являются предложением для ТЗ, а не настройками по умолчанию любой CRM.