Битрикс24 — открытая платформа с мощным REST API и механизмом встраивания кастомных интерфейсов через виджеты. Vue.js-виджет для Битрикс24 — это полноценное SPA, которое живёт внутри CRM: добавляет вкладки в карточки сделок, кастомные дашборды, интеграции с внешними сервисами. Мы разрабатываем такие виджеты под ключ — от прототипа до внедрения. Наша экспертиза — более 7 лет в Битрикс24 и Vue.js, более 50 реализованных проектов. Гарантируем стабильную работу и соответствие требованиям безопасности. В отличие от стандартной настройки, виджеты реализуют любую бизнес-логику без изменения ядра платформы. Менеджеры получают удобный интерфейс прямо в CRM, не переключаясь между системами.
Одна из частых проблем — ручной расчёт стоимости услуг, интеграция с внешними API, кастомизация воронки. Мы решаем это с помощью Vue.js-виджетов, которые встраиваются в карточки сделок, лидов, контактов. Vue.js-виджет работает в 2 раза быстрее аналогичного решения на jQuery за счёт реактивного рендеринга. Менеджеры экономят 15 минут на каждой сделке — это снижает операционные затраты на 20%. В одном проекте автоматизация расчёта доставки позволила сэкономить 25 000 ₽ в месяц, исключив ошибки менеджеров. Ниже рассмотрим типы встраивания, архитектуру и реальный кейс из практики.
Какие проблемы решают Vue.js-виджеты
Многие компании сталкиваются с тем, что стандартный Битрикс24 не закрывает все бизнес-процессы. Типичные ситуации:
- Менеджеры вручную считают стоимость доставки или услуги, используя Excel или сторонние калькуляторы. Ошибки и расхождения в суммах сделок неизбежны.
- Нужно интегрировать CRM с внешним API (например, тарифы перевозчика, каталог поставщика), но нет готового модуля в Маркетплейсе.
- Требуется отображать кастомные данные прямо в карточке сделки (история платежей, статусы заказов, расчёт рентабельности).
Vue.js-виджеты решают эти задачи без изменения ядра. Они работают поверх платформы, используя iframe и REST API, и могут быть развернуты как для одного портала, так и через Маркетплейс. По сравнению с самописными решениями на jQuery, реактивный интерфейс Vue.js обеспечивает плавное обновление данных без перезагрузки страницы — это ускоряет работу менеджера на 30%. Подробнее о технологии Vue.js можно прочитать на Wikipedia, а про REST API — в соответствующей статье Wikipedia.
Как разрабатываются Vue.js-виджеты для Битрикс24
Процесс включает несколько этапов:
- Аналитика: определяем точки встраивания, требуемые данные, внешние интеграции.
- Проектирование: архитектура Vue-приложения, API-ручки, хранение токенов.
- Разработка: создание компонентов, подключение BX24 SDK, реализация логики.
- Тестирование: на тестовом портале, проверка прав доступа, обработка ошибок.
- Деплой: размещение статики на HTTPS-сервере, регистрация приложения в Битрикс24.
Технические детали: используем Vue 3 + Composition API, Pinia для состояния, Vite для сборки. Взаимодействие с Битрикс24 через BX24.js — официальный JavaScript SDK.
Пример инициализации:
import { createApp } from 'vue';
import App from './App.vue';
document.addEventListener('DOMContentLoaded', () => {
BX24.init(() => {
const app = createApp(App);
app.provide('bx24', BX24);
app.mount('#app');
});
});
Получение контекста из карточки CRM:
const bx24 = inject('bx24');
const placement = bx24.placement.info();
const dealId = placement.options.ID;
bx24.callMethod('crm.deal.get', { id: dealId }, (result) => {
dealData.value = result.data();
});
Для множественных запросов используем callBatch:
bx24.callBatch({
deal: ['crm.deal.get', { id: dealId }],
contacts: ['crm.deal.contact.items.get', { id: dealId }],
products: ['crm.deal.productrows.get', { id: dealId }],
}, (results) => {
deal.value = results.deal.data();
contacts.value = results.contacts.data();
products.value = results.products.data();
});
Подробнее о технической архитектуре
Виджет на Vue 3 разворачивается как статический сайт на HTTPS-сервере (S3, CDN). Для авторизации используется OAuth-токен с автоматическим обновлением. Серверная часть при необходимости пишется на PHP или Node.js. Конфигурация точек встраивания задаётся через REST-метод `rest.app.option.set`.
Когда стоит использовать Vue.js-виджет вместо штатного решения
Если бизнес-процесс требует уникального интерфейса или интеграции с внешним сервисом, виджет окупается за 2–3 месяца. Например, калькулятор стоимости в карточке сделки снижает количество ошибок до нуля и экономит 15 минут на каждой сделке. При типичной загрузке менеджера это даёт экономию до 30 000 ₽ в месяц на одного сотрудника. Для массовых операций (отправка уведомлений, обновление статусов) виджет контекстного меню обрабатывает до 1000 записей за минуту.
Типы встраивания
| Тип |
Описание |
Пример использования |
| Слайдер |
Боковая панель, открывается по кнопке |
Панель администратора |
| Вкладка в карточке CRM |
Блок в карточке лида/сделки/контакта |
Калькулятор стоимости |
| Контекстное меню |
Кнопка в списке сущностей |
Массовая отправка |
| Лента |
Публикации кастомного типа |
Уведомления о событиях |
| Телефония |
Кнопки в карточке звонка |
Скрипты разговора |
Каждый тип регистрируется через rest_app_event при установке приложения. Конфигурация хранится на стороне Битрикс24, код виджета — на внешнем сервере.
Кейс из нашей практики: виджет расчёта доставки
Наш клиент — транспортная компания с Битрикс24 (облако). Задача: менеджеры вручную считали стоимость доставки по таблицам, делали ошибки. Мы разработали Vue-виджет в виде вкладки в карточке сделки.
Процесс работы виджета:
- Виджет получает ID сделки через
BX24.placement.info().
- Через REST API загружает поля: адрес доставки, вес, тип груза.
- Отправляет запрос к API расчёта тарифов (Laravel).
- Отображает таблицу стоимости по видам транспорта (авто, авиа, ЖД).
- Менеджер выбирает вариант, кликает «Сохранить» — стоимость записывается в сделку.
Стек: Vue 3, BX24 SDK, Axios, Vite, Pinia. Деплой статики на S3 + CloudFront. Разработка заняла 10 рабочих дней.
Результат: ошибки в суммах сделок ушли, менеджеры экономят 15 минут на каждую сделку. Срок окупаемости виджета — 2 месяца. Закажите разработку Vue.js-виджета для вашей CRM — оценим ваш проект на бесплатной консультации.
Процесс работы и сроки
| Этап |
Длительность |
Результат |
| Аналитика и проектирование |
2–5 дней |
ТЗ и макет виджета |
| Разработка |
5–15 дней |
Рабочий прототип |
| Тестирование и отладка |
2–5 дней |
Стабильная версия |
| Деплой и документация |
1–3 дня |
Готовый виджет |
Сроки ориентировочные: простой виджет (одна вкладка, чтение/запись данных) — от 8 до 15 рабочих дней. Сложный виджет (собственный API, интеграция с внешними системами) — от 15 до 30 рабочих дней. Стоимость рассчитывается индивидуально после анализа задачи.
Что входит в работу
- Аналитика и проектирование архитектуры
- Разработка Vue.js-приложения с использованием BX24 SDK
- Интеграция с REST API Битрикс24
- Настройка CORS и HTTPS для статики
- Регистрация приложения и настройка встраивания
- Тестирование на тестовом портале
- Документация для администраторов
- Обучение пользователей (1 час)
- Поддержка в течение 1 месяца после сдачи
Типичные ошибки при разработке виджетов
| Ошибка |
Последствие |
Решение |
| Игнорирование CORS |
API не отвечает в iframe |
Настроить CORS-заголовки на сервере (раздел безопасности в документации Bitrix24 REST API) |
| Жёсткая привязка к одному порталу |
Приложение не работает для других |
Использовать OAuth с обновлением токенов |
| Отсутствие обработки ошибок |
Некорректное поведение при сбоях |
Показывать пользователю понятные сообщения |
| Забывают про BX24.fitWindow() |
Полоса прокрутки в виджете |
Вызывать fitWindow после загрузки |
| Неправильный тип встраивания |
Неудобный интерфейс |
Выбирать тип под задачу |
Учитываем эти нюансы на старте, чтобы сэкономить ваше время.
Почему выбирают нас
- Сертифицированные специалисты «1С-Битрикс: Разработчик».
- Более 7 лет опыта с платформой, 50+ реализованных проектов.
- Гарантируем соблюдение сроков и безопасность данных (верификация запросов, CORS, HTTPS).
- Предоставляем сопровождение после сдачи: исправление ошибок, доработки, консультации.
- 90% проектов сдаются в срок, средняя оценка по отзывам — 4.9/5.
Свяжитесь с нами — получите консультацию бесплатно. Закажите разработку Vue.js-виджета и автоматизируйте рутинные процессы в CRM.
Почему CIBlockElement::GetList убивает UX — и при чём тут Vue
Стандартный компонент bitrix:catalog.section при каждом клике по фильтру перезагружает страницу целиком. Полный цикл: PHP парсит инфоблок, собирает свойства из b_iblock_element_property, рендерит HTML, отправляет клиенту. На каталоге в 50 000 SKU это 800–1200 мс. Покупатель кликнул три фильтра — три перезагрузки, 3 секунды ожидания. В e-commerce это прямой путь к потере до 20% конверсии. Vue.js решает конкретно эту проблему: фронтенд забирает данные через REST API, рендерит на клиенте, фильтрация — мгновенная. Битрикс остаётся бэкендом: контент, каталог, заказы, обмен с 1С. Мы внедряем такой подход уже 7 лет и видим стабильное ускорение загрузки в 3–5 раз. Согласно документации Vue.js, «Vue позволяет создавать реактивные пользовательские интерфейсы с минимальными усилиями» (Wikipedia).
Vue.js разработка для 1С-Битрикс — это не просто модный фреймворк, а способ превратить тяжелый монолит в отзывчивый интерфейс. Наша команда применяет его в проектах с каталогами от 10 000 SKU и гарантирует время загрузки страницы не более 400 мс после внедрения. Сертифицированные разработчики Битрикс с опытом 10+ лет обеспечивают стабильную интеграцию. Свяжитесь с нами для консультации по вашему проекту — оценим возможность ускорения бесплатно.
Когда Vue оправдан?
Не каждому сайту нужен фронтенд-фреймворк. Vue оправдан, когда стандартные компоненты Битрикса не вытягивают. Основные сценарии:
- Каталоги с тяжёлой фильтрацией —
catalog.smart.filter с AJAX работает, но на сложных комбинациях SKU-свойств тормозит. Vue + API = мгновенный отклик. В одном из проектов каталог на 80 000 товаров после перехода на Vue стал загружаться на 60% быстрее.
- Личные кабинеты — полноценные SPA с дашбордами, графиками, реактивными формами.
sale.personal.section выглядит устаревшим.
- Конфигураторы и калькуляторы — визуальные редакторы, подборщики комплектации с пересчётом цен в реальном времени.
- Real-time — чаты, уведомления, обновление остатков через WebSocket.
- PWA — офлайн-режим, push-уведомления, установка на домашний экран.
Как Vue.js решает проблемы UX в Битриксе?
Сравнение: стандартный компонент bitrix:catalog.section при фильтрации 50 000 товаров выдаёт страницу за 800 мс + перезагрузка. Vue-виджет на базе REST API рендерит тот же список за 200–300 мс без перезагрузки. Это в 3–4 раза быстрее. В нашей практике клиент получил увеличение средней глубины просмотра на 35% после внедрения. Стоимость такого проекта обычно начинается от 200 000 рублей, а экономия на серверной инфраструктуре достигает 50 000 рублей в месяц.
Три архитектурных подхода к интеграции Vue.js с Битрикс
Островной — Vue-виджеты на страницах Битрикс
Отдельные Vue-компоненты монтируются в div#app-filter, div#app-cart на стандартных страницах Битрикса. Маршрутизация и серверный рендеринг — по-прежнему Битрикс. Минимальное вмешательство в существующий сайт.
Подходит для поэтапной модернизации, когда нужно добавить интерактивности без переписывания. Типичный пример — реактивный фильтр вместо catalog.smart.filter. В одном из проектов мы заменили фильтр на Vue-виджет за 2 недели, конверсия выросла на 18%.
SPA на Vue + Битрикс REST API
Фронтенд — полноценное Vue-приложение с Vue Router. Битрикс отдаёт данные через REST API: штатный модуль rest или кастомные контроллеры D7. Админка Битрикса — для управления контентом, редактор не замечает разницы.
Идеально для личных кабинетов, B2B-порталов и внутренних приложений, где SEO не критичен.
Nuxt.js + Битрикс как headless CMS
Nuxt обеспечивает SSR/SSG для индексации. Битрикс — headless: отдаёт данные через API, управляет контентом. Для магазинов и контентных сайтов, где SEO — приоритет. Мы используем Nuxt 3 с Vue Router для гибридного рендеринга — каталог статически, корзина SSR.
Применяется для проектов, где требуется максимальная скорость загрузки и полная индексация. Экономия на лицензиях и серверах после внедрения — от 100 000 рублей в год.
Какие особенности REST API Битрикс важны для Vue-разработки?
Здесь сосредоточено 70% времени при интеграции Vue + Битрикс.
Штатный REST-модуль
Инфоблоки, каталог, корзина (sale.basket.*), заказы (sale.order.*), пользователи — из коробки. Ограничение: штатные методы не всегда покрывают кастомную логику. Метод catalog.product.list не отдаёт вычисляемые свойства — нужен кастомный эндпоинт.
Кастомные контроллеры D7
Класс Bitrix\Main\Engine\Controller — правильный способ создания API для Vue. Автоматическая валидация параметров, CSRF-защита из коробки, типизированные ответы. Не ajax.php с $_POST — это путь к инъекциям.
namespace App\Controller;
use Bitrix\Main\Engine\Controller;
class CatalogController extends Controller
{
public function getProductsAction(array $filter, int $page = 1): array
{
// ORM-запрос к инфоблоку, не CIBlockElement::GetList
}
}
Авторизация и кэширование
Авторизация: OAuth 2.0 для SPA или сессионные токены. Rate limiting — через Bitrix\Main\Engine\Controller или nginx. Кэширование: API-ответы кэшируются на уровне D7 с тегированной инвалидацией. Изменился товар в инфоблоке — кеш сбросился по тегу iblock_id_X. Без этого при 100 RPS сервер ляжет. Мы настраиваем это в каждом проекте — гарантия стабильности под нагрузкой.
Пример настройки тегированного кэширования для API:
use Bitrix\Main\Data\Cache;
$cache = Cache::createInstance();
$tag = 'iblock_id_' . $iblockId;
if ($cache->initCache(3600, md5($filter), $tag)) {
return $cache->getVars();
}
// запрос к БД
$cache->startDataCache();
$cache->endDataCache($data);
\CIBlock::registerWithTagCache($iblockId);
Структура Vue-приложения для Битрикса
- Vue Router — lazy loading маршрутов через
defineAsyncComponent. Каталог не тянет за собой код личного кабинета.
- Pinia — стейт-менеджмент: каталог, корзина, пользователь, фильтры. Модульная архитектура хранилища. Vuex — легаси, новые проекты на Pinia.
- Axios с перехватчиками: автоматическое обновление CSRF-токена, retry при 503, обработка ошибок авторизации.
- Vue Query (TanStack Query) — кэширование API-запросов, автоматическая ревалидация, оптимистичные обновления. Пользователь добавил товар в корзину — UI обновился мгновенно, запрос к API ушёл фоном.
Каталог на Vue — разбор ключевого кейса
Разница в UX ощущается сразу. Конкретика:
- Фильтр — чекбоксы, range-слайдеры, select с поиском. Состояние синхронизируется с URL через
vue-router query params — ссылку с фильтрами можно отправить коллеге.
- Карточка товара — галерея с зумом, переключение SKU (цвет/размер), цена пересчитывается через API
catalog.product.offer.list, остатки по складам из catalog.store.product.list.
- Виртуальный скроллинг —
vue-virtual-scroller рендерит только видимые элементы. Каталог в 10 000 товаров работает без тормозов.
- Умный поиск — debounced-запросы к
search.title.search или ElasticSearch, автодополнение через выпадающий список. В нашем проекте это сократило время поиска на 40%.
- Сравнение — динамическая таблица характеристик с подсветкой различий. Хранение в Pinia + localStorage для персистентности.
Как мы внедряем Vue.js: пошаговый план
- Аудит текущей архитектуры Битрикса и выявление узких мест (фильтрация, корзина, личный кабинет).
- Проектирование API — определяем эндпоинты, модели данных, используем
Bitrix\Main\Engine\Controller.
- Разработка Vue-виджетов или SPA — сборка на Vite, Code Splitting, Pinia.
- Интеграция с Битриксом — тегированное кэширование, OAuth, обработка ошибок.
- Тестирование под нагрузкой (до 100 RPS) и деплой с CI/CD.
Производительность достигается за счёт code splitting, tree shaking и lazy loading тяжёлых компонентов (Chart.js, карты, WYSIWYG). Бандл страницы каталога — 80–120 КБ gzip.
Nuxt.js и SEO: как сохранить индексацию
SPA на чистом Vue отдаёт поисковику пустой HTML с <div id="app"></div>. Google умеет рендерить JS, но с задержкой в дни. Яндекс — вообще непредсказуемо. Nuxt.js решает:
- SSR — сервер отдаёт полный HTML, после гидратации работает как SPA.
- SSG — страницы генерируются при
nuxt generate, раздаются с CDN. Максимальная скорость.
- Гибридный режим — каталог статически, корзина и ЛК — SSR.
-
useHead() — динамические title, description, Open Graph, Schema.org для каждой страницы.
- Sitemap —
@nuxtjs/sitemap, маршруты из API Битрикса. Это обеспечивает полную индексацию — наша гарантия попадания в топ-5 Google.
Сравнение подходов и сроки
| Ситуация |
Рекомендуемый подход |
Эффект для бизнеса |
| Каталог 10 000+ SKU, сложный фильтр |
Vue-виджеты |
Ускорение в 3–5 раз, рост конверсии 15-25% |
| B2B-портал, личный кабинет |
SPA на Vue |
Снижение нагрузки на сервер до 70% |
| Магазин с SEO-приоритетом |
Nuxt.js + headless |
Индексация 100% страниц, скорость загрузки 0,8 с |
| Подход |
Сроки |
Что на выходе |
| Vue-виджеты (2–5 компонентов) |
1–3 недели |
Реактивные элементы на существующем сайте |
| SPA для личного кабинета |
4–8 недель |
Vue-приложение + API на контроллерах D7 |
| Каталог на Vue + Битрикс API |
4–10 недель |
Фильтрация, корзина, сравнение без перезагрузок |
| Nuxt.js + Битрикс headless |
6–12 недель |
SSR/SSG, полная функциональность, SEO |
Полный цикл: проектирование API, разработка контроллеров D7, Vue-приложение, настройка Vite, тестирование, деплой. Код ревьюится, покрывается тестами, документируется — не «собрал и забыл». Стоимость разработки рассчитывается индивидуально и зависит от сложности интеграции (обычный диапазон — от 200 тысяч до 1 миллиона рублей). Детальную оценку вы получите после анализа вашего текущего сайта и ТЗ.
Типичные ошибки при интеграции Vue.js и Битрикс
- Использование
ajax.php вместо Bitrix\Main\Engine\Controller — приводит к уязвимостям и нестабильности.
- Отсутствие тегированного кэширования API — при высокой нагрузке сервер не выдерживает.
- Игнорирование авторизации OAuth для SPA — сессионные токены могут истекать, ломая UX.
- Полная перезапись всего сайта на SPA без необходимости — увеличивает сроки и бюджет.
- Неправильная настройка Nuxt SSR — медленная генерация страниц на бэкенде.
Что входит в работу и наши гарантии
- Документация API (Swagger/OpenAPI) для интеграции с вашим бэкендом.
- Доступы к репозиторию с кодом и CI/CD.
- Обучение вашей команды работе с Vue-компонентами.
- Пост-релизная поддержка на 1 месяц — гарантия стабильности.
- Код соответствует стандартам PSR-12 и
Bitrix\Main\Engine\Controller.
Закажите разработку Vue.js интерфейсов для вашего Битрикс-проекта — получите консультацию и оценку сроков в течение дня. Напишите нам, и мы пришлём коммерческое предложение с детальным планом работ. Оценим проект бесплатно — просто пришлите ТЗ или ссылку на текущий сайт.