مقدمه

برچسب‌گذاری ایمیل با n8n

ساخت سیستم هوشمند برچسب‌گذاری ایمیل با n8n و OpenAI به همراه آموزش کامل اتوماسیون ایمیل با ترکیب n8n، مدل‌های هوش مصنوعی OpenAI و Gmail API می‌توان فرآیند دسته‌بندی، برچسب‌گذاری و سازمان‌دهی ایمیل‌ها را به‌صورت کاملاً خودکار انجام داد. این رویکرد نه‌تنها زمان مدیریت صندوق ورودی را کاهش می‌دهد، بلکه دقت در دسته‌بندی ایمیل‌ها را نیز به شکل قابل توجهی افزایش می‌دهد. در شرایطی که حجم ایمیل‌های کاری و شخصی روزبه‌روز در حال افزایش است، استفاده از چنین Workflowهایی می‌تواند نقش مهمی در افزایش بهره‌وری افراد و تیم‌ها داشته باشد.

در این مقاله یک Workflow حرفه‌ای در n8n بررسی می‌شود که به‌صورت خودکار ایمیل‌های جدید را در بازه‌های زمانی مشخص بررسی می‌کند. سپس محتوای ایمیل‌ها با کمک هوش مصنوعی تحلیل شده و مناسب‌ترین برچسب Gmail انتخاب می‌شود. در صورتی که برچسب مناسبی وجود نداشته باشد، سیستم به‌طور خودکار یک برچسب جدید ایجاد می‌کند و ساختار دسته‌بندی را گسترش می‌دهد. در ادامه، تمام Nodeها، تنظیمات، پیش‌نیازها و نحوه شخصی‌سازی این Workflow به‌صورت کامل آموزش داده خواهد شد.

قبل از شروع

اگر هنوز n8n را نصب نکرده‌اید، پیشنهاد می‌کنیم ابتدا مقاله «آموزش n8n» را مطالعه کنید. در آن مقاله، مراحل نصب با Node.js و Docker، راه‌اندازی اولیه و ساخت اولین Workflow به‌صورت کامل آموزش داده شده است. پس از نصب و راه‌اندازی، به این مقاله بازگردید و مراحل پیاده‌سازی این Workflow را دنبال کنید.

سیستم هوشمند برچسب‌گذاری ایمیل با n8n چگونه کار می‌کند؟

در این بخش عملکرد کلی Workflow بررسی می‌شود.

این سیستم یک ابزار هوشمند برای مدیریت ایمیل‌ها در محیط n8n است که با کمک هوش مصنوعی، ایمیل‌های دریافتی را تحلیل و دسته‌بندی می‌کند.

این Workflow چه کاری انجام می‌دهد؟

در ابتدا، سیستم هر ۵ دقیقه یک‌بار حساب Gmail را بررسی می‌کند. در صورت دریافت ایمیل جدید، اطلاعات آن استخراج شده و به یک Agent هوشمند مبتنی بر OpenAI ارسال می‌شود.

این Agent محتوای ایمیل را تحلیل کرده و با توجه به موضوع، فرستنده و محتوای پیام، بهترین دسته‌بندی را پیشنهاد می‌دهد.

در صورتی که برچسب مناسب از قبل وجود داشته باشد، همان برچسب روی ایمیل اعمال می‌شود. اگر چنین برچسبی وجود نداشته باشد، سیستم به‌صورت خودکار یک Label جدید ایجاد می‌کند و ساختار Gmail را توسعه می‌دهد.

در نتیجه، صندوق ورودی کاربر به‌صورت کاملاً خودکار سازمان‌دهی شده و ایمیل‌ها نظم بیشتری پیدا می‌کنند.

کاربردهای این Workflow

این سیستم هوشمند کاربردهای متعددی دارد:

• مدیریت خودکار ایمیل‌های کاری و شخصی

• دسته‌بندی ایمیل‌های مشتریان در شرکت‌ها

• فیلتر کردن ایمیل‌های تبلیغاتی و غیرضروری

• کمک به تیم‌های پشتیبانی برای سازمان‌دهی تیکت‌ها

• استفاده در CRMهای کوچک برای مدیریت ارتباط با مشتری

• کاهش زمان بررسی Inbox در مدیران و فریلنسرها

پیش‌نیازها

برای اجرای این Workflow به موارد زیر نیاز دارید:

• نصب و راه‌اندازی n8n

• دسترسی به حساب Gmail و فعال‌سازی Gmail API

• ساخت Credential برای Gmail OAuth2

• دسترسی به OpenAI و دریافت API Key

• اتصال حساب OpenAI در n8n

• فعال بودن اینترنت و دسترسی به APIها

• آشنایی اولیه با Workflow در n8n

• فعال بودن Polling در Gmail Trigger

دانلود Template

در این بخش فایل JSON Workflow را دانلود کرده و در n8n Import کنید.

پسوورد فایل فشرده: danixai.com

1. Gmail Trigger

وظیفه:
بررسی ایمیل‌های جدید در Gmail هر ۵ دقیقه

ورودی:
نیازی به ورودی ندارد (Polling)

خروجی:
اطلاعات اولیه ایمیل شامل ID، فرستنده، موضوع و متادیتا

تنظیمات مهم:
Poll Time روی هر ۵ دقیقه تنظیم شده است

دلیل استفاده:
شروع‌کننده اصلی Workflow برای تشخیص ایمیل جدید

2. Wait Node

وظیفه:
ایجاد تأخیر کوتاه قبل از پردازش ایمیل

ورودی:
داده ایمیل از Gmail Trigger

خروجی:
عبور داده بدون تغییر بعد از ۱ ثانیه

تنظیمات مهم:
Delay = 1 second

دلیل استفاده:
جلوگیری از فشار ناگهانی روی API

3. Gmail Labelling Agent

وظیفه:
مغز اصلی Workflow برای تحلیل و تصمیم‌گیری

ورودی:
اطلاعات ایمیل

خروجی:
تصمیم درباره برچسب مناسب یا ایجاد برچسب جدید

تنظیمات مهم:

• اتصال به OpenAI Chat Model

• استفاده از Toolهای Gmail

• حافظه Window Buffer

دلیل استفاده:
تصمیم‌گیری هوشمند با کمک AI

4. OpenAI Chat Model

وظیفه:
پردازش زبان طبیعی و تحلیل ایمیل‌ها

ورودی:
متن ایمیل و دستور Agent

خروجی:
پیشنهاد برچسب یا تصمیم عملی

تنظیمات مهم:
maxTokens = 4096

دلیل استفاده:
قدرت تحلیل معنایی ایمیل‌ها

5. Gmail – Read Labels

وظیفه:
دریافت لیست تمام برچسب‌های موجود

ورودی:
درخواست از Agent

خروجی:
لیست label IDها و نام‌ها

دلیل استفاده:
برای جلوگیری از ساخت برچسب تکراری

6. Gmail – Get Message

وظیفه:
دریافت محتوای کامل ایمیل

ورودی:
messageId

خروجی:
متن کامل ایمیل

تنظیمات مهم:
messageId از AI استخراج می‌شود

دلیل استفاده:
تحلیل دقیق محتوا توسط AI

7. Gmail – Add Label to Message

وظیفه:
اضافه کردن برچسب به ایمیل

ورودی:
messageId + labelIds

خروجی:
ایمیل دسته‌بندی‌شده

دلیل استفاده:
اعمال نتیجه تصمیم AI

8. Gmail – Create Label

وظیفه:
ساخت برچسب جدید در Gmail

ورودی:
نام برچسب پیشنهادی AI

خروجی:
labelId جدید

دلیل استفاده:
توسعه خودکار ساختار دسته‌بندی

9. Window Buffer Memory

وظیفه:
نگهداری حافظه مکالمه Agent

ورودی:
شناسه ایمیل

خروجی:
حافظه کوتاه‌مدت

دلیل استفاده:
افزایش دقت تصمیم‌گیری AI

10. Sticky Notes

وظیفه:
مستندسازی Workflow

کاربرد:

• توضیح Gmail API

• توضیح OpenAI

• راهنمای ساختار سیستم

نحوه شخصی‌سازی Workflow

این Workflow به‌راحتی قابل تغییر است:

• تغییر Promptهای Agent برای دسته‌بندی دقیق‌تر

• تغییر مدل AI از OpenAI به مدل‌های دیگر

• تغییر زمان‌بندی Gmail Trigger

• اضافه کردن شرط‌های IF برای فیلتر ایمیل‌ها

• تغییر ساختار Labelها

• اضافه کردن مسیرهای جدید مانند ارسال به Slack یا Telegram

• تغییر حافظه Agent برای پردازش طولانی‌تر

مزایای استفاده از این Workflow

• کاهش زمان مدیریت ایمیل

• دسته‌بندی خودکار و هوشمند

• حذف کارهای تکراری

• افزایش بهره‌وری کاری

• کاهش خطای انسانی

• بهبود ساختار Inbox

نکات مهم

• همیشه Gmail API باید فعال باشد

• محدودیت‌های OpenAI API را بررسی کنید

• از ساخت بیش از حد Label جلوگیری کنید

• Promptها باید دقیق و بدون ابهام باشند

• Polling بیش از حد ممکن است هزینه‌بر باشد

• بهتر است ابتدا روی ایمیل‌های کم تست شود

• ساختار Labelها باید استاندارد باشد

• Memory را در پروژه‌های بزرگ کنترل کنید

خطاهای رایج (Troubleshooting)

1. عدم اتصال Gmail

علت: Credential اشتباه
راه‌حل: بررسی OAuth و اتصال مجدد

2. خطای OpenAI API

علت: API Key نامعتبر
راه‌حل: ساخت Key جدید در OpenAI

3. عدم دریافت messageId

علت: مشکل در Trigger
راه‌حل: بررسی Gmail Polling

4. ایجاد Label تکراری

علت: نبود بررسی Labelها
راه‌حل: استفاده از Gmail Read Labels

5. Timeout در Workflow

علت: پردازش سنگین AI
راه‌حل: کاهش maxTokens

سوالات متداول

1. آیا این Workflow برای ایمیل‌های زیاد مناسب است؟

بله، اما باید محدودیت API مدیریت شود.

2. آیا بدون OpenAI هم قابل اجراست؟

خیر، بخش تصمیم‌گیری وابسته به AI است.

3. آیا می‌توان به Slack هم متصل کرد؟

بله، به‌راحتی قابل توسعه است.

4. آیا نیاز به برنامه‌نویسی دارد؟

حداقل، بیشتر تنظیمات گرافیکی هستند.

5. آیا این سیستم امن است؟

بله، چون از OAuth رسمی Gmail استفاده می‌کند.

جمع‌بندی

این سیستم هوشمند برچسب‌گذاری ایمیل با n8n یک نمونه واقعی از اتوماسیون پیشرفته با کمک هوش مصنوعی است. ترکیب Gmail API و OpenAI باعث شده تا فرآیند مدیریت ایمیل‌ها به‌صورت کاملاً خودکار انجام شود. با استفاده از این Workflow، کاربران می‌توانند زمان زیادی را صرفه‌جویی کنند و Inbox خود را به‌صورت هوشمند سازمان‌دهی کنند.

این مدل از اتوماسیون نشان می‌دهد که چگونه می‌توان با ابزارهایی مانند n8n، سیستم‌های پیچیده اما کاربردی ساخت که در دنیای واقعی ارزش بالایی دارند. استفاده از سیستم هوشمند برچسب‌گذاری ایمیل با n8n می‌تواند نقطه شروعی برای ساخت اتوماسیون‌های پیشرفته‌تر در آینده باشد.

GIT