Перейти к основному содержимому
DocumentationAPI ReferenceVideo Tutorials

Google Calendar

Подключите Google Calendar, чтобы голосовые агенты могли проверять доступность и записывать на реальные приёмы, пока звонящий ещё на линии. После подключения каждый агент аккаунта может пользоваться календарём — повторно авторизовывать на каждого не нужно.

Доступно на любом тарифе

Google Calendar доступен на всех тарифах, включая Free. Никаких доплат — поиск по календарю и создание событий тратят несколько слов вывода LLM на ход, оплата по обычной поминутной ставке.

Что делает​

  • Проверка доступности — агент читает ваш календарь, чтобы подтвердить, свободен ли запрошенный слот.
  • Создание событий — агент создаёт подтверждённую запись новым событием в календаре, с именем звонящего, телефоном и заметками, собранными в звонке.
  • Ссылки отмены — каждая запись включает self-service ссылку отмены, которую звонящий получает по email или SMS — менять планы можно без повторного звонка.

Агент не читает детали чужих событий, не редактирует не относящиеся события и не раскрывает содержимое календаря — только нужные слоты.

Подключение Google-аккаунта​

  1. Откройте Integrations в боковой панели и нажмите Connect Google Calendar.
  2. Вас перенаправит на стандартный экран согласия Google.
  3. Войдите в Google-аккаунт, владеющий нужным календарём.
  4. Прочтите запрашиваемое право — View and edit events on your calendars — и нажмите Allow.
  5. Вас вернёт в HANC, и карточка интеграции покажет Connected с использованным email.

Запрашиваемый scope​

HANC запрашивает один OAuth-scope: https://www.googleapis.com/auth/calendar.events.

Это Sensitive-scope (не Restricted), что значит:

  • HANC может читать и создавать события, но не может читать список всех ваших календарей, настройки шеринга или другие Google-сервисы (никакого Gmail, Drive, контактов).
  • Google не требует Security Assessment для этого scope, нет ежегодной повторной верификации.

Уровень аккаунта, не агента​

Подключение живёт на уровне аккаунта HANC. Токены хранятся в одном месте и доступны каждому голосовому агенту вашего аккаунта. Авторизуете один раз — и включаете календарный tool на стольких агентах, на сколько нужно.

Это отличается от настроек уровня агента (промпт, база знаний, голос), которые конфигурируются по отдельности.

Конфигурация tool на агенте​

Подключение Google к аккаунту HANC делает tool доступным. Чтобы реально использовать, добавьте tool Google Calendar на вкладку Actions агента и настройте.

НастройкаЧто делает
CalendarС какого подключённого календаря агент читает и куда пишет
TimezoneЧасовой пояс для каждого слота, который агент озвучивает (см. ниже)
Work hoursДни и временные диапазоны, которые агент предлагает (например, пн–пт, 09:00–18:00)
Slot durationДлительность слота по умолчанию (например, 30 минут)
BufferБуфер между последовательными записями (например, 15 минут)

Каждый агент аккаунта может настроить это независимо — удобно, когда один агент бронирует 30-минутные демо продаж, а другой — 90-минутные консультации из того же календаря.

Полный гайд по настройке, включая аналог Outlook, см. в Integrations → Google Calendar.

Работа с часовым поясом​

Все предложения слотов, подтверждения и созданные события используют часовой пояс, заданный на календарном tool агента (например, Europe/Vienna, Europe/Berlin, America/New_York). Агент озвучивает часовой пояс при предложении слота — например, «Вторник в три по венскому времени, подойдёт?» — звонящему не приходится гадать.

Если звонящий в другом часовом поясе, настройте агента подтверждать локальный эквивалент устно перед бронированием. Созданное событие Google Calendar всегда хранит время в заданном часовом поясе; Google сам показывает в локальном часовом поясе каждого участника.

Отключение и повторное подключение​

Отключить Google Calendar можно в любой момент со страницы Integrations.

При отключении:

  • Сохранённые токены удаляются.
  • Каждый Google Calendar tool на каждом агенте вашего аккаунта деактивируется — tool остаётся на месте, но больше не срабатывает в звонках.
  • Существующие забронированные события в Google не удаляются и не меняются.

При повторном подключении (или подключении другого Google-аккаунта) ранее деактивированные tools активируются автоматически со старыми настройками рабочих часов, длительности слота и часового пояса — заново добавлять tool на каждого агента не нужно.

Доступ HANC можно отозвать и из настроек безопасности Google-аккаунта. Эффект тот же, что и отключение изнутри HANC; следующий звонок, пытающийся использовать календарь, упадёт чисто, и tools деактивируются при следующей синхронизации.

Забронированные записи в HANC​

Каждое событие, созданное агентом, также показывается в CRM → Calendar рядом с бронированиями Outlook, со ссылкой обратно на запись контакта звонящего. См. CRM → Calendar для унифицированного вида.

Связанное​