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

Google Calendar

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

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

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

Что делает​

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

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

Нужно более гибкое бронирование?

Если вы ведёте записи через специализированную систему бронирования, подключите вместо этого eTermin (услуги, перенос, отмена, защита от двойной записи) или, для столов в ресторане, resmio. Эти интеграции записывают прямо в систему, которой уже пользуется ваша команда.

Подключение 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. Токены хранятся один раз в общем хранилище и доступны каждому голосовому агенту вашего аккаунта. Вы авторизуетесь один раз и затем включаете инструмент календаря на любом числе агентов.

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

Настройка инструмента для каждого агента​

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

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

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

Полное пошаговое руководство по настройке, включая аналог для Outlook, см. в Интеграции → Google Calendar.

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

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

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

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

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

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

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

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

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

Записанные приёмы в HANC​

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

Связанное​