Gmail Actions

Automatizați fluxurile de lucru prin email cu acțiuni cuprinzătoare Gmail. Trimiteți emailuri, gestionați schițele, căutați în inbox și gestionați conversațiile de email — toate acestea în cadrul SmartFlow.

---

Prerequisites

Înainte de a utiliza acțiunile Gmail, trebuie să:

1. Conectați contul dvs. Gmail în Channels → Gmail
2. Autorizați permisiunile necesare prin Google OAuth

Consultați Gmail Channel Setup pentru instrucțiuni detaliate de conectare.

---

Available Triggers

📥 Gmail AI Draft

Trigger Type: CHAT_SERVICE

Declanșat atunci când un utilizator trimite un email către instanța dvs. Gmail conectată. Utilizați acest lucru pentru a procesa automat emailurile primite cu AI.

Field	Description
Channel	Gmail
Event	Email nou primit

Example Workflow:

Gmail AI Draft (Trigger)
    ↓
AI Request (Analyze email content)
    ↓
Create Gmail Draft (Generate AI response)

---

Available Actions

Action	Code	Description
📤 Send Gmail Email	GMAIL_SEND_EMAIL	Trimiteți un email nou direct
📬 Read Gmail Emails	GMAIL_READ_EMAILS	Recuperați emailuri din inbox-ul dvs.
📧 Get Gmail Email	GMAIL_GET_EMAIL	Obțineți un email specific după ID
↩️ Reply to Gmail Email	GMAIL_REPLY	Răspundeți la o conversație de email existentă
🔍 Search Gmail Emails	GMAIL_SEARCH	Căutați emailuri folosind sintaxa de interogare Gmail
✅ Mark Gmail Email as Read	GMAIL_MARK_READ	Marcați un email ca citit
📝 Create Gmail Draft	GMAIL_CREATE_DRAFT	Creați o nouă schiță de email
📋 List Gmail Drafts	GMAIL_LIST_DRAFTS	Listați toate schițele din contul dvs.
📨 Send Gmail Draft	GMAIL_SEND_DRAFT	Trimiteți o schiță existentă
🗑️ Delete Gmail Draft	GMAIL_DELETE_DRAFT	Ștergeți o schiță
📂 Get Email Thread	GMAIL_GET_THREAD	Recuperați întreaga conversație de email

---

📤 Send Gmail Email

Trimiteți un email nou direct din contul dvs. Gmail conectat.

Configuration

Field	Type	Required	Description
To	Email	✅	Adresa de email a destinatarului
Subject	String	✅	Linia de subiect a emailului
Body	String	✅	Conținutul emailului (HTML acceptat)
CC	Email	❌	Destinatari în carbon copy
BCC	Email	❌	Destinatari în carbon copy ascuns

Output Variables

Variable	Type	Description
messageId	String	ID-ul unic al emailului trimis
threadId	String	ID-ul conversației pentru răspunsuri

Example

Action: Send Gmail Email
  To: "{{customer_email}}"
  Subject: "Comanda dvs. #{{order_id}} a fost expediată!"
  Body: |
    Bună {{customer_name}},
    
    Vești grozave! Comanda dvs. a fost expediată.
    
    Numărul de urmărire: {{tracking_number}}
    
    Cu cele mai bune gânduri,
    Echipa

---

📬 Read Gmail Emails

Recuperați emailuri recente din inbox-ul dvs. cu filtrare opțională.

Configuration

Field	Type	Required	Description
Max Results	Number	❌	Numărul maxim de emailuri de recuperat (implicit: 10)
Label	String	❌	Eticheta Gmail pentru filtrare (de exemplu, "INBOX", "UNREAD")
Query	String	❌	Interogarea de căutare Gmail

Output Variables

Variable	Type	Description
emails	Array	Lista obiectelor email
emails[].id	String	ID-ul emailului
emails[].subject	String	Subiectul emailului
emails[].from	String	Emailul expeditorului
emails[].snippet	String	Previzualizarea emailului
emails[].date	String	Data primirii

Example

Action: Read Gmail Emails
  Max Results: 5
  Label: "UNREAD"
  Query: "from:support@example.com"

---

📧 Get Gmail Email

Recuperați un email specific după ID-ul său cu conținut complet.

Configuration

Field	Type	Required	Description
Email ID	String	✅	ID-ul mesajului Gmail

Output Variables

Variable	Type	Description
email	Object	Obiectul email complet
email.id	String	ID-ul emailului
email.threadId	String	ID-ul conversației
email.subject	String	Subiectul emailului
email.from	String	Expeditorul
email.to	String	Destinatarii
email.body	String	Corpul complet al emailului
email.date	String	Data primirii
email.attachments	Array	Lista atașamentelor

---

↩️ Reply to Gmail Email

Răspundeți la un email existent, menținând contextul conversației.

Configuration

Field	Type	Required	Description
Thread ID	String	✅	Conversația la care se răspunde
Message ID	String	✅	Mesajul specific la care se răspunde
Body	String	✅	Conținutul răspunsului
Reply All	Boolean	❌	Răspundeți tuturor destinatarilor (implicit: false)

Output Variables

Variable	Type	Description
messageId	String	ID-ul răspunsului
threadId	String	ID-ul conversației

Example

Action: Reply to Gmail Email
  Thread ID: "{{email.threadId}}"
  Message ID: "{{email.id}}"
  Body: |
    {{ai_response}}
    
    ---
    Acesta este un răspuns asistat de AI.

---

🔍 Search Gmail Emails

Căutați în Gmail folosind sintaxa puternică de interogare Gmail.

Configuration

Field	Type	Required	Description
Query	String	✅	Interogarea de căutare Gmail
Max Results	Number	❌	Rezultate maxime (implicit: 10)

Gmail Query Syntax

Query	Description
from:email@example.com	Emailuri de la un expeditor specific
to:email@example.com	Emailuri către un destinatar specific
subject:keyword	Subiectul conține cuvântul cheie
is:unread	Numai emailuri necitite
is:starred	Emailuri marcate
has:attachment	Emailuri cu atașamente
after:2025/01/01	Emailuri după dată
before:2025/12/31	Emailuri înainte de dată
label:important	Emailuri cu eticheta
"exact phrase"	Potrivire exactă a frazei

Example

Action: Search Gmail Emails
  Query: "from:{{customer_email}} is:unread subject:order"
  Max Results: 5

---

✅ Mark Gmail Email as Read

Marcați un email ca citit în Gmail.

Configuration

Field	Type	Required	Description
Email ID	String	✅	Emailul de marcat ca citit

Example

Action: Mark Gmail Email as Read
  Email ID: "{{email.id}}"

---

📝 Create Gmail Draft

Creați un email schiță pentru revizuirea umană înainte de a trimite.

Configuration

Field	Type	Required	Description
To	Email	✅	Emailul destinatarului
Subject	String	✅	Subiectul emailului
Body	String	✅	Conținutul emailului
CC	Email	❌	Carbon copy
BCC	Email	❌	Carbon copy ascuns
Thread ID	String	❌	Pentru răspunsurile la schiță

Output Variables

Variable	Type	Description
draftId	String	ID-ul schiței create
messageId	String	ID-ul mesajului

Use Case: AI Draft Mode

Trigger: Gmail AI Draft
    ↓
AI Request:
  Prompt: "Generați un răspuns profesional la acest email"
  Input: "{{email.body}}"
    ↓
Create Gmail Draft:
  To: "{{email.from}}"
  Subject: "Re: {{email.subject}}"
  Body: "{{ai_response}}"

---

📋 List Gmail Drafts

Recuperați toate schițele din contul dvs. Gmail.

Configuration

Field	Type	Required	Description
Max Results	Number	❌	Numărul maxim de schițe de listat

Output Variables

Variable	Type	Description
drafts	Array	Lista obiectelor schiță
drafts[].id	String	ID-ul schiței
drafts[].message	Object	Previziunea mesajului schiță

---

📨 Trimite Schiță Gmail

Trimite o schiță existentă din Gmail-ul tău.

Configurare

Câmp	Tip	Necesare	Descriere
ID Schiță	String	✅	Schița de trimis

Variabile de Ieșire

Variabilă	Tip	Descriere
messageId	String	ID-ul mesajului trimis
threadId	String	ID-ul firului de discuție

---

🗑️ Șterge Schiță Gmail

Șterge o schiță din contul tău Gmail.

Configurare

Câmp	Tip	Necesare	Descriere
ID Schiță	String	✅	Schița de șters

---

📂 Obține Fir de Email

Recuperează un fir complet de conversație prin email.

Configurare

Câmp	Tip	Necesare	Descriere
ID Fir	String	✅	Firul de recuperat

Variabile de Ieșire

Variabilă	Tip	Descriere
thread	Object	Obiectul complet al firului
thread.id	String	ID-ul firului
thread.messages	Array	Toate mesajele din fir
thread.historyId	String	ID-ul istoricului

Exemplu

Acțiune: Obține Fir de Email
  ID Fir: "{{email.threadId}}"

---

Exemple Complete de Flux de Lucru

Exemplu 1: Asistent Email AI

Procesează automat emailurile primite și creează răspunsuri generate de AI.

Schiță Gmail AI (Declanșator)
    ↓
Obține Fir de Email (Obține contextul complet)
    ↓
Cerere AI
  - Sistem: "Ești un asistent de email util"
  - Intrare: "{{thread.messages}}"
  - Ieșire: Structurat (răspuns, sentiment, urgență)
    ↓
Dacă Condiție: urgență == "ridicată"
    ├── Da: Trimite Email Gmail (răspuns imediat)
    └── Nu: Creează Schiță Gmail (pentru revizuire)

Exemplu 2: Căutare și Procesare Email

Caută emailuri specifice și procesează-le în masă.

Flux de Lucru Programat (Zilnic la 9 AM)
    ↓
Caută Emailuri Gmail
  Interogare: "is:necitit from:customers@* after:yesterday"
    ↓
Pentru Fiecare: email în emailuri
    ↓
Cerere AI (Categorizează emailul)
    ↓
Dacă Condiție: categorie == "suport"
    └── Creează Problemă JIRA

Exemplu 3: Flux de Revizuire a Schițelor

Creează schițe, lasă oamenii să le revizuiască, apoi trimite.

Schiță Gmail AI (Declanșator)
    ↓
Cerere AI (Generează răspuns)
    ↓
Creează Schiță Gmail
    ↓
Trimite Mesaj Slack
  "Nouă schiță gata pentru revizuire de la {{email.from}}"

---

Cele Mai Bune Practici

1. Folosește Modul Schiță pentru Emailuri Critice

Pentru emailuri destinate clienților sau sensibile, folosește întotdeauna Creează Schiță Gmail în loc de Trimite Email Gmail. Acest lucru permite revizuirea umană înainte de trimitere.

2. Valorifică Contextul Firului

Folosește Obține Fir de Email înainte de a răspunde pentru a te asigura că AI-ul tău are contextul complet al conversației.

3. Implementați Limitarea Ratelor

Gmail are cote API. Pentru fluxuri de lucru cu volum mare:

• Adaugă întârzieri între acțiuni
• Grupuie operațiunile când este posibil
• Monitorizează utilizarea cotei tale

4. Folosește Interogări de Căutare Inteligente

Combină operatorii de interogare Gmail pentru filtrare precisă:

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

5. Gestionează Erorile cu Grație

Folosește noduri Dacă Condiție pentru a verifica erorile și a implementa logică de rezervă.

---

Documentație Asociată

• Configurarea Canalului Gmail
• Acțiunea Trimite Email (SMTP generic)
• Acțiunea Cerere AI
• Dacă Condiție
• Introducere în SmartFlow