انتقل إلى المحتوى الرئيسي

إجراءات Gmail

قم بأتمتة سير العمل الخاص بالبريد الإلكتروني الخاص بك مع إجراءات Gmail الشاملة. أرسل رسائل البريد الإلكتروني، وأدر المسودات، وابحث في صندوق الوارد الخاص بك، وتناول سلاسل البريد الإلكتروني - كل ذلك ضمن SmartFlow.

إجراءات Gmail SmartFlow

المتطلبات الأساسية​

قبل استخدام إجراءات Gmail، يجب عليك:

  1. ربط حساب Gmail الخاص بك في القنوات → Gmail
  2. تفويض الأذونات المطلوبة عبر Google OAuth

راجع إعداد قناة Gmail للحصول على تعليمات الاتصال التفصيلية.

المشغلات المتاحة​

📥 مسودة Gmail AI​

نوع المشغل: CHAT_SERVICE

يتم تفعيله عندما يرسل المستخدم بريدًا إلكترونيًا إلى مثيل Gmail المتصل الخاص بك. استخدم هذا لمعالجة رسائل البريد الواردة تلقائيًا باستخدام الذكاء الاصطناعي.

الحقلالوصف
القناةGmail
الحدثتم استلام بريد إلكتروني جديد

مثال على سير العمل:

مسودة Gmail AI (المشغل)
    ↓
طلب AI (تحليل محتوى البريد الإلكتروني)
    ↓
إنشاء مسودة Gmail (توليد رد AI)

الإجراءات المتاحة​

الإجراءالرمزالوصف
📤 إرسال بريد GmailGMAIL_SEND_EMAILأرسل بريدًا إلكترونيًا جديدًا مباشرة
📬 قراءة رسائل GmailGMAIL_READ_EMAILSاسترجع رسائل البريد الإلكتروني من صندوق الوارد الخاص بك
📧 الحصول على بريد GmailGMAIL_GET_EMAILاحصل على بريد إلكتروني محدد بواسطة ID
↩️ الرد على بريد GmailGMAIL_REPLYالرد على سلسلة بريد إلكتروني موجودة
🔍 البحث في رسائل GmailGMAIL_SEARCHابحث عن رسائل البريد الإلكتروني باستخدام صيغة استعلام Gmail
✅ تحديد بريد Gmail كـ مقروءGMAIL_MARK_READحدد بريدًا إلكترونيًا كمقروء
📝 إنشاء مسودة GmailGMAIL_CREATE_DRAFTإنشاء مسودة بريد إلكتروني جديدة
📋 قائمة مسودات GmailGMAIL_LIST_DRAFTSعرض جميع المسودات في حسابك
📨 إرسال مسودة GmailGMAIL_SEND_DRAFTإرسال مسودة موجودة
🗑️ حذف مسودة GmailGMAIL_DELETE_DRAFTحذف مسودة
📂 الحصول على سلسلة البريد الإلكترونيGMAIL_GET_THREADاسترجاع المحادثة الكاملة للبريد الإلكتروني

📤 إرسال بريد Gmail​

أرسل بريدًا إلكترونيًا جديدًا مباشرة من حساب Gmail المتصل الخاص بك.

التكوين​

الحقلالنوعمطلوبالوصف
إلىبريد إلكتروني✅عنوان البريد الإلكتروني للمتلقي
الموضوعسلسلة✅سطر موضوع البريد الإلكتروني
المحتوىسلسلة✅محتوى البريد الإلكتروني (يدعم HTML)
نسخة كربونيةبريد إلكتروني❌المستلمين في النسخة الكربونية
نسخة كربونية مخفيةبريد إلكتروني❌المستلمين في النسخة الكربونية المخفية

متغيرات الإخراج​

المتغيرالنوعالوصف
messageIdسلسلةمعرف فريد للبريد الإلكتروني المرسل
threadIdسلسلةمعرف السلسلة للردود

مثال​

الإجراء: إرسال بريد Gmail
  إلى: "{{customer_email}}"
  الموضوع: "تم شحن طلبك #{{order_id}}!"
  المحتوى: |
    مرحبًا {{customer_name}},
    
    أخبار رائعة! تم شحن طلبك.
    
    رقم التتبع: {{tracking_number}}
    
    مع أطيب التحيات،
    الفريق

📬 قراءة رسائل Gmail​

استرجع رسائل البريد الإلكتروني الحديثة من صندوق الوارد الخاص بك مع خيارات تصفية اختيارية.

التكوين​

الحقلالنوعمطلوبالوصف
الحد الأقصى من النتائجرقم❌الحد الأقصى لعدد رسائل البريد الإلكتروني لاسترجاعها (افتراضي: 10)
التسميةسلسلة❌تسمية Gmail للتصفية (مثل "INBOX"، "UNREAD")
الاستعلامسلسلة❌استعلام بحث Gmail

متغيرات الإخراج​

المتغيرالنوعالوصف
emailsمصفوفةقائمة كائنات البريد الإلكتروني
emails[].idسلسلةمعرف البريد الإلكتروني
emails[].subjectسلسلةموضوع البريد الإلكتروني
emails[].fromسلسلةبريد المرسل
emails[].snippetسلسلةمعاينة البريد الإلكتروني
emails[].dateسلسلةتاريخ الاستلام

مثال​

الإجراء: قراءة رسائل Gmail
  الحد الأقصى من النتائج: 5
  التسمية: "UNREAD"
  الاستعلام: "from:[email protected]"

📧 الحصول على بريد Gmail​

استرجع بريدًا إلكترونيًا محددًا بواسطة معرفه مع المحتوى الكامل.

التكوين​

الحقلالنوعمطلوبالوصف
معرف البريد الإلكترونيسلسلة✅معرف رسالة Gmail

متغيرات الإخراج​

المتغيرالنوعالوصف
emailكائنكائن البريد الإلكتروني الكامل
email.idسلسلةمعرف البريد الإلكتروني
email.threadIdسلسلةمعرف السلسلة
email.subjectسلسلةموضوع البريد الإلكتروني
email.fromسلسلةالمرسل
email.toسلسلةالمستلمون
email.bodyسلسلةالمحتوى الكامل للبريد الإلكتروني
email.dateسلسلةتاريخ الاستلام
email.attachmentsمصفوفةقائمة المرفقات

↩️ الرد على بريد Gmail​

رد على بريد إلكتروني موجود، مع الحفاظ على سياق السلسلة.

التكوين​

الحقلالنوعمطلوبالوصف
معرف السلسلةسلسلة✅السلسلة التي سيتم الرد عليها
معرف الرسالةسلسلة✅الرسالة المحددة التي سيتم الرد عليها
المحتوىسلسلة✅محتوى الرد
رد على الجميعمنطقي❌الرد على جميع المستلمين (افتراضي: false)

متغيرات الإخراج​

المتغيرالنوعالوصف
messageIdسلسلةمعرف الرد
threadIdسلسلةمعرف السلسلة

مثال​

الإجراء: الرد على بريد Gmail
  معرف السلسلة: "{{email.threadId}}"
  معرف الرسالة: "{{email.id}}"
  المحتوى: |
    {{ai_response}}
    
    ---
    هذا رد مدعوم بالذكاء الاصطناعي.

🔍 البحث في رسائل Gmail​

ابحث في Gmail الخاص بك باستخدام صيغة الاستعلام القوية الخاصة بـ Gmail.

التكوين​

الحقلالنوعمطلوبالوصف
الاستعلامسلسلة✅استعلام بحث Gmail
الحد الأقصى من النتائجرقم❌الحد الأقصى من النتائج (افتراضي: 10)

صيغة استعلام Gmail​

الاستعلامالوصف
from:[email protected]رسائل البريد الإلكتروني من مرسل محدد
to:[email protected]رسائل البريد الإلكتروني إلى مستلم محدد
subject:keywordالموضوع يحتوي على الكلمة الرئيسية
is:unreadرسائل البريد الإلكتروني غير المقروءة فقط
is:starredرسائل البريد الإلكتروني المميزة
has:attachmentرسائل البريد الإلكتروني مع مرفقات
after:2025/01/01رسائل البريد الإلكتروني بعد التاريخ
before:2025/12/31رسائل البريد الإلكتروني قبل التاريخ
label:importantرسائل البريد الإلكتروني مع التسمية
"عبارة دقيقة"تطابق عبارة دقيقة

مثال​

الإجراء: البحث في رسائل Gmail
  الاستعلام: "from:{{customer_email}} is:unread subject:order"
  الحد الأقصى من النتائج: 5

✅ تحديد بريد Gmail كـ مقروء​

حدد بريدًا إلكترونيًا كمقروء في Gmail.

التكوين​

الحقلالنوعمطلوبالوصف
معرف البريد الإلكترونيسلسلة✅البريد الإلكتروني الذي سيتم تحديده كمقروء

مثال​

الإجراء: تحديد بريد Gmail كـ مقروء
  معرف البريد الإلكتروني: "{{email.id}}"

📝 إنشاء مسودة Gmail​

إنشاء مسودة بريد إلكتروني للمراجعة البشرية قبل الإرسال.

التكوين​

الحقلالنوعمطلوبالوصف
إلىبريد إلكتروني✅البريد الإلكتروني للمتلقي
الموضوعسلسلة✅موضوع البريد الإلكتروني
المحتوىسلسلة✅محتوى البريد الإلكتروني
نسخة كربونيةبريد إلكتروني❌النسخة الكربونية
نسخة كربونية مخفيةبريد إلكتروني❌النسخة الكربونية المخفية
معرف السلسلةسلسلة❌للردود على المسودات

متغيرات الإخراج​

المتغيرالنوعالوصف
draftIdسلسلةمعرف المسودة التي تم إنشاؤها
messageIdسلسلةمعرف الرسالة

حالة الاستخدام: وضع مسودة AI​

المشغل: مسودة Gmail AI
    ↓
طلب AI:
  المطالبة: "قم بإنشاء رد احترافي على هذا البريد الإلكتروني"
  الإدخال: "{{email.body}}"
    ↓
إنشاء مسودة Gmail:
  إلى: "{{email.from}}"
  الموضوع: "رد: {{email.subject}}"
  المحتوى: "{{ai_response}}"

📋 قائمة مسودات Gmail​

استرجع جميع المسودات من حساب Gmail الخاص بك.

التكوين​

الحقلالنوعمطلوبالوصف
الحد الأقصى من النتائجرقم❌الحد الأقصى لعدد المسودات لعرضها

متغيرات الإخراج​

المتغيرالنوعالوصف
draftsمصفوفةقائمة كائنات المسودة
drafts[].idسلسلةمعرف المسودة
drafts[].messageكائنمعاينة رسالة المسودة

📨 إرسال مسودة Gmail​

إرسال مسودة موجودة من Gmail الخاص بك.

التكوين​

الحقلالنوعمطلوبالوصف
معرف المسودةسلسلة✅المسودة التي سيتم إرسالها

متغيرات الإخراج​

المتغيرالنوعالوصف
messageIdسلسلةمعرف الرسالة المرسلة
threadIdسلسلةمعرف السلسلة

🗑️ حذف مسودة Gmail​

حذف مسودة من حساب Gmail الخاص بك.

التكوين​

الحقلالنوعمطلوبالوصف
معرف المسودةسلسلة✅المسودة التي سيتم حذفها

📂 الحصول على سلسلة البريد الإلكتروني​

استرجاع سلسلة محادثة البريد الإلكتروني كاملة.

التكوين​

الحقلالنوعمطلوبالوصف
معرف السلسلةسلسلة✅السلسلة التي سيتم استرجاعها

متغيرات الإخراج​

المتغيرالنوعالوصف
threadكائنكائن السلسلة الكامل
thread.idسلسلةمعرف السلسلة
thread.messagesمصفوفةجميع الرسائل في السلسلة
thread.historyIdسلسلةمعرف التاريخ

مثال​

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

أمثلة على سير العمل الكامل​

المثال 1: مساعد البريد الإلكتروني الذكي​

معالجة رسائل البريد الواردة تلقائيًا وإنشاء ردود مسودة مولدة بواسطة الذكاء الاصطناعي.

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 قبل الرد لضمان أن الذكاء الاصطناعي لديك لديه سياق المحادثة الكامل.

3. تنفيذ تحديد المعدل​

لدى Gmail حصص API. لسير العمل عالي الحجم:

  • أضف تأخيرات بين الإجراءات
  • قم بتجميع العمليات عند الإمكان
  • راقب استخدام حصتك

4. استخدام استعلامات البحث الذكية​

اجمع بين عوامل استعلام Gmail للتصفية الدقيقة:

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

5. التعامل مع الأخطاء بشكل سلس​

استخدم عقد If Condition للتحقق من الأخطاء وتنفيذ منطق الاحتياطي.

الوثائق ذات الصلة​

جاهز لرفع مستوى
تجربة المستخدم الخاصة بك؟

نشر مساعدي الذكاء الاصطناعي الذين يسعدون العملاء ويتناسبون مع عملك.

متوافق مع اللائحة العامة لحماية البيانات
ابدأ تجربة مجانيةالوصول إلى المكتب الخلفي