Sprievodcovia

Pripojenia

Váš AI asistent (Claude, ChatGPT) aj hlasový agent v hovore vedia prečítať Google Kalendár aj Apple Calendar a po vašom schválení upraviť existujúcu udalosť - a hlasový agent na vlastnom motore volai navyše priamo v hovore zistí voľný termín a schôdzku rovno zapíše. Pri Apple je potrebné zachovať nepriehľadné ID a dať pozor na opakované série.

Čo to vie a nevie

• Vypíše pripojené kalendáre a ich udalosti.
• Upraví názov, začiatok alebo koniec existujúcej udalosti.
• Hlasový agent na vlastnom motore volai zistí v hovore voľný termín a rovno zapíše schôdzku.
• Nájde voľné termíny a založí schôdzku aj mimo hovoru cez REST a MCP.

Nevie

• Nevymaže žiadnu udalosť.
• Nehľadá voľné termíny medzi viacerými účastníkmi.

Pripojenie Google účtu

Google účet pripojíte v portáli v sekcii Pripojenia (položka Prepojenia a API v menu portálu). Hneď ako je účet pripojený, ten istý API kľúč cez REST aj MCP vidí to isté - žiadne druhé prihlásenie navyše.

Odpojiť účet môžete v portáli alebo cez REST DELETE /v1/integrations/{id}. REST odpojí integráciu okamžite a bez ďalšieho potvrdzovacieho poľa, preto ho volajte až po výslovnom schválení používateľom. MCP nástroj na odpojenie nemá.

Apple Calendar

Pripája sa heslom pre konkrétnu aplikáciu (nie bežným heslom k Apple účtu) v portáli v sekcii Dáta a integrácie. Pripojenie vie aj REST POST /v1/integrations s {provider: "apple-calendar", username, appPassword, calendarUrl?}; MCP prihlasovacie údaje neprijíma a účet používa až po pripojení.

list_calendar_events aj REST GET /v1/integrations/{id}/events podporujú Apple Calendar. Vrátený nepriehľadný externalId odovzdávajte bez zmeny ako eventId do get_calendar_event a úprav; nie je to iCalendar UID. Riadok s recurring: true predstavuje celú opakovanú sériu a jej úprava zmení základ série, nie jeden výskyt; jednotlivé výnimky zostanú zachované.

calendarId musí byť jedna z adries, ktoré vráti list_calendars - čokoľvek iné API odmietne chybou 400 calendar_invalid_calendar.

Termíny v hovore

Hlasový agent na vlastnom motore volai vie priamo v telefonáte zistiť voľný termín a schôdzku rovno zapísať - nejde o AI asistenta v chate, ale o hovor, ktorý vedie sám hlasový agent. Zapína sa v editore agenta na karte Kalendár: vyberiete pripojenie, kalendár a pravidlá dostupnosti (okná podľa dňa v týždni, dĺžka schôdzky, rezerva medzi termínmi, minimálny predstih, horizont hľadania).

• Funguje len pri agentovi na vlastnom hlasovom motore volai - pri agentovi na ElevenLabs sa nastavenie uloží a čaká na automatické prepnutie motora.
• Agent nikdy nepovie, čo je v kalendári zapísané - len či je daný čas voľný.
• Telefón volajúceho sa do udalosti zapíše, len keď ho agent pozná; skryté číslo znamená udalosť bez telefónu.
• Rovnaké hľadanie voľných termínov aj zápis schôdzky ide aj mimo hovoru cez REST (POST .../availability, POST .../events) a MCP (find_free_slots, create_calendar_event).

Fakturoid a ABRA Flexi

Táto stránka pokrýva len kalendáre. Fakturoid a ABRA Flexi sa pripájajú na tom istom mieste (list_integrations/GET /v1/integrations, sekcia Dáta a integrácie v portáli), ale čítanie faktúr a ich použitie v upomienkových Úlohách má vlastného sprievodcu Faktúry.

Postup pre agenta

Úprava udalosti má vždy šesť krokov v tomto poradí:

• 1. list_integrations - pripojené kalendáre a ich integrationId.
• 2. list_calendars - kalendáre daného pripojenia a ich calendarId.
• 3. list_calendar_events, potom get_calendar_event s vráteným externalId ako eventId - načíta udalosť a jej aktuálnu sourceRevision.
• 4. propose_calendar_update - pripraví návrh zmeny, zatiaľ nič nezapisuje.
• 5. Schválenie používateľom - agent ukáže pôvodné hodnoty a návrh, až potom pokračuje.
• 6. confirm_calendar_update s confirm: true - až tento krok zapíše zmenu do Google/Apple.

REST ekvivalenty: GET /v1/integrations, GET /v1/integrations/{id}/calendars, GET /v1/integrations/{id}/events, GET /v1/integrations/{id}/events/{eventId}, potom POST /v1/integrations/{id}/events/{eventId}/propose s {calendarId, sourceRevision, patch} a po schválení PATCH /v1/integrations/{id}/events/{eventId} s rovnakými hodnotami a confirm: true.

Chyby

• calendar_stale_revision - Medzitým sa udalosť zmenila inde - načítajte ju znova (get_calendar_event) a nechajte používateľa schváliť nový návrh.
• calendar_oauth_failed - Google odmietol prihlásenie - pripojenie je potrebné urobiť znova v portáli.
• calendar_unauthorized - Pripojenie prestalo platiť (odvolaný prístup, vypršaný token) - pripojte účet znova.
• calendar_confirmation_required - Zápis bez confirm: true - návrh potvrďte až po schválení používateľom.
• calendar_verification_failed - Zápis prebehol, ale čerstvé načítanie späť nezodpovedá odoslanej zmene - overte stav ručne, needitujte naslepo znova.

Úplnú tabuľku so všetkými kódmi nájdete v sekcii Kalendáre v REST API referencii a v chybách MCP.

Zabezpečenie

Prístupové tokeny ku Google ani Apple účtu REST API ani MCP nikdy nevracajú a ukladáme ich šifrovane. Apple appPassword pošlite cez REST len vtedy, keď ho používateľ už bezpečne uložil do premennej prostredia alebo súboru, ktorý pomenoval - nikdy oň nežiadajte v konverzácii a neopakujte ho späť. Integráciu odpojíte v portáli alebo cez REST DELETE /v1/integrations/{id} po výslovnom schválení používateľom; MCP odpojenie neponúka.