Communicatie
Gmail koppelen aan een autonome AI-agent
Gmail bundelt uw klant- en interne correspondentie. Een Atako-agent kan sorteren, concepten voorbereiden en een mailbox opschonen, zonder ooit uw Google-wachtwoord te zien.
Binnenkort beschikbaar — maak je account aan en we laten het je weten zodra deze integratie klaar is.
Mogelijke workflows
Sorteren en antwoordconcepten voor de gedeelde supportmailbox
Een mailbox support@ ontvangt tientallen berichten per dag. De agent haalt de ongelezen berichten op met list_messages, deelt ze in per label met add_label_to_message (facturatie, bug, algemene vraag), en stelt vervolgens voor elke duidelijke aanvraag een antwoord op als concept met create_draft. Een mens leest het na en verstuurt het met send_draft. De agent gebruikt send_email alleen als die precieze grant hem is toegekend.
Periodieke opschoning van de mailbox
Nieuwsbrieven, automatische meldingen, ontvangstbevestigingen: de agent zoekt deze berichten met search_messages (bv. from:noreply), controleert hun label met list_labels, en verplaatst ze vervolgens naar de prullenbak met trash_message in plaats van ze te laten opstapelen in de hoofdmailbox. De mailbox blijft overzichtelijk zonder dat een mens er elke ochtend tien minuten aan besteedt aan dit handmatige, repetitieve sorteerwerk, week na week.
Opvolging van klantconversaties die om een reactie vragen
De agent zoekt naar conversaties zonder antwoord sinds meer dan drie dagen met search_messages, haalt de volledige context op met get_thread, labelt ze met add_label_to_message, en stelt vervolgens een opvolgconcept op met create_draft. Er wordt nooit iets verstuurd zonder menselijke goedkeuring: de agent bereidt alleen het terrein voor zodat de opvolging nog diezelfde dag kan vertrekken, zonder te wachten tot een salesmedewerker er zelf aan denkt.
Acties van de connector
list_messages
Lezen. Lijst van bericht-identifiers, filterbaar op label.
search_messages
Lezen. Berichten zoeken met een Gmail-zoekopdracht.
get_message
Lezen. Een volledig bericht ophalen, inclusief headers en inhoud.
get_thread
Lezen. Een volledige gespreksconversatie ophalen.
list_drafts
Lezen. Lijst van bestaande concepten.
create_draft
Schrijven. Een antwoordconcept aanmaken zonder het te versturen.
send_draft
Schrijven. Een bestaand concept versturen.
send_email
Schrijven. Direct een e-mail versturen vanaf het gekoppelde account.
add_label_to_message
Schrijven. Een label toevoegen aan een bericht.
trash_message
Schrijven. Een bericht naar de prullenbak verplaatsen.
Vereisten
- Adminrol binnen het Atako-bedrijf om de integratie te koppelen.
- Gmail- of Google Workspace-account waarvan de mailbox moet worden gekoppeld.
- Google OAuth-toestemming, scope https://www.googleapis.com/auth/gmail.modify.
- Een expliciete grant per agent, met name voor de actie send_email.
Hoe te verbinden
- 1
Instellingen → Integraties openen
Een admin kiest Gmail uit de lijst met beschikbare connectors.
- 2
De blootgestelde acties controleren
Het venster toont alle lees- en schrijfacties, send_email inbegrepen, voor u toestemming geeft.
- 3
Aanmelden via het Google-scherm
Doorverwijzing naar de Google-toestemmingspagina, er wordt geen wachtwoord doorgegeven aan Atako.
- 4
Toegang verlenen aan een agent
U kiest per agent de precieze acties, bijvoorbeeld alleen create_draft om voorzichtig te blijven.
Waarom een autonome agent op Gmail aansluiten
Gmail bundelt de correspondentie met klanten, leveranciers en het team. 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 bericht te zoeken, in te delen of een antwoord voor te bereiden, dankzij tool calling.
De verbinding gebruikt OAuth 2.0, scope https://www.googleapis.com/auth/gmail.modify (Gmail-scopes van Google). Deze scope maakt het mogelijk om te lezen, op te stellen en te versturen, maar niet om een bericht onmiddellijk en permanent te verwijderen.
Dat maakt een flow zoals het sorteren van een supportmailbox nuttig, vergelijkbaar met wat een agent voor supporttriage of supportautomatisering doet: hij ontvangt elk nieuw bericht en bereidt een antwoord voor zonder te wachten tot een mens een chatgesprek opent. Gmail 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 send_email: eenmaal toegekend met schrijfscope, verstuurt de agent zonder terug naar u te gaan. De veiligste aanpak is om alleen create_draft toe te kennen: de agent bereidt voor, een mens leest na en activeert de verzending met send_draft.
De scope gmail.modify dekt de hele gekoppelde mailbox, niet één specifiek label of etiket. De werkelijke grens komt dus van de grant: geef precies de acties op die de agent nodig heeft, in plaats van meteen alles toe te kennen bij de verbinding.
De documentatie vermeldt geen ratelimiet die specifiek is voor de Gmail-connector. 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 in mijn plaats een e-mail versturen?
Ja, als de grant send_email met schrijfscope bevat, verstuurt de agent dan rechtstreeks. De meeste bedrijven kiezen ervoor om alleen create_draft toe te kennen: de agent bereidt het antwoord voor, een mens leest het na en verstuurt het met send_draft.
Is een betaald plan nodig om Gmail te koppelen?
Ja, een actief Atako-plan is vereist, maar Gmail behoort tot alle integraties die al zijn inbegrepen in het Standard-plan, zonder meerkosten per connector.
Hoe trekt u de toegang van Atako tot uw Gmail-mailbox in?
Klik in Instellingen → Integraties op Revoke bij de Gmail-verbinding. Het versleutelde token wordt onmiddellijk verwijderd, en alle agents die het gebruikten verliezen meteen hun toegang.
Kan met de scope gmail.modify e-mails definitief worden verwijderd?
Nee, deze scope maakt het mogelijk om te lezen, op te stellen, te versturen en naar de prullenbak te verplaatsen, maar niet om een bericht onmiddellijk en permanent te verwijderen, daarvoor zou een ruimere scope nodig zijn dan die de connector gebruikt.
Wat hierna te lezen
Bronnen
- Gmail API, scopes OAuth · geraadpleegd op 4 september 2026
- Gmail API, guide d'envoi d'emails · geraadpleegd op 4 september 2026
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.