Встречи и Google Календарь
Как поручить ИИ запись на консультации: подключить Google Календарь, задать доступное время и разрешить запись, перенос или отмену.
На этой странице
AI-агент может предложить свободное время и записать клиента в Google Календарь. Например, подобрать получасовую консультацию в рабочие дни. В зависимости от разрешений агент также может перенести или отменить запись.
В разделе AI → Календарь подключите аккаунт, создайте тип встречи и проверьте доступное время. Затем разрешите нужные календарные действия в настройках агента. Свободный интервал записи в интерфейсе называется слотом.
Сейчас поддерживается Google Календарь. Типы встреч, записи и инструменты агента используют общий интерфейс платформы; других календарных провайдеров подключить пока нельзя.
Подключение аккаунта
Нажмите Подключить Google Календарь и подтвердите доступ в окне Google. Запрашивается доступ к списку календарей, событиям и сведениям о занятости. Если подключение не завершено за пять минут, начните заново.
Технически подключение защищено одноразовым параметром state, привязанным к боту и аккаунту, проверкой PKCE и фиксированным адресом возврата. Срок действия state составляет пять минут.
Токен для продления доступа хранится зашифрованным и больше не показывается. На карточке подключения видны только метка аккаунта и одно из четырёх состояний: Подключён, Доступ истёк, Отключён, Ошибка. Если доступ истёк, подключите аккаунт заново.
Кнопка Отключить календарь заблокирована, пока у активного агента включены календарные инструменты: интерфейс перечислит таких агентов. Сначала уберите инструменты или поставьте агента на паузу.
Типы встреч
Тип встречи определяет, что агент предлагает пользователю. В нём задаются:
- Название: видно вам в отчётах и клиенту в событии.
- Календарь из подключённого аккаунта. Сохранённый идентификатор календаря шифруется и больше не отображается, поэтому при редактировании типа встречи календарь выбирается заново.
- Длительность: от 5 до 480 минут.
- Часовой пояс: имя из базы IANA, например
Europe/Berlin. Он задаёт, что означает доступное время ниже. - Доступное время: от 1 до 28 недельных интервалов с границами вида
ЧЧ:ММпо дням недели. Интервалы не должны пересекаться; интервал, у которого конец раньше начала, переходит через полночь. - Минимальный запас перед встречей: от 0 до 1 440 минут, раньше этого срока записаться нельзя.
- Насколько вперёд можно записаться: от 1 до 366 дней.
- Перерыв до и перерыв после: по 0-1 440 минут, остаются свободными вокруг встречи.
- Тип встречи включён: предлагать и бронировать можно только включённые типы.
Кнопка Показать свободные слоты показывает настоящий результат на ближайшую неделю по подключённому календарю, а не имитацию.
Как выбирается слот
Доступность считается сразу по четырём входам: недельные часы типа встречи, занятые интервалы из календаря, перерывы и уже существующие записи этого подключения. Кандидаты берутся с шагом 15 минут; по умолчанию возвращается 10 слотов и никогда больше 20.
Время показывается в часовом поясе клиента и хранится в UTC, поэтому переход на летнее время сдвигает предлагаемое местное время, а не сохранённый момент.
Запись сделана намеренно осторожно:
- Выбранный слот проверяется ещё раз: прямо перед любой записью.
- Сохраняется ожидающая бронь с ключом идемпотентности, поэтому повторный запрос не создаст вторую встречу.
- В календаре создаётся событие, при необходимости со ссылкой на видеовстречу.
- Если Google Календарь не ответил вовремя или вернул временную ошибку, бронь сначала ищется по ключу идемпотентности, поэтому неоднозначный таймаут не порождает дубль.
- Только после этого бронь подтверждается. Идентификатор события у провайдера и ссылка на встречу хранятся зашифрованными.
Перенос и отмена работают по той же схеме. Если выбранное время успел занять кто-то другой, действие завершится ошибкой вместо двойной записи.
Состояния брони: Ожидает, Подтверждена, Перенесена, Отменена, Ошибка.
Как выдать инструменты агенту
В редакторе агента, в блоке Разрешённые инструменты, включите нужные календарные действия:
- Показывать свободные слоты
- Записывать на встречу
- Переносить встречу
- Отменять встречу
Для каждого включённого календарного инструмента нужно указать хотя бы один актуальный включённый тип встречи: иначе проверка готовности не даст активировать агента. Активный агент может пользоваться только календарными инструментами: другие в работе пока не запускаются.
Модель не выбирает ни календарь, ни клиента, ни произвольный запрос. Она может лишь предложить вызов, аргументы которого проходят закрытую схему, а бот, подписчик и разрешённые типы встреч подставляются из серверного контекста. У вызова инструмента есть дедлайн 15 секунд, ключ идемпотентности из хода и номера вызова, а в журнале аргументы и результат сохраняются с вырезанными ссылками на встречу и контактами.
Отчётность
AI → Аналитика показывает календарные действия и итоги записей рядом с остальными метриками агента, а AI → Календарь: сами брони.
Что делать, если
- Включены календарные инструменты, но нет включённого типа встречи - создайте тип или включите существующий до активации агента.
- Не удалось загрузить список календарей: возможно, аккаунт нужно подключить заново; как временный обходной путь идентификатор подключения можно ввести вручную.
- Нет свободных слотов на ближайшей неделе: проверьте недельные часы, минимальный запас, перерывы и загруженность календаря.
- Тип встречи используется и не может быть удалён: на него ссылаются календарные инструменты активного агента.
Связанные материалы
- ИИ-ответы и AI-агент: настройка агента и инструментов.
- Источники знаний: из чего агент отвечает.
- Интеграции: другие подключённые сервисы.