Сайт частной компании «ГРАНЬ» (ремонт квартир, домов, санузлов и кухонь в Москве) и его интеграция с Битрикс24.
Задача: заявки приходят из многих мест — формы, квиз, калькулятор, звонки, чат. Часть теряется, часть дублируется, а откуда пришёл клиент, никто не знает. Сайт и Битрикс24 связаны так, чтобы любая заявка за секунды становилась сделкой в нужной воронке, с источником, ответственным и задачей. Клиент видит ход ремонта в личном кабинете, не звоня менеджеру.
Перед работой сверялся с официальной документацией REST API Битрикс24: метод crm.deal.add (поля CATEGORY_ID и STAGE_ID, UTM_*, SOURCE_ID, IS_REPEATED_APPROACH, связи PARENT_ID_ со смарт-процессами, формат ответа и коды ошибок, включая QUERY_LIMIT_EXCEEDED). Учёл, что развитие crm.deal.add остановлено и для боевой версии рекомендуется crm.item.add.
Что вошло в проект: 15 страниц. Публичная часть: главная, услуги и цены, калькулятор, квиз, объекты, контакты, страница «спасибо» с логом обмена, личный кабинет клиента, 404 и политика конфиденциальности. Интерфейс CRM: воронки (канбан), карточка сделки, роботы и бизнес-процесс, журнал REST и вебхуков, схема интеграции. Адаптив под 1440 и 390 px, сетка Bootstrap 5.
Визуал. Палитра: бетонный серый, графит и сигнальный оранжевый. Шрифты Unbounded, Golos Text и JetBrains Mono. Фирменный приём — размерные линии на фотографиях («6 400 мм», «2 900 мм»), как на обмерном плане, и линейка с делениями в верхней границе секций. Сетка — Bootstrap 5, удобно натягивать на шаблоны 1С-Битрикс.
Точки входа заявок:
— Форма записи на замер с выбором типа объекта.
— Калькулятор: тип объекта, площадь, уровень ремонта и опции. Ориентир и срок пересчитываются сразу, весь расчёт уходит в сделку полем UF_CRM_CALC.
— Квиз из 5 вопросов с прогрессом. Ответы и выбранный мессенджер сохраняются в сделке.
— Виджет на всех страницах с двумя вкладками. «Перезвоните мне» регистрирует звонок через telephony.externalcall.register. «Чат» отправляет сообщения в открытую линию через imconnector.send.messages.
Логика обмена (модуль gran.b24 на стороне сайта 1С-Битрикс):
1. UTM-метки и номер визита сохраняются при первом заходе.
2. crm.duplicate.findbycomm ищет контакт по телефону. Если найден — сделка привязывается к старому контакту, помечается IS_REPEATED_APPROACH и уходит прежнему менеджеру. Если нет — создаётся контакт через crm.contact.add.
3. crm.deal.add: воронка (CATEGORY_ID) выбирается по типу объекта (квартиры, дома, санузлы и кухни). Также передаются стадия, сумма из расчёта, UTM_*, SOURCE_ID, ответственный и пользовательские поля.
4. crm.item.add создаёт элемент смарт-процесса «Замер» со своими стадиями, адресом и обмерным планом, связанный со сделкой.
5. tasks.task.add ставит задачу «Перезвонить» с дедлайном 15 минут.
6. Роботы стадий: SMS, эскалация через 30 минут, документы по шаблону, счёт, запрос отзыва. Бизнес-процесс «Обработка заявки» с ветвлением по признаку повторного обращения.
7. Исходящие события ONCRMDEALADD и ONCRMDEALUPDATE приходят на /local/b24/hook.php. Обработчик проверяет application_token и обновляет кабинет клиента.
Если портал ответил 503 QUERY_LIMIT_EXCEEDED, заявка остаётся в очереди модуля, агент отправляет её повторно. Для встройки в карточку сделки заложено локальное OAuth-приложение.
Кабинет клиента. Стадия сделки как этап ремонта: заявка → замер → смета → договор и работы → приёмка → сдан. Документы из сделки и смарт-процесса, график оплат, ход работ и чат с руководителем проекта. Кнопка «Согласовать смету» вызывает crm.deal.update и переводит сделку на следующую стадию.
Интерфейс CRM: канбан трёх воронок с перетаскиванием через crm.deal.update, карточка сделки с UTM и таймлайном, роботы и БП, журнал REST-вызовов с JSON запроса и ответа.
Технически: статическая вёрстка, генератор страниц на Python, общий CSS и JS без фреймворков, обмен с Битрикс24 в формате REST API, состояние в localStorage. Сквозной сценарий от визита с UTM до согласования сметы проверен на 1440 и 390 px: ошибок JS и горизонтального скролла нет.
Рабочий кликабельный сайт на 15 страниц. Пройден весь путь заявки: рекламный визит, форма или квиз, сделка в нужной воронке с источником и ответственным, роботы, кабинет клиента. Логику интеграции можно показать заказчику и по ней же составить ТЗ: какие методы, поля, воронки, смарт-процессы и роботы нужны.
Сделаю интеграцию вашего сайта с Битрикс24: формы и квизы в сделки, сквозная аналитика, роботы и БП, телефония, открытые линии, кабинет клиента.