Juhendid

Ühendused

Teie tehisintellekti assistent (Claude, ChatGPT) ja häälagent kõne ajal saavad mõlemad lugeda Google Calendari ja Apple Calendari ning pärast teie kinnitust olemasolevat sündmust muuta - ja volai enda mootoril töötav häälagent saab kontrollida ka vaba aega ning broneerida kohtumise otse kõne ajal. Apple'i puhul säilitage läbipaistmatud ID-d ja olge korduvate sarjadega ettevaatlik.

Mida see oskab ja mida mitte

• Loetleb ühendatud kalendrid ja nende sündmused.
• Muudab olemasoleva sündmuse pealkirja, algust või lõppu.
• volai enda mootoril töötav häälagent kontrollib vaba aega ja broneerib kohtumise kõne ajal.
• Leiab vabu aegu ja loob kohtumise ka väljaspool kõnet, REST-i ja MCP kaudu.

Ei oska

• Ei kustuta kunagi sündmust.
• Ei otsi vabu aegu mitme osaleja vahel.

Google'i konto ühendamine

Ühendage Google'i konto portaalis jaotises Ühendused (portaali menüüs kirje Integratsioonid). Kui konto on ühendatud, näeb sama API võti sama asja nii REST-i kui ka MCP kaudu - eraldi sisselogimist pole vaja.

Konto saab lahutada portaalis või REST-iga DELETE /v1/integrations/{id}. REST lahutab selle kohe ja lisakinnitusvälja pole, seega kutsuge seda ainult pärast kasutaja selget nõusolekut. MCP-l lahutamise tööriista ei ole.

Apple Calendar

Ühendatakse rakenduse parooliga (mitte teie tavalise Apple'i konto parooliga) portaalis jaotises Andmed ja integratsioonid. REST saab selle ühendada ka päringuga POST /v1/integrations ja {provider: "apple-calendar", username, appPassword, calendarUrl?}; MCP ei võta volitusandmeid vastu ja saab kontot kasutada alles pärast selle ühendamist.

list_calendar_events ja REST GET /v1/integrations/{id}/events toetavad Apple Calendarit. Kasutage tagastatud läbipaistmatut externalId muutmata kujul kui eventId tööriistas get_calendar_event ja muudatustes; see ei ole iCalendari UID. Rida väärtusega recurring: true esindab kogu korduvat sarja ja selle muutmine muudab sarja põhisündmust, mitte ühte esinemiskorda; üksikud erandid säilivad.

calendarId peab olema üks tööriista list_calendars tagastatud aadressidest - kõik muu lükatakse tagasi veaga 400 calendar_invalid_calendar.

Ajastamine kõne ajal

volai enda mootoril töötav häälagent saab kontrollida vaba aega ja broneerida kohtumise otse telefonikõne ajal - see ei ole vestlusrobot-assistent, vaid häälagent, kes kõnet ise peab. Lülitage see sisse agendiredaktori vahekaardil Kalender: valige ühendus, kalender ja saadavuse reeglid (aknad nädalapäevade kaupa, kohtumise pikkus, puhver kohtumiste vahel, minimaalne etteteatamisaeg, otsinguhorisont).

• Töötab ainult volai enda häälmootoril - ElevenLabsis majutatud agendi puhul seadistus salvestatakse ja see ootab automaatset mootoriülekannet.
• Agent ei ütle kunagi, mis on kalendrisse kirjutatud - ainult seda, kas antud aeg on vaba.
• Helistaja telefoninumber kirjutatakse sündmusele ainult siis, kui agent seda teab; varjatud number tähendab, et sündmusel telefoninumbrit ei ole.
• Sama vaba aja otsing ja broneerimine töötavad ka väljaspool kõnet REST-i (POST .../availability, POST .../events) ja MCP (find_free_slots, create_calendar_event) kaudu.

Fakturoid ja ABRA Flexi

See leht käsitleb ainult kalendreid. Fakturoid ja ABRA Flexi ühendatakse samas kohas (list_integrations/GET /v1/integrations, portaali jaotis Andmed ja integratsioonid), kuid arvete lugemisel ja nende kasutamisel meeldetuletusülesannetes on oma juhend, Arved.

Agendi järjestus

Sündmuse muutmine on alati kuus sammu selles järjekorras:

• 1. list_integrations - ühendatud kalendrid ja nende integrationId.
• 2. list_calendars - selle ühenduse kalendrid ja nende calendarId.
• 3. list_calendar_events, seejärel get_calendar_event tagastatud externalId-ga kui eventId - loeb sündmuse ja selle praeguse sourceRevisioni.
• 4. propose_calendar_update - valmistab muudatuse ette, midagi veel ei kirjuta.
• 5. Kasutaja kinnitus - agent näitab algseid väärtusi ja ettepanekut ning jätkab alles siis.
• 6. confirm_calendar_update väärtusega confirm: true - alles see samm kirjutab muudatuse Google'isse/Apple'isse.

REST-i vasted: GET /v1/integrations, GET /v1/integrations/{id}/calendars, GET /v1/integrations/{id}/events, GET /v1/integrations/{id}/events/{eventId}, seejärel POST /v1/integrations/{id}/events/{eventId}/propose koos {calendarId, sourceRevision, patch} ja pärast kinnitust PATCH /v1/integrations/{id}/events/{eventId} samade väärtuste ja confirm: true-ga.

Vead

• calendar_stale_revision - Sündmust muudeti vahepeal mujal - lugege see uuesti (get_calendar_event) ja laske uus ettepanek kinnitada.
• calendar_oauth_failed - Google lükkas sisselogimise tagasi - ühendus tuleb portaalis uuesti teha.
• calendar_unauthorized - Ühendus ei kehti enam (juurdepääs tühistatud, token aegunud) - ühendage konto uuesti.
• calendar_confirmation_required - Kirjutamine ilma confirm: true - kinnitage ettepanek alles pärast kasutaja nõusolekut.
• calendar_verification_failed - Kirjutamine läks läbi, kuid värske tagasilugemine ei vasta saadetule - kontrollige olekut käsitsi, ärge proovige pimesi uuesti.

Kõigi koodide täielik tabel on REST API viite kalendrijaotises ja MCP veaviites.

Turvalisus

Google'i või Apple'i konto juurdepääsutokeneid ei tagastata kunagi REST-i ega MCP kaudu ja need hoitakse krüpteeritult. Saatke Apple'i appPassword REST-i kaudu ainult siis, kui kasutaja on selle juba turvaliselt keskkonnamuutujasse või ise nimetatud faili salvestanud - ärge küsige seda kunagi vestluses ega korrake seda. Lahutage integratsioon portaalis või REST-iga DELETE /v1/integrations/{id} pärast kasutaja selget nõusolekut; MCP lahutamist ei paku.