Право на склад ТЗ: видео-КП в Bitrix

Страница спецификации для команды внедрения, продукта и CRM-автоматизации.

Каскадное ТЗ для внедрения на prod

Видео-КП в Bitrix для «Право на склад»

От стадии «ПДР проведен» до готового видео, PDF и ссылки в сделке. Страница описывает, какие данные участвуют в КП, как сервер собирает инфографику, озвучку и MP4, а затем возвращает результат обратно в Bitrix.

МОП рабочая воронка для генерации
ПДР → КП старт и целевая стадия сценария
PDF + MP4 двойной результат для сделки
Bitrix → Backend валидируем поля сделки
Результат MP4, PDF, timeline
Иллюстрация генерации видео-КП
Цель проекта

Сделать управляемый и повторяемый механизм генерации КП по данным сделки, а не по ручным комментариям.

Бизнес-эффект

Менеджер быстрее отправляет персонализированное предложение, а РОП видит статус, ошибки и качество входных данных.

Критичное условие

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

Каждый этап реализации можно листать влево и вправо

Этап 01 Аналитика и нормализация

Фиксируем источник данных и правила запуска

  • Рабочая воронка: МОП.
  • Стартовая стадия: ПДР проведен.
  • Целевая стадия: КП готово.
  • Если обязательные поля пустые, генерация не стартует.
Этап 02 Валидация данных

Проверяем, можно ли по сделке собрать сильное КП

  • Компания и контакт должны быть указаны.
  • Услуга, стоимость, сроки и состав работ обязательны.
  • Итог ПДР и ключевая выгода обязательны.
  • При ошибке backend возвращает список незаполненных полей.
Этап 03 Сборка контента

Из сделки строится структурированный JSON для КП

  • Оффер, сегмент клиента, объект, стоимость, сроки, CTA.
  • Сценарий озвучки отделен от визуального сценария слайдов.
  • Шаблон можно менять без переделки Bitrix-интеграции.
  • Поддержка версий шаблона и разных стилей видео-КП.
Этап 04 Генерация медиа

Инфографика, voice, watermark и MP4 делаются сервером

  • HTML/React шаблон рендерится в изображения и PDF.
  • TTS движок собирает голосовую дорожку.
  • FFmpeg склеивает интро, слайды, озвучку и водяной знак.
  • Временные файлы живут ограниченно и очищаются по TTL.
Этап 05 Возврат в Bitrix

Готовые артефакты возвращаются в сделку и timeline

  • Сохраняются ссылки на PDF, MP4 и preview.
  • Добавляется комментарий в timeline с итогом генерации.
  • Можно использовать Disk для хранения файлов внутри Bitrix.
  • При успехе сделка переводится в стадию КП готово.
Этап 06 Контроль качества

РОП и команда видят прозрачный статус и причину сбоев

  • Статусы: черновик, готово к генерации, генерируется, ошибка, готово.
  • Логируются только технические статусы без лишней персонализации.
  • Шаблон, длительность и качество можно развивать итерационно.
  • Точка масштабирования: разные типы КП и разные сценарии для сегментов.

Как будет работать серверный конвейер генерации

Bitrix CRM Сделка в МОП ПДР проведен
Backend API Чтение сделки crm.deal.get / company / contact
Очередь задач Async job без синхронного ожидания фронта
Контент pipeline JSON → voice → slides template + validation
Результат PDF + MP4 + preview timeline, поля, links

Воронка и стадия запуска

Продажи ранний этап, не для генерации
МОП рабочая воронка сценария
ПДР проведен точка допуска к генерации
КП готово целевой результат
Юристы исполнение, не первичная продажа

Что именно участвует в генерации видео-коммерческого предложения

База сделки из Bitrix

  • ID сделки, TITLE, CATEGORY_ID, STAGE_ID
  • COMPANY_ID, CONTACT_ID, ASSIGNED_BY_ID
  • SOURCE_ID, TYPE_ID, DATE_CREATE, DATE_MODIFY
  • Статус генерации, ссылки на результат, текст ошибки

Обязательные поля оффера

  • Услуга / продукт
  • Пакет или тариф
  • Стоимость и спецусловие
  • Состав работ и срок реализации
  • Итог ПДР, задача клиента, ключевая выгода

Персонализация видео

  • Имя менеджера и контакты
  • Сегмент клиента и тип объекта
  • Город, площадь, срочность
  • Голос, watermark, версия шаблона
  • Финальный CTA и следующий шаг

Когда генерацию надо блокировать

Нет компании или контакта
Не заполнены услуга и оффер
Не указаны стоимость и срок
Нет итога ПДР и выгоды
Все поля есть — задача уходит в очередь

Что именно должно появляться после генерации

PDF КП

Быстрый статичный документ для пересылки и архива сделки.

MP4 видео-КП

Озвучка, инфографика, водяной знак и персонализация под клиента.

Preview image

Превью для карточки, мессенджеров и контроля качества.

Timeline запись

Комментарий в сделке со статусом, ссылками и версией шаблона.

Как это читается с телефона

Этап 03 из 06

Сборка контента

JSON структуры КП, voice script, slides config и подготовка MP4.

  • сделка и оффер
  • озвучка и watermark
  • PDF и timeline

Что сейчас мешает работать идеально

Нет структурированных полей КП

Сейчас стадия «КП готово» не гарантирует, что предложение хранится в самой сделке.

История активностей читается нестабильно

Webhook не всегда надежно отдает timeline и activity, поэтому нельзя делать их единственным источником правды.

Bitrix отвечает небыстро

Значит генерация и поиск результатов должны работать через background queue.

Чем реализуем на сервере

Node.js backend Bitrix REST API HTML / React template Puppeteer TTS engine FFmpeg Bitrix Disk / timeline

По этим пунктам можно принимать реализацию

Запуск из сделки

Кнопка или робот стартует только в МОП и только после стадии «ПДР проведен».

Валидация обязательна

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

Результат возвращается в Bitrix

После успеха в сделке есть MP4, PDF, preview, ссылки, timeline-комментарий и статус.

Система асинхронна

Фронт не зависает, а backend спокойно дожидается Bitrix и сборки медиа в очереди.