Онлайн-запись Google Calendar

Описание модуля

Модуль pcode.googlecalendar позволяет организовать профессиональную онлайн-запись на вашем сайте 1С-Битрикс, используя Google Календарь как основной источник расписания.

Как это работает:
1. Клиент заходит на сайт и видит форму записи.
2. Модуль "спрашивает" у Google Календаря: "Какие слоты свободны на выбранный день?".
3. Google проверяет ваши встречи и отдает только свободное время.
4. Клиент выбирает время, заполняет форму (Имя, Телефон).
5. В вашем календаре **моментально** создается встреча с данными клиента.
6. В Битриксе (в Инфоблоке) создается дубль заявки для отчетности.

Инструкция по установке модуля в видео формате: https://youtu.be/rB4olZChJHc
---

Шаг 1. Установка файлов модуля

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

• Зайдите в Админку Битрикса.
  
• Перейдите: Marketplace (или Настройки) -> Установленные решения.
  
• В списке найдите модуль: Google Calendar Онлайн-Запись (pcode.googlecalendar).
  
• Нажмите кнопку (гамбургер) слева от названия -> Установить.
  
• Система сообщит об успешной установке и создании необходимых Инфоблоков.
  

Шаг 2. Получение ключей Google API (Самый важный этап)

Чтобы сайт мог управлять вашим календарем, нужно создать специального "Робота" (Service Account) в Google и дать ему права.

1. Создание Проекта:

• Зайдите на Google Cloud Console.
  
• В левом верхнем углу (рядом с логотипом Google Cloud) нажмите на список проектов и выберите New Project (Создать проект).
  
• Назовите его, например, `MyBookingSite` и нажмите Create.
  

2. Включение API:

• В меню слева выберите APIs & Services -> Library.
  
• В поиске введите: `Google Calendar API`.
  
• Нажмите на карточку результата и нажмите кнопку Enable (Включить)
  

3. Создание Сервисного Аккаунта:

• Перейдите в меню 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.
  

4. Создание Ключа (JSON):

• В списке "Service Accounts" (внизу страницы Credentials) нажмите на email только что созданного аккаунта (он выглядит как `booking-bot@project-id.iam.gserviceaccount.com`).
  
• Перейдите на вкладку KEYS (Ключи).
  
• Нажмите ADD KEY -> Create new key.
  
• Выберите тип JSON и нажмите Create.
  

Шаг 3. Настройка параметров модуля

• Перейдите в Настройки → Настройки модулей → Онлайн-запись 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 Заявки».