Przejdź do głównej zawartości
DocumentationAPI ReferenceVideo Tutorials

Google Calendar

Połącz Google Calendar, aby Twoi agenci głosowi AI mogli sprawdzać dostępność i rezerwować rzeczywiste spotkania, gdy dzwoniący jest jeszcze na linii. Po połączeniu każdy agent na Twoim koncie może korzystać z kalendarza — bez konieczności ponownej autoryzacji na agenta.

Dostępne w każdym planie

Google Calendar jest dostępny we wszystkich planach, w tym Free. Bez dodatkowej opłaty — zapytania o dostępność i tworzenie wydarzeń wykorzystują kilka słów wyjścia LLM na turę, rozliczane według Twojej standardowej stawki minutowej.

Co robi​

  • Sprawdzanie dostępności — agent odczytuje Twój kalendarz, aby potwierdzić, czy żądany slot jest wolny.
  • Tworzenie wydarzeń — agent rezerwuje potwierdzone spotkanie jako nowe wydarzenie w kalendarzu, z imieniem i nazwiskiem dzwoniącego, telefonem oraz notatkami zarejestrowanymi podczas rozmowy.
  • Linki anulowania — każda rezerwacja zawiera samoobsługowy link do anulowania, który dzwoniący otrzymuje e-mailem lub SMS-em, więc może zmienić plany bez oddzwaniania.

Agent nie odczytuje szczegółów cudzych wydarzeń, nie edytuje niepowiązanych wydarzeń ani nie ujawnia zawartości kalendarza — wyłącznie sloty potrzebne do odpowiedzi dzwoniącemu.

Łączenie konta Google​

  1. Otwórz Integracje w pasku bocznym i kliknij Połącz Google Calendar.
  2. Zostaniesz przekierowany do standardowego ekranu zgody Google.
  3. Zaloguj się kontem Google, które jest właścicielem kalendarza, którego chcesz użyć.
  4. Sprawdź żądane uprawnienie — Przeglądanie i edycja wydarzeń w kalendarzach — i kliknij Zezwól.
  5. Zostaniesz przeniesiony z powrotem do HANC, a karta integracji pokaże Połączono wraz z użytym adresem e-mail.

Żądany zakres​

HANC żąda jednego zakresu OAuth: https://www.googleapis.com/auth/calendar.events.

Jest to zakres Sensitive (nie Restricted), co oznacza:

  • HANC może odczytywać i tworzyć wydarzenia, ale nie może odczytywać Twojej pełnej listy kalendarzy, ustawień udostępniania ani uzyskiwać dostępu do żadnej innej usługi Google (brak Gmaila, brak Drive, brak kontaktów).
  • Google nie wymaga Security Assessment dla tego zakresu i nie ma corocznej ponownej weryfikacji.

Konto, nie pojedynczy agent​

Połączenie działa na poziomie konta HANC. Tokeny są przechowywane raz we wspólnym magazynie i udostępniane każdemu agentowi głosowemu AI na Twoim koncie. Autoryzujesz raz, a następnie włączasz narzędzie kalendarza u dowolnej liczby agentów.

To różni się od ustawień na agenta, takich jak prompt, baza wiedzy czy głos — te są konfigurowane oddzielnie dla każdego agenta.

Konfiguracja narzędzia na poziomie agenta​

Połączenie Google z kontem HANC sprawia, że narzędzie staje się dostępne. Aby z niego skorzystać, dodaj narzędzie Google Calendar do zakładki Akcje agenta i skonfiguruj je.

UstawienieCo robi
KalendarzZ którego połączonego kalendarza agent czyta i do którego zapisuje
Strefa czasowaStrefa czasowa używana dla każdego slotu, który agent podaje (patrz niżej)
Godziny pracyDni i przedziały czasu, które agent zaproponuje (np. pon–pt, 09:00–18:00)
Długość slotuDomyślna długość spotkania (np. 30 minut)
BuforOdstęp między kolejnymi spotkaniami (np. 15 minut)

Każdy agent na Twoim koncie może konfigurować te ustawienia niezależnie — przydatne, gdy jeden agent rezerwuje 30-minutowe dema sprzedażowe, a inny 90-minutowe konsultacje z tego samego kalendarza.

Pełen przewodnik konfiguracji wraz z odpowiednikiem dla Outlooka znajdziesz w Integracje → Google Calendar.

Obsługa strefy czasowej​

Wszystkie propozycje slotów, potwierdzenia i utworzone wydarzenia używają strefy czasowej skonfigurowanej w narzędziu kalendarza agenta (np. Europe/Vienna, Europe/Berlin, America/New_York). Agent mówi strefę czasową na głos, gdy proponuje slot — na przykład: "Wtorek o trzeciej po południu czasu wiedeńskiego, pasuje?" — aby dzwoniący nigdy nie musiał zgadywać.

Jeśli Twój dzwoniący jest w innej strefie czasowej, skonfiguruj agenta, aby potwierdził lokalny odpowiednik werbalnie przed rezerwacją. Utworzone wydarzenie Google Calendar zawsze przechowuje czas w skonfigurowanej strefie; Google obsługuje wyświetlanie w lokalnej strefie każdego uczestnika.

Odłączanie i ponowne łączenie​

Możesz w dowolnym momencie odłączyć Google Calendar ze strony Integracje.

Po odłączeniu:

  • Przechowywane tokeny są usuwane.
  • Każde narzędzie Google Calendar na każdym agencie na Twoim koncie jest dezaktywowane — narzędzie pozostaje na agencie, ale nie uruchamia się podczas rozmów.
  • Istniejące zarezerwowane wydarzenia w samym Google nie są usuwane ani zmieniane.

Po ponownym połączeniu (lub połączeniu innego konta Google) wcześniej dezaktywowane narzędzia reaktywują się automatycznie z poprzednimi ustawieniami godzin pracy, długości slotu i strefy czasowej — nie musisz ponownie dodawać narzędzia u każdego agenta.

Możesz też cofnąć dostęp HANC ze strony ustawień bezpieczeństwa Twojego konta Google. Efekt jest taki sam jak przy odłączeniu z poziomu HANC; następna próba rozmowy używająca kalendarza nie powiedzie się czysto, a narzędzia zostaną dezaktywowane przy kolejnej synchronizacji.

Zarezerwowane spotkania w HANC​

Każde wydarzenie, które tworzy agent, pojawia się również w CRM → Kalendarz obok wszystkich rezerwacji Outlooka, z linkiem powrotnym do rekordu kontaktu dzwoniącego. Zobacz CRM → Kalendarz, aby uzyskać ujednolicony widok.

Powiązane​