Документация › Интеграции › Google Calendar

Google Calendar

Бот сам записывает клиентов на приём: проверяет свободные слоты и ставит событие в твой Google-календарь. Подключается так же, как Таблицы — шарингом календаря с сервис-аккаунтом.

⏱ 7 мин · 👤 для владельца · 🟢 live

За 30 секунд:

• Подключение = поделиться Google-календарём с email сервис-аккаунта (права на изменение событий).
• Бот умеет: проверить свободное время, создать/изменить/удалить событие, показать список.
• Время — по умолчанию Asia/Almaty (астанинское), с учётом перехода на летнее/зимнее.
• calendar_id по умолчанию primary (основной календарь).

Что бот умеет с календарём

Главный сценарий — запись на приём: клиент пишет «хочу завтра в 15:00», бот проверяет, свободно ли, и создаёт событие. Удобно для салонов, клиник, мастеров, репетиторов.

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

1. Поделись календарём. Google Календарь → настройки нужного календаря → «Доступ для отдельных пользователей» → добавь email сервис-аккаунта с правом «Внесение изменений в мероприятия».
2. Укажи `calendar_id` в функции. Для основного календаря — это primary; для отдельного календаря его ID есть в настройках календаря (вид ...@group.calendar.google.com).
3. Настрой расписание работы прямо в функции «Проверить свободное время»: рабочие дни, часы, обед, длительность слота, минимальный запас до записи. Бот предлагает клиентам только время внутри этих рамок. (До 2026-06-13 этот редактор не влиял на бота — теперь сервер читает расписание из настроек функции.)
4. Проверь в тест-чате: «запиши меня на завтра в 15:00».

См. также пошаговый гайд: Запись на время.

💡 Часовой пояс. По умолчанию бот считает время в Asia/Almaty — то есть «15:00» для клиента это 15:00 по Астане. Пояс можно переопределить в параметрах функции, переход на летнее/зимнее время учитывается автоматически.

⚠️ Не поделился календарём → бот не сможет создать событие. Как и с таблицами: сначала дай сервис-аккаунту доступ, потом указывай ID.

💬 Простыми словами

Если у тебя запись по времени — салон, врач, автошкола, репетитор, — календарь незаменим. Клиент пишет «можно завтра в три?», и бот сам смотрит в твой Google-календарь: свободно — записывает, занято — предлагает другое время. Тебе не надо ничего делать руками.

Подключается один в один как таблицы: открываешь свой календарь, даёшь доступ email-у бота (на изменение событий) и указываешь, какой именно календарь использовать. Время бот считает по Астане, так что «три часа» — это три по-нашему, без путаницы с часовыми поясами.

Дальше: → Gmail
Связано: Обзор интеграций · Google Sheets · Функции
Не получилось? → Функция не вызывается / падает