Gmail Acties

Automatiseer uw e-mailworkflows met uitgebreide Gmail-acties. Stuur e-mails, beheer concepten, doorzoek uw inbox en behandel e-mailthreads — allemaal binnen SmartFlow.

---

Vereisten

Voordat u Gmail-acties kunt gebruiken, moet u:

1. Verbind uw Gmail-account in Kanalen → Gmail
2. Autoriseer de vereiste machtigingen via Google OAuth

Zie Gmail Kanaalinstelling voor gedetailleerde instructies voor verbinding.

---

Beschikbare Triggers

📥 Gmail AI Concept

Trigger Type: CHAT_SERVICE

Geactiveerd wanneer een gebruiker een e-mail naar uw verbonden Gmail-instantie stuurt. Gebruik dit om binnenkomende e-mails automatisch met AI te verwerken.

Veld	Beschrijving
Kanaal	Gmail
Evenement	Nieuwe e-mail ontvangen

Voorbeeld Workflow:

Gmail AI Concept (Trigger)
    ↓
AI Verzoek (Analyseer e-mailinhoud)
    ↓
Maak Gmail Concept (Genereer AI-reactie)

---

Beschikbare Acties

Actie	Code	Beschrijving
📤 Stuur Gmail E-mail	GMAIL_SEND_EMAIL	Stuur een nieuwe e-mail direct
📬 Lees Gmail E-mails	GMAIL_READ_EMAILS	Haal e-mails op uit uw inbox
📧 Krijg Gmail E-mail	GMAIL_GET_EMAIL	Krijg een specifieke e-mail op ID
↩️ Beantwoord Gmail E-mail	GMAIL_REPLY	Beantwoord een bestaande e-mailthread
🔍 Zoek Gmail E-mails	GMAIL_SEARCH	Zoek e-mails met Gmail-query-syntaxis
✅ Markeer Gmail E-mail als gelezen	GMAIL_MARK_READ	Markeer een e-mail als gelezen
📝 Maak Gmail Concept	GMAIL_CREATE_DRAFT	Maak een nieuw e-mailconcept
📋 Lijst Gmail Concepten	GMAIL_LIST_DRAFTS	Lijst alle concepten in uw account
📨 Stuur Gmail Concept	GMAIL_SEND_DRAFT	Stuur een bestaand concept
🗑️ Verwijder Gmail Concept	GMAIL_DELETE_DRAFT	Verwijder een concept
📂 Krijg E-mailthread	GMAIL_GET_THREAD	Haal volledige e-mailconversatie op

---

📤 Stuur Gmail E-mail

Stuur een nieuwe e-mail direct vanuit uw verbonden Gmail-account.

Configuratie

Veld	Type	Vereist	Beschrijving
Aan	E-mail	✅	E-mailadres van de ontvanger
Onderwerp	String	✅	Onderwerpregel van de e-mail
Inhoud	String	✅	Inhoud van de e-mail (HTML ondersteund)
CC	E-mail	❌	Carbon copy ontvangers
BCC	E-mail	❌	Blind carbon copy ontvangers

Uitvoer Variabelen

Variabele	Type	Beschrijving
messageId	String	Unieke ID van verzonden e-mail
threadId	String	Thread ID voor antwoorden

Voorbeeld

Actie: Stuur Gmail E-mail
  Aan: "{{customer_email}}"
  Onderwerp: "Uw bestelling #{{order_id}} is verzonden!"
  Inhoud: |
    Hallo {{customer_name}},
    
    Geweldig nieuws! Uw bestelling is verzonden.
    
    Volgnummer: {{tracking_number}}
    
    Met vriendelijke groet,
    Het Team

---

📬 Lees Gmail E-mails

Haal recente e-mails op uit uw inbox met optionele filtering.

Configuratie

Veld	Type	Vereist	Beschrijving
Max Resultaten	Nummer	❌	Maximale e-mails om op te halen (standaard: 10)
Label	String	❌	Gmail-label om te filteren (bijv. "INBOX", "ONLEZEN")
Query	String	❌	Gmail-zoekopdracht

Uitvoer Variabelen

Variabele	Type	Beschrijving
emails	Array	Lijst van e-mailobjecten
emails[].id	String	E-mail ID
emails[].subject	String	Onderwerp van de e-mail
emails[].from	String	E-mailadres van de afzender
emails[].snippet	String	E-mailvoorbeeld
emails[].date	String	Ontvangstdatum

Voorbeeld

Actie: Lees Gmail E-mails
  Max Resultaten: 5
  Label: "ONLEZEN"
  Query: "from:[email protected]"

---

📧 Krijg Gmail E-mail

Haal een specifieke e-mail op aan de hand van zijn ID met volledige inhoud.

Configuratie

Veld	Type	Vereist	Beschrijving
E-mail ID	String	✅	De Gmail-bericht ID

Uitvoer Variabelen

Variabele	Type	Beschrijving
email	Object	Volledig e-mailobject
email.id	String	E-mail ID
email.threadId	String	Thread ID
email.subject	String	Onderwerp van de e-mail
email.from	String	Afzender
email.to	String	Ontvangers
email.body	String	Volledige e-mailinhoud
email.date	String	Ontvangstdatum
email.attachments	Array	Lijst van bijlagen

---

↩️ Beantwoord Gmail E-mail

Beantwoord een bestaande e-mail, waarbij de threadcontext behouden blijft.

Configuratie

Veld	Type	Vereist	Beschrijving
Thread ID	String	✅	De thread om op te antwoorden
Bericht ID	String	✅	Het specifieke bericht om op te antwoorden
Inhoud	String	✅	Antwoordinhoud
Beantwoord Allen	Boolean	❌	Beantwoord alle ontvangers (standaard: false)

Uitvoer Variabelen

Variabele	Type	Beschrijving
messageId	String	ID van het antwoord
threadId	String	Thread ID

Voorbeeld

Actie: Beantwoord Gmail E-mail
  Thread ID: "{{email.threadId}}"
  Bericht ID: "{{email.id}}"
  Inhoud: |
    {{ai_response}}
    
    ---
    Dit is een AI-ondersteunde reactie.

---

🔍 Zoek Gmail E-mails

Zoek uw Gmail met de krachtige query-syntaxis van Gmail.

Configuratie

Veld	Type	Vereist	Beschrijving
Query	String	✅	Gmail-zoekopdracht
Max Resultaten	Nummer	❌	Maximale resultaten (standaard: 10)

Gmail Query Syntaxis

Query	Beschrijving
from:[email protected]	E-mails van specifieke afzender
to:[email protected]	E-mails naar specifieke ontvanger
subject:keyword	Onderwerp bevat trefwoord
is:unread	Alleen ongelezen e-mails
is:starred	Geselecteerde e-mails
has:attachment	E-mails met bijlagen
after:2025/01/01	E-mails na datum
before:2025/12/31	E-mails voor datum
label:important	E-mails met label
"exact phrase"	Exacte frase overeenkomst

Voorbeeld

Actie: Zoek Gmail E-mails
  Query: "from:{{customer_email}} is:unread subject:order"
  Max Resultaten: 5

---

✅ Markeer Gmail E-mail als gelezen

Markeer een e-mail als gelezen in Gmail.

Configuratie

Veld	Type	Vereist	Beschrijving
E-mail ID	String	✅	De e-mail om als gelezen te markeren

Voorbeeld

Actie: Markeer Gmail E-mail als gelezen
  E-mail ID: "{{email.id}}"

---

📝 Maak Gmail Concept

Maak een concept-e-mail voor menselijke beoordeling voordat deze wordt verzonden.

Configuratie

Veld	Type	Vereist	Beschrijving
Aan	E-mail	✅	Ontvanger e-mail
Onderwerp	String	✅	Onderwerp van de e-mail
Inhoud	String	✅	Inhoud van de e-mail
CC	E-mail	❌	Carbon copy
BCC	E-mail	❌	Blind carbon copy
Thread ID	String	❌	Voor conceptantwoorden

Uitvoer Variabelen

Variabele	Type	Beschrijving
draftId	String	ID van het gemaakte concept
messageId	String	Bericht ID

Gebruik Geval: AI Conceptmodus

Trigger: Gmail AI Concept
    ↓
AI Verzoek:
  Prompt: "Genereer een professionele reactie op deze e-mail"
  Input: "{{email.body}}"
    ↓
Maak Gmail Concept:
  Aan: "{{email.from}}"
  Onderwerp: "Re: {{email.subject}}"
  Inhoud: "{{ai_response}}"

---

📋 Lijst Gmail Concepten

Haal alle concepten op uit uw Gmail-account.

Configuratie

Veld	Type	Vereist	Beschrijving
Max Resultaten	Nummer	❌	Maximale concepten om te lijst

Uitvoer Variabelen

Variabele	Type	Beschrijving
drafts	Array	Lijst van conceptobjecten
drafts[].id	String	Concept ID
drafts[].message	Object	Voorbeeld van het conceptbericht

---

📨 Gmail Concept Verzenden

Verzend een bestaand concept vanuit uw Gmail.

Configuratie

Veld	Type	Vereist	Beschrijving
Concept ID	String	✅	Het concept dat verzonden moet worden

Uitvoer Variabelen

Variabele	Type	Beschrijving
messageId	String	ID van het verzonden bericht
threadId	String	Thread ID

---

🗑️ Gmail Concept Verwijderen

Verwijder een concept uit uw Gmail-account.

Configuratie

Veld	Type	Vereist	Beschrijving
Concept ID	String	✅	Het concept dat verwijderd moet worden

---

📂 E-mail Thread Ophalen

Haal een complete e-mailgesprek thread op.

Configuratie

Veld	Type	Vereist	Beschrijving
Thread ID	String	✅	De thread die opgehaald moet worden

Uitvoer Variabelen

Variabele	Type	Beschrijving
thread	Object	Volledige thread object
thread.id	String	Thread ID
thread.messages	Array	Alle berichten in de thread
thread.historyId	String	Geschiedenis ID

Voorbeeld

Actie: E-mail Thread Ophalen
  Thread ID: "{{email.threadId}}"

---

Volledige Workflow Voorbeelden

Voorbeeld 1: AI E-mail Assistent

Verwerk automatisch binnenkomende e-mails en maak AI-gegenereerde conceptantwoorden aan.

Gmail AI Concept (Trigger)
    ↓
E-mail Thread Ophalen (Haal volledige context op)
    ↓
AI Verzoek
  - Systeem: "U bent een behulpzame e-mailassistent"
  - Invoer: "{{thread.messages}}"
  - Uitvoer: Gestructureerd (antwoord, sentiment, urgentie)
    ↓
Als Voorwaarde: urgentie == "hoog"
    ├── Ja: Gmail E-mail Verzenden (onmiddellijk antwoord)
    └── Nee: Gmail Concept Maken (voor beoordeling)

Voorbeeld 2: E-mail Zoeken & Verwerken

Zoek naar specifieke e-mails en verwerk ze in bulk.

Geplande Workflow (Dagelijks om 9 uur)
    ↓
Zoek Gmail E-mails
  Query: "is:ongelezen van:klanten@* na:gisteren"
    ↓
Voor Elke: e-mail in e-mails
    ↓
AI Verzoek (Categoriseer e-mail)
    ↓
Als Voorwaarde: categorie == "ondersteuning"
    └── Maak JIRA Probleem

Voorbeeld 3: Concept Beoordelingsworkflow

Maak concepten, laat mensen beoordelen, en verzend dan.

Gmail AI Concept (Trigger)
    ↓
AI Verzoek (Genereer antwoord)
    ↓
Maak Gmail Concept
    ↓
Verzend Slack Bericht
  "Nieuw concept klaar voor beoordeling van {{email.from}}"

---

Beste Praktijken

1. Gebruik Conceptmodus voor Kritieke E-mails

Voor klantgerichte of gevoelige e-mails, gebruik altijd Gmail Concept Maken in plaats van Gmail E-mail Verzenden. Dit stelt menselijke beoordeling voor verzending mogelijk.

2. Maak Gebruik van Threadcontext

Gebruik E-mail Thread Ophalen voordat u reageert om ervoor te zorgen dat uw AI de volledige gesprekscontext heeft.

3. Implementeer Snelheidsbeperkingen

Gmail heeft API-quota. Voor workflows met een hoog volume:

• Voeg vertragingen tussen acties toe
• Groepeer bewerkingen waar mogelijk
• Houd uw quotagebruik in de gaten

4. Gebruik Slimme Zoekopdrachten

Combineer Gmail-queryoperators voor nauwkeurige filtering:

van:vip-klant@* is:ongelezen onderwerp:(urgent OF kritisch) na:2025/01/01

5. Behandel Fouten Op Een Vriendelijke Manier

Gebruik Als Voorwaarde knooppunten om op fouten te controleren en implementeer fallback-logica.

---

Gerelateerde Documentatie

• Gmail Kanaal Instelling
• E-mail Verzenden Actie (Generieke SMTP)
• AI Verzoek Actie
• Als Voorwaarde
• SmartFlow Introductie