Agenda

Google Calendar koppelen aan een autonome AI-agent

Google Calendar centraliseert afspraken en beschikbaarheid van het hele bedrijf. Een Atako-agent kan tijdslots voorstellen, evenementen aanmaken en conflicten opsporen, zonder ooit uw Google-wachtwoord te zien.

Geschreven door de Atako-agents · Nagelezen en goedgekeurd door Romain Laodicina · CTO bij Atako

Binnenkort beschikbaar — maak je account aan en we laten het je weten zodra deze integratie klaar is.

Mogelijke workflows

Klantafspraak plannen zonder heen-en-weer gemail

Een verkoper of een supportteam ontvangt een afspraakverzoek. De agent controleert vrije tijdslots met check_availability op de betreffende agenda, stelt twee of drie passende tijdslots voor en maakt vervolgens het evenement aan met create_event zodra het gekozen tijdslot is bevestigd. De uitnodiging wordt automatisch naar de deelnemers verstuurd zodra het evenement is aangemaakt, als de grant create_event schrijfscope heeft; zonder die grant somt de agent alleen de beschikbare tijdslots op in een voorbereid bericht, zonder de afspraak zelf te boeken.

Opsporen van conflicten en dubbele boekingen

De agent haalt aankomende evenementen op met list_events, signaleert twee vergaderingen die overlappen of een afspraak die al meerdere dagen onbevestigd is gebleven, en bereidt een oplossingsvoorstel voor. Hij verplaatst of annuleert zelf niets: cancel_event en update_event blijven aparte acties, die afzonderlijk worden toegekend als het bedrijf wil dat de agent direct ingrijpt in plaats van het conflict alleen te melden aan de organisator.

Gezamenlijk tijdslot zoeken voor een sollicitatiegesprek of teamoverleg

Om een sollicitatiegesprek of een vergadering met meerdere agenda's te organiseren, haalt de agent de toegankelijke agenda's op met list_calendars, bevraagt hun beschikbaarheid met check_availability, en identificeert vervolgens het eerste gezamenlijke tijdslot binnen de gevraagde periode. Hij maakt het evenement pas aan zodra dat tijdslot door een mens is goedgekeurd, tenzij create_event expliciet is toegekend om het inplannen volledig te automatiseren.

Acties van de connector

  • list_events

    Lezen. Lijst van de evenementen van een agenda over een bepaalde periode.

  • get_event

    Lezen. Volledige details van een evenement ophalen, inclusief deelnemers.

  • search_events

    Lezen. Evenementen zoeken met een tekstquery.

  • check_availability

    Lezen. Vrije en bezette tijdslots van een of meerdere agenda's controleren.

  • list_calendars

    Lezen. Lijst van de agenda's die toegankelijk zijn voor het gekoppelde account.

  • create_event

    Schrijven. Een evenement aanmaken, met de deelnemers.

  • update_event

    Schrijven. Een bestaand evenement wijzigen: tijdstip, deelnemers of omschrijving.

  • respond_to_event

    Schrijven. Reageren op een ontvangen uitnodiging: accepteren, weigeren of voorlopig.

  • add_attendee

    Schrijven. Een deelnemer toevoegen aan een bestaand evenement.

  • cancel_event

    Schrijven. Een bestaand agenda-evenement annuleren.

Vereisten

  • Adminrol binnen het Atako-bedrijf om de integratie te koppelen.
  • Google-account, persoonlijk of Workspace, waarvan de agenda moet worden gekoppeld.
  • Google OAuth-toestemming, scope https://www.googleapis.com/auth/calendar.events.
  • Een expliciete grant per agent, met name voor create_event en cancel_event.

Hoe te verbinden

  1. 1

    Instellingen → Integraties openen

    Een admin kiest Google Calendar uit de lijst met beschikbare connectors.

  2. 2

    De blootgestelde acties controleren

    Het venster toont alle agenda-acties, lezen en schrijven, voor u toestemming geeft.

  3. 3

    Aanmelden via het Google-scherm

    Doorverwijzing naar de Google-toestemmingspagina, er wordt geen wachtwoord doorgegeven aan Atako.

  4. 4

    Toegang verlenen aan een agent

    U kiest per agent de precieze acties, bijvoorbeeld alleen check_availability en list_events om alleen-lezen te blijven.

Waarom een autonome agent op Google Calendar aansluiten

Google Calendar bundelt afspraken, vergaderingen en beschikbaarheid voor een groot deel van de bedrijven, vooral die met Google Workspace. Een autonome agent die hierop is aangesloten, beantwoordt niet zomaar een losse opdracht: hij draait continu en beslist, afhankelijk van de ontvangen instructie, om een vrij tijdslot te controleren, een conflict op te sporen of een afspraak voor te stellen, dankzij tool calling.

De verbinding gebruikt OAuth 2.0 en de Google Calendar-scope calendar.events (OAuth-scopes van Google). Deze scope maakt het mogelijk om agenda-evenementen te lezen, aan te maken en te wijzigen, maar nooit om het Google-account zelf te verwijderen of de beveiligingsinstellingen ervan te wijzigen.

Dat maakt een flow zoals het zoeken naar een gezamenlijk tijdslot voor een sollicitatiegesprek nuttig, vergelijkbaar met wat een agent voor hr-operaties doet, of het inplannen van een verkoopafspraak, vergelijkbaar met een agent voor omzetoperaties: hij ontvangt een verzoek en bereidt de volgende stap voor (een tijdslot, een evenement, een bevestigingsherinnering) zonder te wachten tot een mens zijn agenda opent om de beschikbaarheid van meerdere personen handmatig te vergelijken. Google Calendar behoort tot de integraties die zijn opgenomen in het Standard-plan, zonder aparte factuurregel per connector.

Grenzen en aanbevolen aanpak

De gevoeligste actie van de connector is create_event: eenmaal toegekend met schrijfscope, boekt de agent een afspraak en verstuurt Google automatisch de uitnodiging naar alle deelnemers, zonder terug naar u te gaan. De veiligste aanpak is om alleen check_availability en list_events toe te kennen: de agent stelt tijdslots voor, een mens maakt het definitieve evenement aan en verstuurt zelf de uitnodigingen.

De scope calendar.events dekt de hele agenda van het gekoppelde account, niet één specifieke secundaire agenda. De werkelijke grens komt dus van de grant: geef precies de acties op die de agent nodig heeft, bijvoorbeeld alleen lezen voor eenvoudige raadpleging, in plaats van meteen bij de koppeling zowel aanmaken als annuleren toe te kennen.

update_event en cancel_event wijzigen of verwijderen een bestaand evenement, ook voor de andere deelnemers als zij de oorspronkelijke uitnodiging al hebben geaccepteerd. Reserveer deze twee acties voor een agent wiens rol dit echt vereist, en houd cancel_event gescheiden van create_event in de grant als u wilt dat hij kan voorstellen zonder ooit te kunnen annuleren.

De documentatie vermeldt geen ratelimiet die specifiek is voor de Google Calendar-connector, de standaardquota's van de Google Calendar API zijn van toepassing. Elke aanroep, verstuurd of geweigerd, blijft raadpleegbaar in het auditlogboek van de agentpagina. En zoals bij elk OAuth-account: als het token verloopt of aan de kant van Google wordt ingetrokken, gaat de verbinding in foutstatus tot ze opnieuw wordt gekoppeld.

Gerelateerde use cases

Vergelijkbare integraties

Veelgestelde vragen

Kan de agent zonder goedkeuring een afspraak aanmaken en de uitnodiging versturen?

Ja, als de grant create_event met schrijfscope bevat, maakt de agent het evenement aan en verstuurt Google de uitnodiging automatisch naar de deelnemers. De meeste bedrijven beperken de agent liever tot check_availability en list_events: hij stelt tijdslots voor, een mens maakt de definitieve afspraak aan.

Is een betaald plan nodig om Google Calendar te koppelen?

Ja, een actief Atako-plan is vereist, maar Google Calendar behoort tot de integraties die al zijn inbegrepen in het Standard-plan, zonder meerkosten per connector.

Hoe trekt u de toegang van Atako tot uw Google-agenda in?

Klik in Instellingen → Integraties op Revoke bij de Google Calendar-verbinding. Het versleutelde token wordt onmiddellijk verwijderd, en alle agents die het gebruikten verliezen meteen hun toegang.

Kan met de scope calendar.events de agenda van andere collega's worden bekeken?

Nee, deze scope dekt alleen het gekoppelde Google-account. De agent ziet de agenda van een collega alleen als deze vooraf expliciet met dat account is gedeeld, en enkel binnen de grenzen van die deling.

Wat hierna te lezen

Bronnen

Romain Laodicina

CTO bij Atako

Deze inhoud is geschreven door de AI-agents van Atako en vervolgens nagelezen, gecorrigeerd en goedgekeurd door Romain Laodicina, CTO van Atako.

Implementeer uw eerste AI-agenten

Maak gratis een account aan en lanceer een agent in enkele minuten, zonder code.

Blijf voorop lopen op het gebied van AI.

Ontvang productnieuws, nieuwe agenten en onze AI-analyses rechtstreeks in uw mailbox. Geen spam, u kunt zich op elk moment uitschrijven.