Gmail Akcije

Automatizirajte svoje e-mail radne tokove s opsežnim Gmail akcijama. Šaljite e-mailove, upravljajte nacrtima, pretražujte svoju pristiglu poštu i rukujte e-mail threadovima — sve unutar SmartFlow.

---

Preduvjeti

Prije korištenja Gmail akcija, morate:

1. Povezati svoj Gmail račun u Kanali → Gmail
2. Ovlastiti potrebne dozvole putem Google OAuth

Pogledajte Postavke Gmail Kanala za detaljne upute o povezivanju.

---

Dostupni Okidači

📥 Gmail AI Nacrt

Tip Okidača: CHAT_SERVICE

Aktivira se kada korisnik pošalje e-mail na vašu povezanu Gmail instancu. Koristite ovo za automatsku obradu dolaznih e-mailova s AI.

Polje	Opis
Kanal	Gmail
Događaj	Novi e-mail primljen

Primjer Radnog Toka:

Gmail AI Nacrt (Okidač)
    ↓
AI Zahtjev (Analiziraj sadržaj e-maila)
    ↓
Kreiraj Gmail Nacrt (Generiraj AI odgovor)

---

Dostupne Akcije

Akcija	Kod	Opis
📤 Pošalji Gmail E-mail	GMAIL_SEND_EMAIL	Pošaljite novi e-mail izravno
📬 Pročitaj Gmail E-mailove	GMAIL_READ_EMAILS	Dohvati e-mailove iz svoje pristigle pošte
📧 Dohvati Gmail E-mail	GMAIL_GET_EMAIL	Dohvati određeni e-mail prema ID-u
↩️ Odgovori na Gmail E-mail	GMAIL_REPLY	Odgovori na postojeći e-mail thread
🔍 Pretraži Gmail E-mailove	GMAIL_SEARCH	Pretraži e-mailove s Gmail sintaksom upita
✅ Označi Gmail E-mail kao Pročitan	GMAIL_MARK_READ	Označi e-mail kao pročitan
📝 Kreiraj Gmail Nacrt	GMAIL_CREATE_DRAFT	Kreiraj novi nacrt e-maila
📋 Popis Gmail Nacrta	GMAIL_LIST_DRAFTS	Popis svih nacrta u vašem računu
📨 Pošalji Gmail Nacrt	GMAIL_SEND_DRAFT	Pošaljite postojeći nacrt
🗑️ Izbriši Gmail Nacrt	GMAIL_DELETE_DRAFT	Izbriši nacrt
📂 Dohvati E-mail Thread	GMAIL_GET_THREAD	Dohvati cijeli e-mail razgovor

---

📤 Pošalji Gmail E-mail

Pošaljite novi e-mail izravno sa svog povezanog Gmail računa.

Konfiguracija

Polje	Tip	Obavezno	Opis
Za	E-mail	✅	Adresa e-pošte primatelja
Predmet	String	✅	Naslov e-maila
Tijelo	String	✅	Sadržaj e-maila (HTML podržan)
CC	E-mail	❌	Primatelji u kopiji
BCC	E-mail	❌	Primatelji u slijepoj kopiji

Izlazne Varijable

Varijabla	Tip	Opis
messageId	String	Jedinstveni ID poslanog e-maila
threadId	String	ID threada za odgovore

Primjer

Akcija: Pošalji Gmail E-mail
  Za: "{{customer_email}}"
  Predmet: "Vaša narudžba #{{order_id}} je otpremljena!"
  Tijelo: |
    Pozdrav {{customer_name}},
    
    Sjajne vijesti! Vaša narudžba je otpremljena.
    
    Broj za praćenje: {{tracking_number}}
    
    Srdačan pozdrav,
    Tim

---

📬 Pročitaj Gmail E-mailove

Dohvatite nedavne e-mailove iz svoje pristigle pošte s opcionalnim filtriranjem.

Konfiguracija

Polje	Tip	Obavezno	Opis
Maksimalni Rezultati	Broj	❌	Maksimalan broj e-mailova za dohvat (zadano: 10)
Oznaka	String	❌	Gmail oznaka za filtriranje (npr., "INBOX", "UNREAD")
Upit	String	❌	Gmail pretraživački upit

Izlazne Varijable

Varijabla	Tip	Opis
emails	Niz	Popis objekata e-mailova
emails[].id	String	ID e-maila
emails[].subject	String	Predmet e-maila
emails[].from	String	E-mail pošiljatelja
emails[].snippet	String	Pregled e-maila
emails[].date	String	Datum primitka

Primjer

Akcija: Pročitaj Gmail E-mailove
  Maksimalni Rezultati: 5
  Oznaka: "UNREAD"
  Upit: "from:[email protected]"

---

📧 Dohvati Gmail E-mail

Dohvatite određeni e-mail prema njegovom ID-u s punim sadržajem.

Konfiguracija

Polje	Tip	Obavezno	Opis
ID E-maila	String	✅	Gmail ID poruke

Izlazne Varijable

Varijabla	Tip	Opis
email	Objekt	Cijeli objekt e-maila
email.id	String	ID e-maila
email.threadId	String	ID threada
email.subject	String	Predmet e-maila
email.from	String	Pošiljatelj
email.to	String	Primatelji
email.body	String	Cijelo tijelo e-maila
email.date	String	Datum primitka
email.attachments	Niz	Popis privitaka

---

↩️ Odgovori na Gmail E-mail

Odgovorite na postojeći e-mail, zadržavajući kontekst thread-a.

Konfiguracija

Polje	Tip	Obavezno	Opis
ID Threada	String	✅	Thread na koji se odgovara
ID Poruke	String	✅	Određena poruka na koju se odgovara
Tijelo	String	✅	Sadržaj odgovora
Odgovori Svim	Boolean	❌	Odgovori svim primateljima (zadano: false)

Izlazne Varijable

Varijabla	Tip	Opis
messageId	String	ID odgovora
threadId	String	ID threada

Primjer

Akcija: Odgovori na Gmail E-mail
  ID Threada: "{{email.threadId}}"
  ID Poruke: "{{email.id}}"
  Tijelo: |
    {{ai_response}}
    
    ---
    Ovo je odgovor uz pomoć AI.

---

🔍 Pretraži Gmail E-mailove

Pretražujte svoj Gmail koristeći moćnu sintaksu upita Gmail-a.

Konfiguracija

Polje	Tip	Obavezno	Opis
Upit	String	✅	Gmail pretraživački upit
Maksimalni Rezultati	Broj	❌	Maksimalni rezultati (zadano: 10)

Gmail Sintaksa Upita

Upit	Opis
from:[email protected]	E-mailovi od određenog pošiljatelja
to:[email protected]	E-mailovi za određenog primatelja
subject:keyword	Predmet sadrži ključnu riječ
is:unread	Samo nepročitani e-mailovi
is:starred	Označeni e-mailovi
has:attachment	E-mailovi s privicima
after:2025/01/01	E-mailovi nakon datuma
before:2025/12/31	E-mailovi prije datuma
label:important	E-mailovi s oznakom
"točna fraza"	Podudaranje točne fraze

Primjer

Akcija: Pretraži Gmail E-mailove
  Upit: "from:{{customer_email}} is:unread subject:order"
  Maksimalni Rezultati: 5

---

✅ Označi Gmail E-mail kao Pročitan

Označite e-mail kao pročitan u Gmail-u.

Konfiguracija

Polje	Tip	Obavezno	Opis
ID E-maila	String	✅	E-mail koji treba označiti kao pročitan

Primjer

Akcija: Označi Gmail E-mail kao Pročitan
  ID E-maila: "{{email.id}}"

---

📝 Kreiraj Gmail Nacrt

Kreirajte nacrt e-maila za ljudsku provjeru prije slanja.

Konfiguracija

Polje	Tip	Obavezno	Opis
Za	E-mail	✅	E-mail primatelja
Predmet	String	✅	Predmet e-maila
Tijelo	String	✅	Sadržaj e-maila
CC	E-mail	❌	Kopija
BCC	E-mail	❌	Slijepa kopija
ID Threada	String	❌	Za odgovore na nacrte

Izlazne Varijable

Varijabla	Tip	Opis
draftId	String	ID kreiranog nacrta
messageId	String	ID poruke

Korisnički slučaj: AI Nacrt Mod

Okidač: Gmail AI Nacrt
    ↓
AI Zahtjev:
  Upit: "Generiraj profesionalni odgovor na ovaj e-mail"
  Ulaz: "{{email.body}}"
    ↓
Kreiraj Gmail Nacrt:
  Za: "{{email.from}}"
  Predmet: "Re: {{email.subject}}"
  Tijelo: "{{ai_response}}"

---

📋 Popis Gmail Nacrta

Dohvatite sve nacrte iz svog Gmail računa.

Konfiguracija

Polje	Tip	Obavezno	Opis
Maksimalni Rezultati	Broj	❌	Maksimalni nacrti za popis

Izlazne Varijable

Varijabla	Tip	Opis
drafts	Niz	Popis objekata nacrta
drafts[].id	String	ID nacrta
drafts[].message	Objekt	Pregled nacrta poruke

---

📨 Pošaljite Gmail Nacrt

Pošaljite postojeći nacrt iz vašeg Gmaila.

Konfiguracija

Polje	Tip	Obavezno	Opis
ID Nacrta	String	✅	Nacrt koji treba poslati

Izlazne Varijable

Varijabla	Tip	Opis
messageId	String	ID poslane poruke
threadId	String	ID niti

---

🗑️ Izbrišite Gmail Nacrt

Izbrišite nacrt iz svog Gmail računa.

Konfiguracija

Polje	Tip	Obavezno	Opis
ID Nacrta	String	✅	Nacrt koji treba izbrisati

---

📂 Dohvati Email Nit

Dohvatite cijeli razgovor putem e-pošte.

Konfiguracija

Polje	Tip	Obavezno	Opis
ID Niti	String	✅	Nit koju treba dohvatiti

Izlazne Varijable

Varijabla	Tip	Opis
thread	Object	Cjeli objekt niti
thread.id	String	ID niti
thread.messages	Array	Sve poruke u niti
thread.historyId	String	ID povijesti

Primjer

Akcija: Dohvati Email Nit
  ID Niti: "{{email.threadId}}"

---

Primjeri Cjelokupnog Radnog Toka

Primjer 1: AI Email Asistent

Automatski obradite dolazne e-pošte i kreirajte AI-generirane nacrte odgovora.

Gmail AI Nacrt (Okidač)
    ↓
Dohvati Email Nit (Dohvati puni kontekst)
    ↓
AI Zahtjev
  - Sustav: "Vi ste korisni asistent za e-poštu"
  - Ulaz: "{{thread.messages}}"
  - Izlaz: Strukturirano (odgovor, sentiment, hitnost)
    ↓
Ako Uvjet: hitnost == "visoka"
    ├── Da: Pošalji Gmail Email (odgovor odmah)
    └── Ne: Kreiraj Gmail Nacrt (za pregled)

Primjer 2: Pretraživanje i Obrada E-pošte

Pretražite specifične e-pošte i obradite ih u velikim količinama.

Zakazani Radni Tok (Dnevno u 9 ujutro)
    ↓
Pretraži Gmail E-pošte
  Upit: "is:nepročitano from:customers@* after:yesterday"
    ↓
Za Svaku: email u e-poštama
    ↓
AI Zahtjev (Kategoriziraj e-poštu)
    ↓
Ako Uvjet: kategorija == "podrška"
    └── Kreiraj JIRA Problem

Primjer 3: Radni Tok Pregleda Nacrta

Kreirajte nacrte, dopustite ljudima da pregledaju, a zatim pošaljite.

Gmail AI Nacrt (Okidač)
    ↓
AI Zahtjev (Generiraj odgovor)
    ↓
Kreiraj Gmail Nacrt
    ↓
Pošalji Slack Poruku
  "Novi nacrt spreman za pregled od {{email.from}}"

---

Najbolje Prakse

1. Koristite Način Nacrta za Kritične E-pošte

Za e-pošte koje su usmjerene prema kupcima ili osjetljive, uvijek koristite Kreiraj Gmail Nacrt umjesto Pošalji Gmail Email. To omogućava ljudski pregled prije slanja.

2. Iskoristite Kontekst Niti

Koristite Dohvati Email Nit prije odgovaranja kako biste osigurali da vaš AI ima puni kontekst razgovora.

3. Implementirajte Ograničenje Brzine

Gmail ima API kvote. Za radne tokove s velikim volumenom:

• Dodajte kašnjenja između akcija
• Grupirajte operacije kada je to moguće
• Pratite korištenje svoje kvote

4. Koristite Pametne Upite za Pretraživanje

Kombinirajte Gmail operatore upita za precizno filtriranje:

from:vip-customer@* is:nepročitano subject:(hitno OR kritično) after:2025/01/01

5. Rukujte Pogreškama Sposobno

Koristite Ako Uvjet čvorove za provjeru pogrešaka i implementirajte logiku povratka.

---

Povezana Dokumentacija

• Postavke Gmail Kanala
• Akcija Slanja E-pošte (Generički SMTP)
• Akcija AI Zahtjeva
• Ako Uvjet
• Uvod u SmartFlow