Gmail действия

Автоматизирайте вашите имейл работни потоци с обширни Gmail действия. Изпращайте имейли, управлявайте чернови, търсете в пощенската си кутия и обработвайте имейл нишки — всичко това в SmartFlow.

---

Предварителни условия

Преди да използвате Gmail действия, трябва да:

1. Свържете вашия Gmail акаунт в Канали → Gmail
2. Удостоверите необходимите разрешения чрез Google OAuth

Вижте Настройка на Gmail канал за подробни инструкции за свързване.

---

Налични тригери

📥 Gmail AI чернова

Тип тригер: CHAT_SERVICE

Тригерира се, когато потребител изпрати имейл до свързания си Gmail инстанс. Използвайте това, за да автоматично обработвате входящи имейли с AI.

Поле	Описание
Канал	Gmail
Събитие	Получен нов имейл

Примерен работен поток:

Gmail AI чернова (Триггер)
    ↓
AI Запитване (Анализиране на съдържанието на имейла)
    ↓
Създаване на Gmail чернова (Генериране на AI отговор)

---

Налични действия

Действие	Код	Описание
📤 Изпрати Gmail имейл	GMAIL_SEND_EMAIL	Изпратете нов имейл директно
📬 Прочетете Gmail имейли	GMAIL_READ_EMAILS	Извлечете имейли от пощенската си кутия
📧 Получете Gmail имейл	GMAIL_GET_EMAIL	Получете конкретен имейл по ID
↩️ Отговорете на Gmail имейл	GMAIL_REPLY	Отговорете на съществуваща имейл нишка
🔍 Търсете Gmail имейли	GMAIL_SEARCH	Търсете имейли с Gmail синтаксис за запитвания
✅ Маркирайте Gmail имейл като прочетен	GMAIL_MARK_READ	Маркирайте имейл като прочетен
📝 Създайте Gmail чернова	GMAIL_CREATE_DRAFT	Създайте нова имейл чернова
📋 Списък с Gmail чернови	GMAIL_LIST_DRAFTS	Списък на всички чернови в акаунта ви
📨 Изпратете Gmail чернова	GMAIL_SEND_DRAFT	Изпратете съществуваща чернова
🗑️ Изтрийте Gmail чернова	GMAIL_DELETE_DRAFT	Изтрийте чернова
📂 Получете имейл нишка	GMAIL_GET_THREAD	Извлечете пълния имейл разговор

---

📤 Изпрати Gmail имейл

Изпратете нов имейл директно от свързания си Gmail акаунт.

Конфигурация

Поле	Тип	Задължително	Описание
До	Имейл	✅	Имейл адрес на получателя
Тема	Стринг	✅	Заглавие на имейла
Съдържание	Стринг	✅	Съдържание на имейла (поддържа HTML)
Копие	Имейл	❌	Получатели на копие
Сляпо копие	Имейл	❌	Получатели на сляпо копие

Изходни променливи

Променлива	Тип	Описание
messageId	Стринг	Уникален ID на изпратения имейл
threadId	Стринг	ID на нишката за отговори

Пример

Действие: Изпрати Gmail имейл
  До: "{{customer_email}}"
  Тема: "Вашата поръчка #{{order_id}} е изпратена!"
  Съдържание: |
    Здравейте {{customer_name}},
    
    Отлични новини! Вашата поръчка е изпратена.
    
    Номер за проследяване: {{tracking_number}}
    
    С най-добри пожелания,
    Екипът

---

📬 Прочетете Gmail имейли

Извлечете последните имейли от пощенската си кутия с опционално филтриране.

Конфигурация

Поле	Тип	Задължително	Описание
Макс. резултати	Число	❌	Максимален брой имейли за извличане (по подразбиране: 10)
Етикет	Стринг	❌	Gmail етикет за филтриране (напр. "INBOX", "UNREAD")
Запитване	Стринг	❌	Gmail търсене

Изходни променливи

Променлива	Тип	Описание
emails	Масив	Списък на имейл обекти
emails[].id	Стринг	ID на имейла
emails[].subject	Стринг	Заглавие на имейла
emails[].from	Стринг	Имейл на подателя
emails[].snippet	Стринг	Преглед на имейла
emails[].date	Стринг	Дата на получаване

Пример

Действие: Прочетете Gmail имейли
  Макс. резултати: 5
  Етикет: "UNREAD"
  Запитване: "from:support@example.com"

---

📧 Получете Gmail имейл

Извлечете конкретен имейл по ID с пълно съдържание.

Конфигурация

Поле	Тип	Задължително	Описание
ID на имейл	Стринг	✅	ID на Gmail съобщението

Изходни променливи

Променлива	Тип	Описание
email	Обект	Пълен имейл обект
email.id	Стринг	ID на имейла
email.threadId	Стринг	ID на нишката
email.subject	Стринг	Заглавие на имейла
email.from	Стринг	Подател
email.to	Стринг	Получатели
email.body	Стринг	Пълно съдържание на имейла
email.date	Стринг	Дата на получаване
email.attachments	Масив	Списък на прикачени файлове

---

↩️ Отговорете на Gmail имейл

Отговорете на съществуващ имейл, запазвайки контекста на нишката.

Конфигурация

Поле	Тип	Задължително	Описание
ID на нишка	Стринг	✅	Нишката, на която да отговорите
ID на съобщение	Стринг	✅	Конкретното съобщение, на което да отговорите
Съдържание	Стринг	✅	Съдържание на отговора
Отговор на всички	Булев	❌	Отговорете на всички получатели (по подразбиране: false)

Изходни променливи

Променлива	Тип	Описание
messageId	Стринг	ID на отговора
threadId	Стринг	ID на нишката

Пример

Действие: Отговорете на Gmail имейл
  ID на нишка: "{{email.threadId}}"
  ID на съобщение: "{{email.id}}"
  Съдържание: |
    {{ai_response}}
    
    ---
    Това е отговор, подпомогнат от AI.

---

🔍 Търсете Gmail имейли

Търсете в Gmail, използвайки мощния синтаксис за запитвания на Gmail.

Конфигурация

Поле	Тип	Задължително	Описание
Запитване	Стринг	✅	Gmail търсене
Макс. резултати	Число	❌	Максимални резултати (по подразбиране: 10)

Синтаксис на Gmail запитвания

Запитване	Описание
from:email@example.com	Имейли от конкретен подател
to:email@example.com	Имейли до конкретен получател
subject:keyword	Заглавието съдържа ключова дума
is:unread	Само непрочетени имейли
is:starred	Звездни имейли
has:attachment	Имейли с прикачени файлове
after:2025/01/01	Имейли след дата
before:2025/12/31	Имейли преди дата
label:important	Имейли с етикет
"exact phrase"	Съвпадение на точна фраза

Пример

Действие: Търсете Gmail имейли
  Запитване: "from:{{customer_email}} is:unread subject:order"
  Макс. резултати: 5

---

✅ Маркирайте Gmail имейл като прочетен

Маркирайте имейл като прочетен в Gmail.

Конфигурация

Поле	Тип	Задължително	Описание
ID на имейл	Стринг	✅	Имейлът, който да маркирате като прочетен

Пример

Действие: Маркирайте Gmail имейл като прочетен
  ID на имейл: "{{email.id}}"

---

📝 Създайте Gmail чернова

Създайте чернова на имейл за преглед от човек преди изпращане.

Конфигурация

Поле	Тип	Задължително	Описание
До	Имейл	✅	Имейл на получателя
Тема	Стринг	✅	Заглавие на имейла
Съдържание	Стринг	✅	Съдържание на имейла
Копие	Имейл	❌	Копие
Сляпо копие	Имейл	❌	Сляпо копие
ID на нишка	Стринг	❌	За отговори на чернови

Изходни променливи

Променлива	Тип	Описание
draftId	Стринг	ID на създадената чернова
messageId	Стринг	ID на съобщението

Случай на употреба: Режим на AI чернова

Триггер: Gmail AI чернова
    ↓
AI Запитване:
  Подсказка: "Генерирайте професионален отговор на този имейл"
  Вход: "{{email.body}}"
    ↓
Създаване на Gmail чернова:
  До: "{{email.from}}"
  Тема: "Re: {{email.subject}}"
  Съдържание: "{{ai_response}}"

---

📋 Списък с Gmail чернови

Извлечете всички чернови от вашия Gmail акаунт.

Конфигурация

Поле	Тип	Задължително	Описание
Макс. резултати	Число	❌	Максимален брой чернови за списък

Изходни променливи

Променлива	Тип	Описание
drafts	Масив	Списък на чернови обекти
drafts[].id	Стринг	ID на черновата
drafts[].message	Обект	Преглед на черновото съобщение

---

📨 Изпрати чернова на Gmail

Изпратете съществуваща чернова от вашия Gmail.

Конфигурация

Поле	Тип	Задължително	Описание
ID на черновата	Стринг	✅	Черновата, която да се изпрати

Изходни променливи

Променлива	Тип	Описание
messageId	Стринг	ID на изпратеното съобщение
threadId	Стринг	ID на нишката

---

🗑️ Изтрий чернова на Gmail

Изтрийте чернова от вашия Gmail акаунт.

Конфигурация

Поле	Тип	Задължително	Описание
ID на черновата	Стринг	✅	Черновата, която да се изтрие

---

📂 Вземи нишка на имейл

Вземете пълна нишка на имейл разговор.

Конфигурация

Поле	Тип	Задължително	Описание
ID на нишката	Стринг	✅	Нишката, която да се вземе

Изходни променливи

Променлива	Тип	Описание
thread	Обект	Пълен обект на нишката
thread.id	Стринг	ID на нишката
thread.messages	Масив	Всички съобщения в нишката
thread.historyId	Стринг	ID на историята

Пример

Action: Get Email Thread
  Thread ID: "{{email.threadId}}"

---

Примери за завършени работни потоци

Пример 1: AI имейл асистент

Автоматично обработвайте входящи имейли и създавайте чернови отговори, генерирани от AI.

Gmail AI Draft (Trigger)
    ↓
Get Email Thread (Get full context)
    ↓
AI Request
  - System: "You are a helpful email assistant"
  - Input: "{{thread.messages}}"
  - Output: Structured (response, sentiment, urgency)
    ↓
If Condition: urgency == "high"
    ├── Yes: Send Gmail Email (immediate response)
    └── No: Create Gmail Draft (for review)

Пример 2: Търсене и обработка на имейли

Търсете конкретни имейли и ги обработвайте на партиди.

Scheduled Workflow (Daily at 9 AM)
    ↓
Search Gmail Emails
  Query: "is:unread from:customers@* after:yesterday"
    ↓
For Each: email in emails
    ↓
AI Request (Categorize email)
    ↓
If Condition: category == "support"
    └── Create JIRA Issue

Пример 3: Работен поток за преглед на чернови

Създавайте чернови, позволявайте на хората да преглеждат, след което изпращайте.

Gmail AI Draft (Trigger)
    ↓
AI Request (Generate response)
    ↓
Create Gmail Draft
    ↓
Send Slack Message
  "New draft ready for review from {{email.from}}"

---

Най-добри практики

1. Използвайте режим на чернова за критични имейли

За имейли, насочени към клиенти или чувствителни имейли, винаги използвайте Create Gmail Draft вместо Send Gmail Email. Това позволява човешки преглед преди изпращане.

2. Използвайте контекста на нишката

Използвайте Get Email Thread преди да отговорите, за да сте сигурни, че вашият AI има пълен контекст на разговора.

3. Прилагане на ограничаване на скоростта

Gmail има квоти за API. За работни потоци с висока натовареност:

• Добавете закъснения между действията
• Обединявайте операции, когато е възможно
• Следете използването на вашата квота

4. Използвайте умни търсения

Комбинирайте оператори за търсене на Gmail за прецизно филтриране:

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

5. Обработвайте грешките учтиво

Използвайте If Condition възли, за да проверите за грешки и да приложите резервна логика.

---

Свързана документация

• Настройка на канала на Gmail
• Действие за изпращане на имейл (Общ SMTP)
• Действие за AI заявка
• Ако условие
• Въведение в SmartFlow