Интеграция связывает раздел «Календарь» в кабинете с основным календарём вашего Google-аккаунта. AI-ассистент видит занятость, предлагает клиенту свободное время и создаёт событие, при необходимости со ссылкой на Google Meet. Оператор работает с теми же событиями в кабинете.
Тем же способом, только по протоколу CalDAV, подключается Яндекс Календарь.
#Что синхронизируется
| Действие | Google Calendar | Что видно в кабинете |
|---|---|---|
| Чтение событий | Список событий основного календаря (primary) за период | Импорт в раздел «Календарь» по кнопке «Синхронизировать» |
| Создание события | Событие в основном календаре, по желанию с конференцией Google Meet | Событие с пометкой провайдера google |
| Изменение события | Перенос, новое название и описание | Обновлённое событие |
| Удаление события | Событие удаляется из Google Calendar | Событие удаляется из кабинета |
#Что нужно на стороне Google
- Google-аккаунт, в основном календаре которого будут создаваться события.
- Согласие на доступ к календарю в окне авторизации Google.
- Для ссылок Google Meet: аккаунт, в котором доступен Meet (личный Google или Google Workspace).
#Как подключить
- Откройте раздел Интеграции, выберите Google Calendar и нажмите «Подключить»: откроется окно авторизации Google.
- Войдите в нужный Google-аккаунт и разрешите доступ к календарю: окно закроется, карточка получит отметку «Интеграция подключена».
- Откройте раздел «Календарь» в кабинете: в шапке появится переключатель календарей с подключённым Google-аккаунтом.
- Нажмите «Синхронизировать»: события из Google Calendar появятся на таймлайне.
События создаются в основном календаре аккаунта (primary). Чтобы клиентские записи не смешивались с личными, подключайте отдельный Google-аккаунт.
#Проверить, что работает
- Создайте событие в кабинете через «+ Новое событие», выбрав подключённый Google-календарь: событие появится в Google Calendar через несколько секунд.
- Создайте событие в Google Calendar и нажмите «Синхронизировать» в кабинете: событие появится на таймлайне.
- Напишите боту с тестового номера «хочу на консультацию завтра»: ассистент предложит свободные слоты, а после выбора создаст событие.
#Что происходит после подключения
| Событие | Действие платформы |
|---|---|
| Клиент просит записаться | AI-ассистент в режиме Запись в календарь читает занятость и создаёт событие в Google Calendar |
| Оператор создал событие в кабинете с этим календарём | Событие создаётся в Google Calendar, в кабинете сохраняется внешний ID |
| Оператор изменил или удалил событие | Изменение уходит в Google Calendar |
| Нажата кнопка «Синхронизировать» | События из Google Calendar импортируются в кабинет |
| Событие создано | Срабатывает исходящий вебхук calendar.event_created с полем provider: google |
#Пример диалога с AI-ассистентом
| Кто | Сообщение |
|---|---|
| Клиент | Хочу записаться на консультацию |
| AI | Свободные слоты на этой неделе: среда 14:00–15:00, четверг 10:00–11:00, пятница 16:00–17:00. Какое время удобно? |
| Клиент | Четверг в 10 |
| AI | Записал вас на четверг, 10:00. Ссылка на Google Meet: … |
#Яндекс Календарь
Яндекс Календарь подключается по CalDAV (caldav.yandex.ru) с логином Яндекса и OAuth-токеном или паролем приложения. События создаются в календаре по умолчанию (events-default). В разделе «Календарь» кабинета Яндекс и Google переключаются в одном списке.
#Ограничения
- Используется только основной календарь аккаунта (
primary); выбрать другой календарь нельзя. - Токен Google OAuth 2.0 обновляется автоматически; при отзыве доступа в Google интеграцию нужно подключить заново.
- События создаются от имени подключённого Google-аккаунта: приглашения и Meet-ссылки клиент видит как отправленные им.
- Импорт из Google запускается кнопкой «Синхронизировать», а не по расписанию.
#Частые проблемы
| Проблема | Что делать |
|---|---|
| AI не видит расписание | Проверьте, что интеграция активна и в настройках ассистента выбран этот календарь |
| Ошибка авторизации | Подключите интеграцию заново: токен мог быть отозван в настройках Google-аккаунта |
| Google Meet не создаётся | Убедитесь, что в аккаунте доступен Meet и при создании события включена опция ссылки на встречу |
| Событие не в том календаре | События всегда идут в основной календарь подключённого аккаунта; подключите другой аккаунт |
| События из Google не появились | Нажмите «Синхронизировать» и проверьте период отображения на таймлайне |