Vejledninger

Forbindelser

Din AI-assistent (Claude, ChatGPT) og stemmeagenten i et opkald kan læse både Google Kalender og Apple Calendar og efter din godkendelse ændre en eksisterende begivenhed - og stemmeagenten på volais egen motor finder desuden direkte i opkaldet en ledig tid og skriver mødet ind med det samme. Ved Apple skal de uigennemsigtige ID'er bevares, og man skal være opmærksom på gentagne serier.

Hvad den kan og ikke kan

• Viser de tilsluttede kalendere og deres begivenheder.
• Ændrer titel, start eller slut på en eksisterende begivenhed.
• Stemmeagenten på volais egen motor finder en ledig tid i opkaldet og skriver mødet ind med det samme.
• Finder ledige tider og opretter et møde også uden for opkald via REST og MCP.

Kan ikke

• Sletter ingen begivenhed.
• Søger ikke efter ledige tider på tværs af flere deltagere.

Tilslutning af Google-konto

Google-kontoen tilsluttes i portalen i afsnittet Forbindelser (i portalens engelske menu hedder punktet »Integrations«). Når kontoen er tilsluttet, ser den samme API-nøgle det samme via både REST og MCP - ingen ekstra login.

Kontoen kan afbrydes i portalen eller via REST DELETE /v1/integrations/{id}. REST afbryder integrationen med det samme og uden et ekstra bekræftelsesfelt, så kald den først efter brugerens udtrykkelige godkendelse. MCP har intet værktøj til at afbryde.

Apple Calendar

Tilsluttes med en app-specifik adgangskode (ikke den almindelige adgangskode til Apple-kontoen) i portalen i afsnittet Data og integrationer. Tilslutning kan også ske via REST POST /v1/integrations med {provider: "apple-calendar", username, appPassword, calendarUrl?}; MCP modtager ikke loginoplysninger og bruger kontoen først efter tilslutningen.

list_calendar_events og REST GET /v1/integrations/{id}/events understøtter Apple Calendar. Det returnerede uigennemsigtige externalId skal videregives uændret som eventId til get_calendar_event og til ændringer; det er ikke et iCalendar-UID. En række med recurring: true er en hel gentaget serie, og en ændring ændrer seriens grundlag, ikke den enkelte forekomst; de enkelte undtagelser bevares.

calendarId skal være en af de adresser, list_calendars returnerer - alt andet afvises af API'et med fejlen 400 calendar_invalid_calendar.

Tider i opkaldet

Stemmeagenten på volais egen motor kan direkte i telefonsamtalen finde en ledig tid og skrive mødet ind med det samme - det er ikke en AI-assistent i en chat, men et opkald, som stemmeagenten selv fører. Det slås til i agentens editor under fanen Kalender: vælg forbindelse, kalender og tilgængelighedsregler (vinduer efter ugedag, mødets længde, buffer mellem tider, mindste varsel, søgehorisont).

• Fungerer kun for en agent på volais egen stemmemotor - for en agent på ElevenLabs gemmes indstillingen og venter på den automatiske omstilling af motoren.
• Agenten fortæller aldrig, hvad der står i kalenderen - kun om et givent tidspunkt er ledigt.
• Den ringendes telefonnummer skrives kun ind i begivenheden, hvis agenten kender det; et skjult nummer betyder en begivenhed uden telefon.
• Den samme søgning efter ledige tider og indskrivning af et møde fungerer også uden for opkald via REST (POST .../availability, POST .../events) og MCP (find_free_slots, create_calendar_event).

Fakturoid og ABRA Flexi

Denne side dækker kun kalendere. Fakturoid og ABRA Flexi tilsluttes samme sted (list_integrations/GET /v1/integrations, afsnittet Data og integrationer i portalen), men læsning af fakturaer og brugen af dem i opgaver med betalingspåmindelser har en egen vejledning Fakturaer.

Fremgangsmåde for agenten

Ændring af en begivenhed har altid seks trin i denne rækkefølge:

• 1. list_integrations - de tilsluttede kalendere og deres integrationId.
• 2. list_calendars - kalenderne for den givne forbindelse og deres calendarId.
• 3. list_calendar_events, derefter get_calendar_event med det returnerede externalId som eventId - henter begivenheden og dens aktuelle sourceRevision.
• 4. propose_calendar_update - forbereder et ændringsforslag, skriver endnu intet.
• 5. Brugerens godkendelse - agenten viser de oprindelige værdier og forslaget og fortsætter først derefter.
• 6. confirm_calendar_update med confirm: true - først dette trin skriver ændringen til Google/Apple.

REST-ækvivalenter: GET /v1/integrations, GET /v1/integrations/{id}/calendars, GET /v1/integrations/{id}/events, GET /v1/integrations/{id}/events/{eventId}, derefter POST /v1/integrations/{id}/events/{eventId}/propose med {calendarId, sourceRevision, patch} og efter godkendelse PATCH /v1/integrations/{id}/events/{eventId} med de samme værdier og confirm: true.

Fejl

• calendar_stale_revision - Begivenheden er i mellemtiden ændret et andet sted - hent den igen (get_calendar_event), og lad brugeren godkende et nyt forslag.
• calendar_oauth_failed - Google afviste login - forbindelsen skal oprettes igen i portalen.
• calendar_unauthorized - Forbindelsen er ikke længere gyldig (tilbagekaldt adgang, udløbet token) - tilslut kontoen igen.
• calendar_confirmation_required - Skrivning uden confirm: true - bekræft først forslaget efter brugerens godkendelse.
• calendar_verification_failed - Skrivningen lykkedes, men en ny aflæsning svarer ikke til den afsendte ændring - kontrollér tilstanden manuelt, og rediger ikke blindt igen.

Den fulde tabel med alle koder findes i afsnittet Kalendere i REST API-referencen og i MCP-fejl.

Sikkerhed

Adgangstokens til Google- eller Apple-kontoen returnerer hverken REST API eller MCP nogensinde, og vi gemmer dem krypteret. Apple-appPassword må kun sendes via REST, når brugeren allerede har gemt det sikkert i en miljøvariabel eller en fil, brugeren har navngivet - bed aldrig om det i samtalen, og gentag det ikke tilbage. Integrationen afbrydes i portalen eller via REST DELETE /v1/integrations/{id} efter brugerens udtrykkelige godkendelse; MCP tilbyder ikke afbrydelse.