Онлайн-запись Google Calendar
Технические данные
Совместимые редакции
- Программа для ЭВМ "1С-Битрикс: Управление сайтом". Лицензия Старт
- Программа для ЭВМ "1С-Битрикс: Управление сайтом". Лицензия Стандарт
- Программа для ЭВМ "1С-Битрикс: Управление сайтом". Лицензия Малый бизнес
- Программа для ЭВМ "1С-Битрикс: Управление сайтом". Лицензия Бизнес
Описание
Онлайн-запись Google Calendar (pcode.googlecalendar)Мощный и гибкий модуль для организации онлайн-записи на услуги с полной интеграцией API Google Calendar и 1С-Битрикс.
ВозможностиМодуль позволяет развернуть полноценную систему бронирования на вашем сайте за 5 минут. Клиенты выбирают услугу, специалиста и удобное время, а заявка мгновенно попадает в Google Календарь сотрудника и в CRM (Инфоблок) сайта.
Ключевые функции:- Двусторонняя синхронизация с Google: Проверка занятости слотов в реальном времени. Если слот занят в календаре, он недоступен для записи на сайте.
- 4 Режима работы:
- Простой (Simple): Запись в один календарь (для частных специалистов).
- Услуги (Services): Выбор услуги -> Запись (разная длительность услуг).
- Специалисты (Specialists): Выбор мастера -> Запись (у каждого свой календарь).
- Полный (Full): Выбор Услуги + Выбор Специалиста -> Умная фильтрация.
- Простой (Simple): Запись в один календарь (для частных специалистов).
- Интеграция с Инфоблоками: Все заявки дублируются в специальный инфоблок "Google Calendar Заявки" (создается автоматически). Это база ваших лидов внутри Битрикса.
- Гибкое расписание: Настройка рабочих дней и часов глобально или для каждой услуги отдельно.
- Современный UI:
- Адаптивный дизайн (Mobile-First).
- AJAX-подгрузка слотов (без перезагрузки страницы).
- Приятный календарь и выбор времени.
- Стилизация под любой дизайн (CSS переменные).
- Адаптивный дизайн (Mobile-First).
1. Установка модуля
Установите модуль через стандартную систему обновлений или скопируйте папку
pcode.googlecalendar в /local/modules/ и нажмите "Установить" в админке. Во время установки модуль автоматически создаст необходимые Инфоблоки и Типы инфоблоков.2. Подключение Google APIДля работы требуется файл ключей
credentials.json от Service Account Google Cloud Platform.- Перейдите в настройки модуля: Настройки -> Настройки модулей -> Google Calendar Онлайн-Запись.
- Загрузите файл credentials.json.
- Там же вы можете настроить Глобальный список услуг и специалистов.
Добавьте компонент
pcode:google.calendar на любую страницу сайта.Основные параметры компонента:
- Режим работы: Выберите один из 4-х режимов.
- Рабочее время: Укажите начало и конец рабочего дня (например, с 9 до 18).
- Длительность слота: Базовое время приема (например, 60 мин).
- ID Календаря: Если используете простой режим, укажите Email календаря здесь. В режимах "Специалисты" ID берутся из глобальных настроек.
SIMPLE (Простая запись)
Идеально для лендингов и личных страниц. Просто календарь и форма. Все заявки падают в один общий Google Календарь.
SPECIALISTS (Выбор специалиста)Для клиник, салонов красоты, барбершопов. Пользователь сначала выбирает специалиста (например, "Мастер Иван"), и видит свободное время именно этого мастера.
- Требует настройки "Специалистов" в настройках модуля.
Для сервисов с разными процедурами. "Стрижка" (30 мин) или "Окрашивание" (120 мин). Система автоматически рассчитает, сколько слотов нужно занять.
FULL (Полный цикл)Связывает услуги и специалистов. Выбираем "Массаж", и система предлагает только тех специалистов, кто делает массаж. Выбираем мастера — видим его свободное время.
Техническая информация- Код модуля: pcode.googlecalendar
- Компонент: pcode:google.calendar
- Зависимости: PHP 7.4+, модуль iblock, наличие credentials.json с правами доступа к календарям.
- Особенности: Использует Google API Client PHP Library (включена в модуль).
Внешний вид полностью настраивается через CSS. Шаблон компонента находится в
.default и использует понятные классы (.booking-widget, .time-slot, .booking-success).Модуль pcode.googlecalendar позволяет организовать профессиональную онлайн-запись на вашем сайте 1С-Битрикс, используя Google Календарь как основной источник расписания.
Как это работает:
1. Клиент заходит на сайт и видит форму записи.
2. Модуль "спрашивает" у Google Календаря: "Какие слоты свободны на выбранный день?".
3. Google проверяет ваши встречи и отдает только свободное время.
4. Клиент выбирает время, заполняет форму (Имя, Телефон).
5. В вашем календаре **моментально** создается встреча с данными клиента.
6. В Битриксе (в Инфоблоке) создается дубль заявки для отчетности.
Инструкция по установке модуля в видео формате: https://youtu.be/rB4olZChJHc
---
Шаг 1. Установка файлов модуля
Установка в Административной панели:
- Зайдите в Админку Битрикса.
- Перейдите: Marketplace (или Настройки) -> Установленные решения.
- В списке найдите модуль: Google Calendar Онлайн-Запись (pcode.googlecalendar).
- Нажмите кнопку (гамбургер) слева от названия -> Установить.
- Система сообщит об успешной установке и создании необходимых Инфоблоков.
Чтобы сайт мог управлять вашим календарем, нужно создать специального "Робота" (Service Account) в Google и дать ему права.
1. Создание Проекта:
- Зайдите на Google Cloud Console.
- В левом верхнем углу (рядом с логотипом Google Cloud) нажмите на список проектов и выберите New Project (Создать проект).
- Назовите его, например, `MyBookingSite` и нажмите Create.
- В меню слева выберите APIs & Services -> Library.
- В поиске введите: `Google Calendar API`.
- Нажмите на карточку результата и нажмите кнопку Enable (Включить)
- Перейдите в меню APIs & Services -> Credentials (Учетные данные).
- Нажмите сверху +CREATE CREDENTIALS -> Service Account.
- Service account name: введите любое имя, например `booking-bot`.
- Нажмите Create and Continue.
- В "Grant this service account access to project" выберите роль Owner** (Владелец) или Editor (для простоты, чтобы точно работало). Нажмите Continue -> Done.
- В списке "Service Accounts" (внизу страницы Credentials) нажмите на email только что созданного аккаунта (он выглядит как `booking-bot@project-id.iam.gserviceaccount.com`).
- Перейдите на вкладку KEYS (Ключи).
- Нажмите ADD KEY -> Create new key.
- Выберите тип JSON и нажмите Create.
- Перейдите в Настройки → Настройки модулей → Онлайн-запись Google Calendar:
- Путь к файлу ключей: Загрузите и укажите файл json (ключ), который вы создавали в Google Cloud Console.
- ID календаря по умолчанию: Обычно это ваш email (например, user@gmail.com). Это основной календарь, куда будут приходить записи, если у специалиста не указан свой ID. НО ЛУЧШЕ ВСЕГО УКАЗАТЬ ID КАЛЕНДАРЯ! (в настройках календаря находим пункт Интеграция календаря и далее находим поле Идентификатор календаря, копируем и вставляем)
- Глобальный список специалистов:
- Добавьте специалистов (имя).
- Для каждого можно указать ID его личного календаря (если нужно, чтобы записи падали в разные календари)((в настройках календаря находим пункт Интеграция календаря и далее находим поле Идентификатор календаря, копируем и вставляем).
- Глобальный список услуг:
- Укажите название услуги и её длительность в минутах.
- Привяжите услугу к конкретным специалистам (выберите из списка).
Шаг 4. Размещение компонента на сайте
Откройте нужную страницу сайта в режиме правки и разместите компонент
$APPLICATION->IncludeComponent(
"pcode:google.calendar",
".default",
....
Шаг 5. Проверка работы
- На странице появится виджет с выбором услуги, специалиста и даты.
- При выборе даты компонент через API Google проверяет занятость выбранного календаря и выводит только свободные слоты.
- После заполнения формы:
- Событие мгновенно создается в Google Календарь.
- Данные клиента сохраняются в инфоблок Битрикса «Google Calendar Заявки».
Установите этот модуль прямо сейчас!
Для этого укажите адрес сайта:
