Онлайн-запись на Битрикс24 Вайбкод: сетка мастеров и залов

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

Когда штатной записи не хватает

Коробочная логика расписания в Битрикс24 рассчитана на стандартные сценарии. Проблемы начинаются, когда бизнес одновременно управляет несколькими ресурсами: мастером, кабинетом, оборудованием - и хочет видеть их загрузку в одном окне. Типичные ситуации, где штатного функционала не хватает:

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

Во всех этих случаях нужен кастомный интерфейс. Вайбкод - это платформа Битрикс24 для сборки таких приложений: описываешь задачу агенту, он пишет код и разворачивает решение на защищённом сервере. Готовое приложение автоматически появляется в каталоге портала.

Главное архитектурное решение: где хранить записи

Это самый важный выбор при проектировании. Записи нужно хранить в штатных сущностях Битрикс24 и в пользовательских полях - не во внутренней базе самого приложения.

Причина прямая: если данные живут внутри приложения, они оторваны от остальных инструментов портала. Штатные отчёты, BI-конструктор, дашборды, роботы по сделкам - всё это перестаёт видеть записи. Приложение превращается в отдельную систему, которую потом не с чем связать.

Правильная схема: каждая запись - это элемент смарт-процесса или сделка в CRM, а данные о ресурсе (мастер, кабинет, время) хранятся в пользовательских полях этого элемента.

Vibe API, через который Вайбкод обращается к Битрикс24, поддерживает полный CRUD для смарт-процессов и сделок. Приложение создаёт, читает и обновляет записи через те же методы - данные немедленно доступны в отчётах портала без дополнительной синхронизации.

Как устроена сетка и что происходит при клике

Визуально сетка - это таблица: по горизонтали время (слоты), по вертикали ресурсы (мастера, кабинеты, залы). Приложение запрашивает через Vibe API записи за нужный день и отрисовывает занятые слоты поверх сетки.

Запись создаётся кнопкой или кликом по свободному слоту. Перед сохранением приложение обязательно проверяет пересечение: запрашивает элементы, у которых пользовательские поля «мастер», «кабинет» и «время» пересекаются с запрашиваемым слотом. Если пересечение найдено - слот блокируется, пользователь видит предупреждение.

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

Поток от обращения до подтверждённой записи выглядит так. Приложение запрашивает занятые слоты через Vibe API, отрисовывает сетку, принимает клик, проверяет пересечение и создаёт элемент CRM:

flowchart TD
    USER[Клиент / администратор] --> APP[Приложение Вайбкод]
    APP -->|crm.item.list - занятые слоты| VAPI[Vibe API]
    VAPI --> B24[Битрикс24 CRM]
    B24 -->|данные слотов| VAPI
    VAPI --> APP
    APP -->|проверка пересечения| APP
    APP -->|crm.item.add - новая запись| VAPI
    VAPI --> B24
    B24 -->|ID записи| APP
    APP --> USER

Клиент на лету: поиск и создание контакта прямо из формы

При записи администратор вводит фамилию или телефон. Приложение ищет контакт через Vibe API методом crm.contact.list. Если контакт найден - подставляет его в форму. Если нет - предлагает создать прямо здесь, не переходя в раздел CRM.

Это важно по двум причинам:

1. База не засоряется дублями - контакт создаётся один раз.
2. Новый контакт сразу попадает в CRM и участвует в воронке, триггерах и рассылках.

Для создания контакта приложение вызывает crm.contact.add через Vibe API. Vibe API сам выстраивает запросы в очередь и соблюдает лимиты портала - разработчику не нужно думать об этом вручную.

Если запись нужно привязать к текущей сделке (например, повторный визит клиента из воронки), приложение дополнительно вызывает метод обновления сделки и проставляет связь. Это типовое узкое место - подробнее в разделе про практические проблемы.

Размещение приложения: галактика, каталог, плейсмент

Приложение разворачивается на сервере Вайбкода. Для небольших решений - в галактике: это хост, где на одном сервере размещается несколько приложений, тарифицируется сам хост. Более нагруженные или изолированные сценарии - на отдельном Black Hole-сервере.

После деплоя приложение автоматически появляется в каталоге приложений внутри портала. Оно доступно в вебе и в мобильном приложении Битрикс24 при адаптивной вёрстке.

Если нужно показывать сетку прямо внутри карточки сделки или контакта - используют встройку через плейсмент. Плейсмент CRM_DEAL_DETAIL_TAB добавляет вкладку с сеткой записей прямо в карточку сделки. Для отдельной страницы внутри портала подходит LEFT_MENU - приложение появляется в левом меню как отдельный раздел.

Тип ключа для приложения выбирают исходя из задачи: простой API-ключ работает от имени владельца; ключ авторизации (OAuth-приложение) даёт работу под правами конкретного пользователя и создаётся администратором портала. Для сетки записей, где важно знать, кто создал запись, подходит ключ авторизации.

Если часть данных нужна только для чтения - например, список мастеров и их расписание для клиентского виджета - используют ключ только для чтения: запись блокируется на стороне Вайбкода ещё до обращения к Битрикс24.

Подробнее об архитектуре деплоя можно прочитать в статье о Black Hole-серверах и галактиках.

Уведомления и напоминания: как не строить свой канал

Напоминания о записи - стандартное требование. Клиенту нужно напомнить за день и за час, администратору - собрать утреннюю сводку на день.

Разумный подход - переиспользовать штатные уведомления портала, а не строить отдельный канал доставки. В Битрикс24 это роботы и триггеры на смарт-процессе: создали запись - запустился робот, который отправляет сообщение через открытую линию или уведомление сотруднику в нужное время.

Если нужны утренние рассылки или напоминания с точным временем старта - у спящего сервера в галактике настраивают пробуждение по расписанию. Это важно: без пробуждения по расписанию сервер может не запустить задачу вовремя - только когда кто-то откроет приложение вручную.

Собственный канал доставки уведомлений строить придётся, только если нужна доставка во внешний мессенджер, не подключённый к открытым линиям портала. В остальных случаях это лишняя точка отказа: нужно самостоятельно следить за доставкой и обработкой ошибок.

Что ломается на практике

Вайбкод позволяет собрать рабочий MVP за часы, но несколько мест требуют особого внимания при тестировании.

Привязка записи к сделке. Это самое частое узкое место. Приложение работает в контексте авторизованного пользователя, но при вызове из плейсмента карточки нужно явно передавать ID сделки в запрос создания записи. Если контекст авторизации теряется (например, при переходе между вкладками), связь не проставляется, и запись висит без привязки к воронке.

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

Собственный канал уведомлений. Если всё же решили строить свой - придётся самостоятельно следить за доставкой, очередью и ошибками. Это неожиданно большой объём работы по сравнению с переиспользованием штатных роботов.

Бесплатный тариф платформы. На бесплатном тарифе Вайбкода сложные сценарии не отрабатывают из-за лимитов платформы. Для боевой работы нужен платный тариф с подпиской BitrixGPT + Маркетплейс на коммерческом тарифе Битрикс24.

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

О типовых ошибках при работе с Вайбкодом подробнее рассказано в статье про безопасность вайбкодинга.

С чего начать: порядок сборки

Практический порядок для сборки MVP:

1. Описать ресурсы. Зафиксировать, какие именно ресурсы бронируются: мастера, кабинеты, оборудование. Это определяет структуру пользовательских полей.
2. Создать смарт-процесс "Запись". В Битрикс24 вручную создать смарт-процесс с нужными полями - до начала вайбкодинга. Агент лучше работает, когда структура данных уже есть.
3. Поставить задачу агенту. Описать интерфейс сетки, логику слотов, проверку пересечений и поиск клиента. Подробная постановка - меньше итераций. Рекомендация из практики платформы: использовать скилл Superpowers и стартовать отдельную сессию на каждую крупную задачу.
4. Проверить валидацию. Специально создать два пересекающихся слота и убедиться, что второй блокируется.
5. Проверить привязку к сделке. Открыть приложение из плейсмента карточки сделки и убедиться, что ID сделки проставляется в запись.
6. Настроить уведомления. Добавить роботов на смарт-процессе для напоминаний, пробуждение сервера по расписанию для утренней сводки.

Если вы только начинаете знакомство с платформой, хорошей отправной точкой будет статья первое приложение на Вайбкоде за час - там разобраны основные лимиты облака и типовые сложности старта.

Если вы хотите собрать сетку записи под конкретный бизнес - напишите на sales@acp-24.ru или позвоните +7 495 414-48-49. АС Проект - платиновый партнёр Битрикс24.

Нужна помощь по вайбкод-приложению? АС Проект - платиновый партнёр Битрикс24: собираем приложения на Вайбкоде, проверяем чужие перед боевым запуском и берём на сопровождение. Состав работ и цены - на странице приложения на вайбкодинге.

Частые вопросы