اتوماسیون ثبت ایمیل Gmail در Google Sheets با n8n

اتوماسیون ثبت ایمیل: ایمیل‌های جدید به Google Sheets

این گردش کار به طور خودکار ایمیل‌های ورودی جدید از صندوق ورودی Gmail شما را به عنوان یک ردیف جدید به یک صفحه گسترده Google Sheets اضافه می‌کند. این گردش کار برای ایجاد یک گزارش سازمان‌یافته و قابل جستجو از ایمیل‌های شما بدون نیاز به ورود دستی داده، عالی است.

موارد استفاده:

• بایگانی خودکار ایمیل: درخواست‌های پشتیبانی مشتری، سرنخ‌های فروش یا ارتباطات داخلی را ثبت کنید.
• گزارش‌دهی و تجزیه و تحلیل: فراداده ایمیل را برای ردیابی عملکرد یا هوش تجاری جمع‌آوری کنید.
• استخراج داده سفارشی: جزئیات خاص ایمیل را برای برنامه‌های مختلف استخراج و ذخیره کنید.

ساختار گردش کار:

1. تشخیص ایمیل: گره Gmail Trigger صندوق ورودی شما را برای پیام‌های جدید نظارت می‌کند.

2. ذخیره‌سازی داده: گره Google Sheets جزئیات کلیدی ایمیل را دریافت کرده و آن‌ها را به عنوان یک ردیف جدید در صفحه گسترده مشخص شده شما اضافه می‌کند.

3. مستندسازی: یادداشت‌های چسبان توضیحات روشن و راهنمایی را در داخل گردش کار ارائه می‌دهند.

---

تجزیه و تحلیل دقیق گردش کار

۱. تشخیص ایمیل (Gmail Trigger)

• هدف: این گره به طور مداوم صندوق ورودی Gmail شما را برای ایمیل‌های ورودی جدید بررسی می‌کند و هنگام شناسایی یک ایمیل، گردش کار را آغاز می‌کند.
• نوع گره: n8n-nodes-base.gmailTrigger
• پیکربندی:

* احراز هویت: به اعتبارنامه‌های OAuth2 برای حساب Google شما نیاز دارد. اطمینان حاصل کنید که Gmail API در پروژه Google Cloud شما فعال است.

* رویداد ماشه: برای فعال شدن در هر ایمیل جدید، روی "Message Received" تنظیم شده است.

* بازه زمانی نظرسنجی: برای بررسی هر دقیقه ایمیل‌های جدید پیکربندی شده است.

* فیلترها: در این مثال هیچ فیلتر خاصی اعمال نشده است، به این معنی که تمام ایمیل‌های ورودی گردش کار را راه‌اندازی می‌کنند. شما می‌توانید فیلترها (به عنوان مثال، بر اساس فرستنده، موضوع یا برچسب) را برای پردازش فقط ایمیل‌های خاص اضافه کنید.

• داده خروجی: فراداده جامع ایمیل را شامل می‌شود، از جمله From، Subject و snippet (پیش‌نمایش بدنه ایمیل).
• مشکلات احتمالی:

* خطاهای احراز هویت: انقضا یا لغو توکن OAuth2.

* سهمیه‌های API: فراتر رفتن از محدودیت‌های نرخ Gmail API.

* اتصال: وقفه‌های شبکه.

۲. ذخیره‌سازی داده (Google Sheets)

• هدف: این گره داده‌ها را از Gmail Trigger دریافت کرده و آن را به عنوان یک ردیف جدید به یک Google Sheet اختصاصی اضافه می‌کند.
• نوع گره: n8n-nodes-base.googleSheets
• پیکربندی:

* احراز هویت: به اعتبارنامه‌های OAuth2 برای حساب Google شما نیاز دارد. اطمینان حاصل کنید که Google Sheets API در پروژه Google Cloud شما فعال است.

* عملیات: برای افزودن داده به انتهای صفحه شما، روی "Append Row" تنظیم شده است.

* شناسه صفحه گسترده: شناسه منحصر به فرد سند Google Sheet خود را مشخص کنید (به عنوان مثال، 1o28BFBtzzsnwN01VTcfRp2bmN01VTcfRp2BUyAFi9e-91H_b920_gJc).

* نام صفحه: صفحه خاصی را در سند تعریف کنید (به عنوان مثال، gid=0 برای صفحه اول).

* نگاشت ستون:

* Sender Email ← ={{ $json.From }} (فرستنده ایمیل را به ستون "Sender Email" نگاشت می‌کند)

* Subject ← ={{ $json.Subject }} (موضوع ایمیل را به ستون "Subject" نگاشت می‌کند)

* body ← ={{ $json.snippet }} (پیش‌نمایش ایمیل را به ستون "body" نگاشت می‌کند)

• مشکلات احتمالی:

* خطاهای احراز هویت: توکن OAuth2 نامعتبر یا منقضی شده Google Sheets.

* مجوزهای API: حقوق دسترسی ناکافی به Google Sheet یا فعال نبودن Sheets API.

* خطاهای نگاشت داده: فیلدهای گمشده یا بدشکل از گره ماشه.

* خطاهای صفحه گسترده/صفحه: شناسه صفحه گسترده یا نام صفحه نادرست.

۳. مستندسازی (یادداشت‌های چسبان)

• هدف: این گره‌ها زمینه بصری و دستورالعمل‌ها را مستقیماً در ویرایشگر گردش کار n8n ارائه می‌دهند.
• نوع گره: n8n-nodes-base.stickyNote
• محتوا: شامل عنوان گردش کار و توضیحات مفصلی از عملکرد، موارد استفاده و گزینه‌های سفارشی‌سازی آن است.

---

جدول خلاصه

---

ساخت گردش کار از ابتدا

1. افزودن Gmail Trigger:

* گره Gmail Trigger را جستجو و اضافه کنید.

* احراز هویت OAuth2 را برای حساب Google خود پیکربندی کنید.

* رویداد ماشه را روی Message Received تنظیم کنید.

* بازه زمانی نظرسنجی را روی Every Minute تنظیم کنید.

* گره را ذخیره کنید.

2. افزودن گره Google Sheets:

* گره Google Sheets را جستجو و اضافه کنید.

* احراز هویت OAuth2 را برای حساب Google خود پیکربندی کنید.

* عملیات را روی Append Row تنظیم کنید.

* شناسه صفحه گسترده و نام صفحه خود را وارد کنید.

* ستون‌ها را نگاشت کنید:

* Sender Email ← ={{ $json.From }}

* Subject ← ={{ $json.Subject }}

* body ← ={{ $json.snippet }}

* گره را ذخیره کنید.

3. اتصال گره‌ها:

* یک لبه از گره Gmail Trigger به گره Google Sheets بکشید.

4. افزودن یادداشت‌های چسبان (اختیاری):

* گره‌های Sticky Note را برای عنوان گردش کار و ارائه توضیحات برای وضوح اضافه کنید.

5. فعال‌سازی گردش کار:

* گردش کار را برای شروع اتوماسیون ثبت ایمیل خود فعال کنید.

---

منابع و یادداشت‌ها

• فعال‌سازی API: اطمینان حاصل کنید که Gmail API و Google Sheets API قبل از تنظیم اعتبارنامه‌های OAuth2 در Google Cloud Console شما فعال هستند.
• سفارشی‌سازی: گره Gmail Trigger را با فیلترها برای پردازش ایمیل‌های خاص اصلاح کنید، یا ستون‌های بیشتری را در گره Google Sheets برای ثبت جزئیات اضافی ایمیل اضافه کنید.
• مستندات n8n: برای اطلاعات دقیق در مورد گره‌های Gmail و Google Sheets به کاتالوگ Axeto n8n رسمی مراجعه کنید.