# Google Calendar

Интеграция ChatRex с Google Calendar позволяет чат-боту учитывать расписание пользователя: получать события за период и находить свободные временные окна для записи.

# Как подключить Google Calendar

Перейдите в раздел Интеграции в панели управления ChatRex.
Откройте вкладку Источники данных.
Найдите Google Calendar и нажмите Подключить.
Перейдите во вкладку Установка соединения.
Нажмите Подключить → авторизуйтесь в Google → подтвердите доступ к календарю.

После подключения в окне интеграции отобразится статус Подключено и email аккаунта.

# Доступные действия

После подключения вы можете добавить действия Google Calendar в настройках бота.

# 1) Свободные окна

Действие возвращает доступные интервалы времени с учётом занятости в календаре.

Настройки действия:

Календари — все доступные или выбранные вручную.
Период поиска — пресет (например, 7 дней) или вручную.
Рабочее время — часовой пояс и расписание по дням недели (можно отключать дни).
Длительность слота — длительность одного окна (например, 60 мин).
Минимальный буфер — разрыв между встречами (мин).
Максимум слотов — сколько вариантов вернуть в ответе.
Игнорировать события “Свободен/Free” — не считать такие события занятостью.
Учитывать только подтвержденные — учитывать только подтвержденные события.
Формат вывода — кратко или полно.

Что получает бот: список свободных окон, сгруппированных по датам.

# 2) Получить события

Действие возвращает события календаря за период.

Настройки действия:

Календари — все доступные или выбранные вручную.
Период — пресет или вручную.
Часовой пояс — как у пользователя / как у календаря / UTC.
Формат результата — кратко или полно.

Что получает бот: список событий, сгруппированных по датам.

# Пример использования в боте

Клиент спрашивает: «Когда можно созвониться?» → бот вызывает Свободные окна и предлагает несколько вариантов.
Клиент спрашивает: «Какие встречи у меня завтра?» → бот вызывает Получить события и выводит список.

Готово — теперь бот может учитывать расписание из Google Calendar и помогать согласовывать время прямо в чате.