Gmaili toimingud

Automatiseerige oma e-posti töövood põhjalike Gmaili toimingutega. Saatke e-kirju, hallake mustandeid, otsige oma postkastist ja käsitlege e-posti teemasid — kõik SmartFlow'is.

---

Eeltingimused

Enne Gmaili toimingute kasutamist peate:

1. Ühendama oma Gmaili konto jaotises Kanali → Gmail
2. Autoriseerima vajalikud õigused Google OAuth kaudu

Vaadake Gmaili kanali seadistamine üksikasjalike ühendamisjuhiste jaoks.

---

Saadaval olevad käivitajad

📥 Gmail AI mustand

Käivitaja tüüp: CHAT_SERVICE

Käivitub, kui kasutaja saadab e-kirja teie ühendatud Gmaili instantsile. Kasutage seda, et automaatselt töödelda sissetulevaid e-kirju AI abil.

Väli	Kirjeldus
Kanal	Gmail
Sündmus	Uus e-kiri saabus

Näidis töövoog:

Gmail AI mustand (Käivitaja)
    ↓
AI päring (Analüüsi e-kirja sisu)
    ↓
Loo Gmaili mustand (Genereeri AI vastus)

---

Saadaval olevad toimingud

Toiming	Kood	Kirjeldus
📤 Saada Gmaili e-kiri	GMAIL_SEND_EMAIL	Saatke uus e-kiri otse
📬 Loe Gmaili e-kirju	GMAIL_READ_EMAILS	Tooge e-kirjad oma postkastist
📧 Hangi Gmaili e-kiri	GMAIL_GET_EMAIL	Hankige konkreetne e-kiri ID järgi
↩️ Vasta Gmaili e-kirjale	GMAIL_REPLY	Vastake olemasolevale e-kirja teemale
🔍 Otsi Gmaili e-kirju	GMAIL_SEARCH	Otsige e-kirju Gmaili päringusüntaksiga
✅ Märgi Gmaili e-kiri loetuks	GMAIL_MARK_READ	Märgi e-kiri loetuks
📝 Loo Gmaili mustand	GMAIL_CREATE_DRAFT	Loo uus e-kirja mustand
📋 Loetle Gmaili mustandid	GMAIL_LIST_DRAFTS	Loetle kõik mustandid oma kontol
📨 Saada Gmaili mustand	GMAIL_SEND_DRAFT	Saatke olemasolev mustand
🗑️ Kustuta Gmaili mustand	GMAIL_DELETE_DRAFT	Kustuta mustand
📂 Hangi e-kirja teema	GMAIL_GET_THREAD	Taasta täielik e-kirja vestlus

---

📤 Saada Gmaili e-kiri

Saatke uus e-kiri otse oma ühendatud Gmaili kontolt.

Konfiguratsioon

Väli	Tüüp	Nõutav	Kirjeldus
Kellele	E-post	✅	Saaja e-posti aadress
Teema	String	✅	E-kirja teema
Sisu	String	✅	E-kirja sisu (HTML toetatud)
CC	E-post	❌	Koopia saajad
BCC	E-post	❌	Pime koopia saajad

Väljundmuutujad

Muutuja	Tüüp	Kirjeldus
messageId	String	Saadetud e-kirja ainulaadne ID
threadId	String	Vastuste teema ID

Näidis

Toiming: Saada Gmaili e-kiri
  Kellele: "{{customer_email}}"
  Teema: "Teie tellimus #{{order_id}} on saadetud!"
  Sisu: |
    Tere {{customer_name}},
    
    Suurepärane uudis! Teie tellimus on saadetud.
    
    Jälgimisnumber: {{tracking_number}}
    
    Parimate soovidega,
    Meeskond

---

📬 Loe Gmaili e-kirju

Tooge hiljutised e-kirjad oma postkastist valikulise filtreerimisega.

Konfiguratsioon

Väli	Tüüp	Nõutav	Kirjeldus
Max Results	Number	❌	Maksimaalne e-kirjade arv, mida tuua (vaikimisi: 10)
Silt	String	❌	Gmaili silt filtreerimiseks (nt "POSTKAST", "LOETUD")
Päring	String	❌	Gmaili otsingupäring

Väljundmuutujad

Muutuja	Tüüp	Kirjeldus
emails	Array	E-kirjade objektide loend
emails[].id	String	E-kirja ID
emails[].subject	String	E-kirja teema
emails[].from	String	Saatja e-post
emails[].snippet	String	E-kirja eelvaade
emails[].date	String	Saamise kuupäev

Näidis

Toiming: Loe Gmaili e-kirju
  Max Results: 5
  Silt: "LOETUD"
  Päring: "from:[email protected]"

---

📧 Hangi Gmaili e-kiri

Hankige konkreetne e-kiri selle ID järgi koos täieliku sisuga.

Konfiguratsioon

Väli	Tüüp	Nõutav	Kirjeldus
E-kirja ID	String	✅	Gmaili sõnumi ID

Väljundmuutujad

Muutuja	Tüüp	Kirjeldus
email	Object	Täielik e-kirja objekt
email.id	String	E-kirja ID
email.threadId	String	Teema ID
email.subject	String	E-kirja teema
email.from	String	Saatja
email.to	String	Saajad
email.body	String	Täielik e-kirja sisu
email.date	String	Kuupäev, mil e-kiri saadi
email.attachments	Array	Manuste loend

---

↩️ Vasta Gmaili e-kirjale

Vastake olemasolevale e-kirjale, säilitades teema konteksti.

Konfiguratsioon

Väli	Tüüp	Nõutav	Kirjeldus
Teema ID	String	✅	Teema, millele vastata
Sõnumi ID	String	✅	Konkreetne sõnum, millele vastata
Sisu	String	✅	Vastuse sisu
Vasta kõigile	Boolean	❌	Vastake kõigile saajatele (vaikimisi: vale)

Väljundmuutujad

Muutuja	Tüüp	Kirjeldus
messageId	String	Vastuse ID
threadId	String	Teema ID

Näidis

Toiming: Vasta Gmaili e-kirjale
  Teema ID: "{{email.threadId}}"
  Sõnumi ID: "{{email.id}}"
  Sisu: |
    {{ai_response}}
    
    ---
    See on AI abil koostatud vastus.

---

🔍 Otsi Gmaili e-kirju

Otsige oma Gmaili, kasutades Gmaili võimsat päringusüntaksit.

Konfiguratsioon

Väli	Tüüp	Nõutav	Kirjeldus
Päring	String	✅	Gmaili otsingupäring
Max Results	Number	❌	Maksimaalsed tulemused (vaikimisi: 10)

Gmaili päringusüntaks

Päring	Kirjeldus
from:[email protected]	E-kirjad konkreetse saatja poolt
to:[email protected]	E-kirjad konkreetsele saajale
subject:keyword	Teema sisaldab märksõna
is:unread	Ainult loetud e-kirjad
is:starred	Tärniga märgitud e-kirjad
has:attachment	E-kirjad manustega
after:2025/01/01	E-kirjad pärast kuupäeva
before:2025/12/31	E-kirjad enne kuupäeva
label:important	E-kirjad, millel on silt
"exact phrase"	Täpne fraasi vaste

Näidis

Toiming: Otsi Gmaili e-kirju
  Päring: "from:{{customer_email}} is:unread subject:order"
  Max Results: 5

---

✅ Märgi Gmaili e-kiri loetuks

Märgi e-kiri Gmailis loetuks.

Konfiguratsioon

Väli	Tüüp	Nõutav	Kirjeldus
E-kirja ID	String	✅	E-kiri, mille soovite märkida loetuks

Näidis

Toiming: Märgi Gmaili e-kiri loetuks
  E-kirja ID: "{{email.id}}"

---

📝 Loo Gmaili mustand

Loo mustand e-kirjast inimeste ülevaatamiseks enne saatmist.

Konfiguratsioon

Väli	Tüüp	Nõutav	Kirjeldus
Kellele	E-post	✅	Saaja e-post
Teema	String	✅	E-kirja teema
Sisu	String	✅	E-kirja sisu
CC	E-post	❌	Koopia
BCC	E-post	❌	Pime koopia
Teema ID	String	❌	Mustandite vastuste jaoks

Väljundmuutujad

Muutuja	Tüüp	Kirjeldus
draftId	String	Loodud mustandi ID
messageId	String	Sõnumi ID

Kasutuse juhtum: AI mustandi režiim

Käivitaja: Gmail AI mustand
    ↓
AI päring:
  Prompt: "Genereeri professionaalne vastus sellele e-kirjale"
  Input: "{{email.body}}"
    ↓
Loo Gmaili mustand:
  Kellele: "{{email.from}}"
  Teema: "Re: {{email.subject}}"
  Sisu: "{{ai_response}}"

---

📋 Loetle Gmaili mustandid

Hankige kõik mustandid oma Gmaili kontolt.

Konfiguratsioon

Väli	Tüüp	Nõutav	Kirjeldus
Max Results	Number	❌	Maksimaalne mustandite arv, mida loetleda

Väljundmuutujad

Muutuja	Tüüp	Kirjeldus
drafts	Array	Mustandi objektide loend
drafts[].id	String	Mustandi ID
drafts[].message	Object	Mustandi sõnumi eelvaade

---

📨 Saada Gmaili mustand

Saada olemasolev mustand oma Gmailist.

Konfiguratsioon

Väli	Tüüp	Kohustuslik	Kirjeldus
Mustandi ID	String	✅	Saadetav mustand

Väljundmuutujad

Muutuja	Tüüp	Kirjeldus
messageId	String	Saadetud sõnumi ID
threadId	String	Teema ID

---

🗑️ Kustuta Gmaili mustand

Kustuta mustand oma Gmaili kontolt.

Konfiguratsioon

Väli	Tüüp	Kohustuslik	Kirjeldus
Mustandi ID	String	✅	Kustutatav mustand

---

📂 Hangi e-posti teema

Tõsta esile täielik e-posti vestlusteema.

Konfiguratsioon

Väli	Tüüp	Kohustuslik	Kirjeldus
Teema ID	String	✅	Tõstetav teema

Väljundmuutujad

Muutuja	Tüüp	Kirjeldus
thread	Object	Täielik teema objekt
thread.id	String	Teema ID
thread.messages	Array	Kõik sõnumid teemas
thread.historyId	String	Ajaloo ID

Näide

Tegevus: Hangi e-posti teema
  Teema ID: "{{email.threadId}}"

---

Täielikud töövoo näited

Näide 1: AI e-posti assistent

Automaatne sissetulevate e-kirjade töötlemine ja AI genereeritud mustandvastuste loomine.

Gmail AI Mustand (Käivitaja)
    ↓
Hangi e-posti teema (Hangi täielik kontekst)
    ↓
AI Päring
  - Süsteem: "Sa oled abivalmis e-posti assistent"
  - Sisend: "{{thread.messages}}"
  - Väljund: Struktureeritud (vastus, meeleolu, kiireloomulisus)
    ↓
Kui tingimus: kiireloomulisus == "kõrge"
    ├── Jah: Saada Gmaili e-kiri (kohene vastus)
    └── Ei: Loo Gmaili mustand (ülevaatamiseks)

Näide 2: E-kirjade otsing ja töötlemine

Otsi konkreetseid e-kirju ja töötle neid massiliselt.

Ajastatud töövoog (Iga päev kell 9 hommikul)
    ↓
Otsi Gmaili e-kirju
  Küsitlus: "is:unread from:customers@* after:yesterday"
    ↓
Igaühe jaoks: e-kiri e-kirjades
    ↓
AI Päring (Kategooria e-kiri)
    ↓
Kui tingimus: kategooria == "tugi"
    └── Loo JIRA probleem

Näide 3: Mustandi ülevaatamise töövoog

Loo mustandid, lase inimestel üle vaadata, seejärel saada.

Gmail AI Mustand (Käivitaja)
    ↓
AI Päring (Genereeri vastus)
    ↓
Loo Gmaili mustand
    ↓
Saada Slacki sõnum
  "Uus mustand on ülevaatamiseks valmis {{email.from}}"

---

Parimad praktikad

1. Kasutage mustandirežiimi kriitiliste e-kirjade jaoks

Kliendiga seotud või tundlike e-kirjade puhul kasutage alati Loo Gmaili mustand asemel Saada Gmaili e-kiri. See võimaldab inimeste ülevaatust enne saatmist.

2. Kasutage teema konteksti

Kasutage Hangi e-posti teema enne vastamist, et tagada, et teie AI-l on täielik vestluse kontekst.

3. Rakendage määrangute piiramine

Gmailil on API kvoodid. Suure mahuga töövoogude jaoks:

• Lisage tegevuste vahele viivitusi
• Koguge toimingud, kui võimalik
• Jälgige oma kvoodi kasutust

4. Kasutage nutikaid otsingupäringuid

Kombineerige Gmaili päringu operaatorid täpseks filtreerimiseks:

from:vip-customer@* is:unread subject:(urgent OR critical) after:2025/01/01

5. Käsitlege vigu sujuvalt

Kasutage Kui tingimus sõlmi, et kontrollida vigu ja rakendada varu loogikat.

---

Seotud dokumentatsioon

• Gmaili kanali seadistamine
• Saada e-kirja tegevus (Üldine SMTP)
• AI päringu tegevus
• Kui tingimus
• SmartFlowi sissejuhatus