ذخیره صفحات Notion در Supabase با n8n

مقدمه

در عصر هوش مصنوعی و مدل‌های زبانی بزرگ، ساخت پایگاه‌های دانش هوشمند و سیستم‌های RAG (بازیابی مبتنی بر تولید) به یکی از حیاتی‌ترین نیازهای کسب‌وکارها و توسعه‌دهندگان تبدیل شده است. ابزار Notion به عنوان یکی از محبوب‌ترین پلتفرم‌های مدیریت محتوا و مستندساز‌های سازمانی، محل ذخیره‌سازی داده‌ها، دستورالعمل‌ها و مقالات زیادی است. اما برای اینکه بتوان این اطلاعات متنی را در اختیار مدل‌های هوش مصنوعی قرار داد تا به سوالات کاربران پاسخ دهند یا تحلیل‌های دقیق ارائه کنند، نیاز است که محتوای متنی به بردارهای عددی (Embeddings) تبدیل شده و در یک پایگاه داده برداری (Vector Database) ذخیره شود. فرآیند ذخیره صفحات Notion در Supabase با n8n این مسیر پیچیده را به یک جریان کاری خودکار و هوشمند تبدیل می‌کند.

پایگاه داده Supabase با بهره‌گیری از افزونه pgvector، بستری بسیار قدرتمند و امن برای ذخیره و جستجوی معنایی بردارها ارائه می‌دهد. از سوی دیگر، ابزار n8n به عنوان یک پلتفرم خودکارسازی جریان کاری (Workflow Automation)، امکان اتصال بدون درز میان Notion، API تبدیل متن به بردار OpenAI و Supabase را فراهم می‌سازد. در این مقاله آموزشی کامل، قدم به قدم بررسی خواهیم کرد که چگونه می‌توان با استفاده از یک قالب پیش‌فرض (Template) در n8n، تمام صفحات جدید اضافه شده به نوشن را به‌صورت خودکار پردازش، قطعه‌بندی و در سوپابیس ذخیره کرد تا زیرساختی آماده برای برنامه‌های مبتنی بر AI داشته باشید.

N8N برای چه کسب و کارهایی مناسب است:

اگر سازمان شما کوچک می باشد و هم اکنون بسیاری از کار های خود را با نرم افزار هایی همچون اکسل انجام می دهید، N8N برای کسب و کار شما ایده آل است و در صورتی که کسب و کاری متوسط یا بزرگ دارید می توانید بخش های بسیاری از فرایند های غیر کلیدی خود را با این ابزار هوشمند کنید.

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

برای کسب و کارهای کوچک به این لینک مراجعه کنید.

همچنین اگر ترجیح می‌دهید شخصاً نصب و راه‌اندازی را انجام دهید، می‌توانید از اطلاعات موجود در مقالات، دسته N8N استفاده کنید .همچنین می توانید template موجود در این workflow را به صورت رایگان از این قسمت دانلود کنید.

رمز فایل: danixai.com

قبل از شروع مقاله ذخیره صفحات Notion در Supabase با n8n

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

فرآیند انتقال ایمیل به نوشن با n8n چگونه کار می‌کند؟

این ورک‌فلو به‌صورت زمان‌بندی‌شده هر یک دقیقه یک‌بار صندوق ورودی Gmail شما را بررسی می‌کند. اگر ایمیلی به یک آدرس آلیاس خاص ارسال شده باشد (مانند user+ROUTE_ID@gmail.com)، سیستم شناسه مسیر (Route ID) را استخراج کرده و در جدول Airtable جستجو می‌کند.

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

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

• مدیریت وظایف پروژه‌ها: تبدیل مستقیم دستورالعمل‌های دریافتی از کارفرمایان یا مدیران پروژه به Taskهای قابل اجرا در نوشن.

• ثبت درخواست‌های پشتیبانی: ذخیره ایمیل‌های پشتیبانی مشتریان در دیتابیس تیکت‌های نوشن با استخراج خلاصه مشکل و متادیتا.

• ذخیره‌سازی لیدها و مشتریان احتمالی: هدایت ایمیل‌های دریافتی از فرم‌های تماس وب‌سایت به سیستم CRM طراحی‌شده در نوشن.

• خلاصه‌سازی خبرنامه‌ها: تبدیل خبرنامه‌های طولانی به خلاصه‌های کوتاه و طبقه‌بندی‌شده جهت مطالعه در زمان مناسب.

• ثبت گزارش‌های خطا و باگ: ارسال خودکار ایمیل‌های گزارش خطا از سیستم‌های مانیتورینگ به دیتابیس باگ‌های فنی.

• مسیریابی چندگانه برای تیم‌های مختلف: ارسال ایمیل‌ها به دیتابیس‌های مختلف نوشن بر اساس شناسه آلیاس ایمیل (مانند دیتابیس مالی، دیتابیس فنی یا دیتابیس مارکتینگ).

پیش‌نیازهای اجرای این Workflow:

• حساب n8n: یک نسخه فعال به‌صورت Self-hosted یا Cloud.

• حساب Gmail: دسترسی اتصال OAuth2 جهت دریافت، ارسال و مدیریت برچسب‌های ایمیل.

• کلید API سرویس OpenAI: داشتن کلید معتبر و شارژ فعال جهت دسترسی به مدل gpt-4o.

• دیتابیس Airtable: ساخت یک Base حاوی جدول Routes برای ذخیره توکن‌های Notion و شناسه‌های مسیر.

• حساب و Integration در Notion: ایجاد توکن دسترسی و اشتراک‌گذاری دیتابیس‌های هدف با اینتگریشن.

• برچسب‌های اختصاصی Gmail: ایجاد دو برچسب با نام‌های Processed و Error در Gmail برای پیگیری وضعیت پردازش ایمیل‌ها.

دانلود Template

فایل JSON این Workflow را از این قسمت دانلود کنید.

رمز فایل: danixai.com

آموزش Import کردن Workflow

وارد داشبورد n8n شوید. روی Import from File کلیک کنید. فایل JSON را انتخاب کنید. Workflow ایجاد خواهد شد. Credentialهای موردنیاز را تنظیم کنید.

ساختار Workflow برای ذخیره صفحات Notion در Supabase با n8n

مسیر کلی داده‌ها در این ورک‌فلو به شرح زیر است:

Gmail Trigger (بررسی ایمیل جدید)
  ↓
Globals (تعریف متغیرهای برچسب)
  ↓
Filter for unprocessed mails (فیلتر ایمیل‌های پردازش‌نشده)
  ↓
Extract Route ID (استخراج شناسه مسیر از آلیاس ایمیل)
  ↓
Get Route by ID (دریافت اطلاعات مسیر از Airtable)
  ↓
Active Routes Only (تایید فعال بودن مسیر)
  ↓
Generate Actionable Task (ایجنت هوش مصنوعی برای ساخت وظیفه)
  ↓
Get Summary & Meta Data (ایجنت هوش مصنوعی برای خلاصه و متادیتا)
  ↓
Format Notion Page Blocks (کدنویسی جاوا اسکریپت ساختار بلاک‌های نوشن)
  ↓
Create Notion Page (ارسال درخواست HTTP به API نوشن)
  ↓
Add Label "Processed" (افزودن برچسب موفقیت به ایمیل)

(شاخه خطا): Deactivate Route → Send notification → Add Label "Error"

آموزش کامل تمام Nodeها جهت ذخیره صفحات Notion در Supabase با n8n

1. Gmail Trigger

• وظیفه Node: بررسی صندوق ورودی Gmail در فواصل زمانی منظم جهت دریافت ایمیل‌های جدید.

• ورودی: پیام‌های جدید واردشده به INBOX.

• خروجی: شیء JSON حاوی تمام اطلاعات ایمیل مانند فرستنده، گیرنده، متن پیام، موضوع و برچسب‌ها.

• تنظیمات مهم: پارامتر pollTimes روی حالت everyMinute و فیلتر labelIds روی INBOX تنظیم شده است.

• نکات قابل تغییر: بازه زمانی بررسی (مثلا هر ۵ دقیقه) یا اضافه کردن فیلترهای جستجوی متن.

• دلیل استفاده: نقطه شروع خودکار فرآیند با دریافت ایمیل جدید.

2. Globals

• وظیفه Node: ذخیره‌سازی متغیرهای سراسری مربوط به شناسه برچسب‌های Gmail.

• ورودی: خروجی نود Gmail Trigger.

• خروجی: متغیرهای errorLabelID و processedLabelID به همراه داده‌های ایمیل.

• تنظیمات مهم: مقادیر فیلدها شامل شناسه‌های متنی برچسب‌ها در Gmail است.

• نکات قابل تغییر: شناسه برچسب‌های اختصاصی حساب کاربر باید در این بخش جایگذاری شود.

• دلیل استفاده: متمرکزسازی تنظیمات و جلوگیری از هاردکد کردن شناسه‌ها در چندین نود مختلف.

3. Filter for unprocessed mails

• وظیفه Node: جلوگیری از پردازش تکراری ایمیل‌ها و اعتبارسنجی فرمت آلیاس.

• ورودی: لیست برچسب‌های ایمیل و آدرس گیرنده.

• خروجی: ایمیل‌هایی که فاقد برچسب Error یا Processed بوده و دارای آدرس آلیاس معتبر هستند.

• تنظیمات مهم: بررسی شرط عدم وجود شناسه برچسب‌های خطا و پردازش‌شده در لیست labelIds ایمیل.

• نکات قابل تغییر: افزودن شروط بیشتر مانند فیلتر کردن آدرس فرستنده‌های خاص.

• دلیل استفاده: بهینه‌سازی مصرف توکن هوش مصنوعی و جلوگیری از ایجاد حلقه‌های بی‌نهایت.

4. Extract Route ID

• وظیفه Node: استخراج شناسه اختصاصی مسیر از آدرس ایمیل گیرنده با استفاده از عبارت منظم (Regex).

• ورودی: متن آدرس گیرنده (to.text).

• خروجی: متغیر route حاوی کد مسیر.

• تنظیمات مهم: استفاده از کد رگکس /\+([^@]+)@/ برای استخراج متن بین علامت + و @.

• نکات قابل تغییر: در صورت تغییر الگوی آدرس‌دهی آلیاس، باید فرمول رگکس اصلاح شود.

• دلیل استفاده: تشخیص هوشمند دیتابیس هدف در نوشن بدون نیاز به بررسی دستی.

5. Get Route by ID

• وظیفه Node: استخراج اطلاعات مسیر مربوطه از جدول Airtable بر اساس شناسه دریافتی.

• ورودی: شناسه route استخراج‌شده از مرحله قبل.

• خروجی: رکورد کامل شامل توکن اختصاصی Notion، لینک دیتابیس و وضعیت فعال بودن مسیر.

• تنظیمات مهم: پارامتر onError روی continueErrorOutput و retryOnFail فعال است.

• نکات قابل تغییر: تنظیم نام Base و Table متناسب با حساب Airtable کاربر.

• دلیل استفاده: مدیریت پویا و جداگانه مسیرها و توکن‌های دسترسی بدون دستکاری ورک‌فلو.

6. Active Routes Only

• وظیفه Node: بررسی فعال بودن مسیر استخراج‌شده از Airtable.

• ورودی: اطلاعات رکورد دریافت شده از Airtable.

• خروجی: ارزیابی فیلد Boolean با نام Active.

• تنظیمات مهم: شرط Active == true.

• نکات قابل تغییر: افزودن شرایط اعتبارسنجی بیشتر بر اساس تاریخ یا سطح دسترسی.

• دلیل استفاده: جلوگیری از ارسال داده به مسیرها یا دیتابیس‌های غیرفعال شده.

7. Generate Actionable Task

• وظیفه Node: ایجنت هوش مصنوعی (AI Agent) جهت تحلیل متن ایمیل و استخراج یک وظیفه مشخص و قابل اجرا.

• ورودی: متن کامل پیام ایمیل.

• خروجی: داده ساختاریافته شامل عنوان وظیفه، توضیحات دقیق و لیست نکات کلیدی.

• تنظیمات مهم: استفاده از systemMessage برای ساخت وظایف حداکثر ۵ کلمه‌ای برای عنوان و توضیحات کامل.

• نکات قابل تغییر: تغییر دستورالعمل‌های پرامپت جهت سفارشی‌سازی فرمت وظایف.

• دلیل استفاده: تبدیل متن شلوغ ایمیل به یک وظیفه کاملا شفاف و عملیاتی.

8. OpenAI Chat Model1

• وظیفه Node: ارائه مدل زبانی بزرگ (LLM) به ایجنت استخراج وظایف.

• ورودی: درخواست‌های پردازشی از نود ایجنت.

• خروجی: خروجی متنی هوش مصنوعی.

• تنظیمات مهم: استفاده از مدل gpt-4o با میزان temperature: 0.

• نکات قابل تغییر: امکان تغییر مدل به gpt-4o-mini برای کاهش هزینه‌ها.

• دلیل استفاده: قدرت بالای مدل GPT-4o در فهم دقیق متن و استخراج نکات کلیدی.

9. Structured Output Parser1

• وظیفه Node: قالب‌بندی خروجی هوش مصنوعی براساس یک ساختار مشخص JSON.

• ورودی: خروجی خام متنی هوش مصنوعی.

• خروجی: آبجکت JSON با کلیدهای title، description و bulletpoints.

• تنظیمات مهم: تعریف دقیق Schema نمونه JSON.

• نکات قابل تغییر: افزودن فیلدهای جدید مانند اولویت یا زمان پیشنهادی.

• دلیل استفاده: تضمین دریافت خروجی استاندارد و بدون خطای ساختاری.

10. Calculator1

• وظیفه Node: ابزار محاسباتی ریاضی برای ایجنت (در این ورک‌فلو به صورت پیش‌فرض غیرفعال است).

• ورودی: درخواست محاسباتی.

• خروجی: نتایج عددی.

• تنظیمات مهم: disabled: true.

• نکات قابل تغییر: فعال‌سازی در صورت نیاز به محاسبات عددی ایمیل‌ها.

• دلیل استفاده: فراهم کردن قابلیت‌های محاسباتی اختیاری برای ایجنت.

11. Get Summary & Meta Data

• وظیفه Node: ایجنت دوم هوش مصنوعی جهت خلاصه کردن متن ایمیل و استخراج متادیتای فرستنده، موضوع و تاریخ.

• ورودی: متن ایمیل.

• خروجی: ساختار JSON شامل خلاصه ایمیل و متادیتای فرمت‌شده فرستنده و تاریخ.

• تنظیمات مهم: پرامپت اختصاصی برای جداسازی مشخصات در ایمیل‌های فورواردشده.

• نکات قابل تغییر: تغییر فرمت نمایش تاریخ یا میزان جزئیات خلاصه.

• دلیل استفاده: ارائه‌دهنده دید کلی سریع از محتوای ایمیل در نوشن.

12. OpenAI Chat Model

• وظیفه Node: تامین مدل زبانی برای ایجنت خلاصه و متادیتا.

• ورودی: درخواست‌های ایجنت دوم.

• خروجی: پاسخ پردازش‌شده.

• تنظیمات مهم: مدل gpt-4o با پاسخ‌دهی json_object.

• نکات قابل تغییر: تغییر پارامترهای مدل یا سوئیچ به سایر ارائه‌دهندگان AI.

• دلیل استفاده: تحلیل دقیق ساختار پیام‌های طولانی و فورواردشده.

13. Structured Output Parser

• وظیفه Node: اعتبارسنجی ساختار خروجی خلاصه و متادیتا.

• ورودی: متن خروجی مدل.

• خروجی: JSON استاندارد شامل summary و فیلد متداخل meta.

• تنظیمات مهم: تعریف دقیق الگوی خروجی.

• نکات قابل تغییر: افزودن فیلدهای متادیتای بیشتر مانند پیوست‌ها.

• دلیل استفاده: جلوگیری از خطاهای پارس کردن داده در مراحل بعدی.

14. Calculator

• وظیفه Node: ابزار غیرفعال محاسباتی ایجنت خلاصه‌ساز.

• ورودی: نیازمندی‌های عددی ایجنت.

• خروجی: پاسخ‌های ریاضی.

• تنظیمات مهم: حالت غیرفعال.

• نکات قابل تغییر: امکان فعال‌سازی در صورت نیاز.

• دلیل استفاده: تکمیل ساختار ابزارهای ایجنت در LangChain.

15. Format Notion Page Blocks

• وظیفه Node: ترکیب خروجی هر دو ایجنت و ساخت بلاک‌های متنی استاندارد Notion با کد جاوا اسکریپت.

• ورودی: داده‌های استخراج‌شده از نودهای وظیفه و خلاصه به همراه ID دیتابیس نوشن.

• خروجی: ساختار کامل JSON بلاک‌های نوشن (Paragraph ،Bulleted List ،Divider).

• تنظیمات مهم: توابع ساخت متون غنی (Rich Text) و استخراج شناسه دیتابیس نوشن از لینک کامل.

• نکات قابل تغییر: تغییر نحوه چیدمان بلاک‌ها، تغییر فونت، اضافه کردن خطوط جداکننده بیشتر یا استایل دادن به متن‌ها.

• دلیل استفاده: انعطاف‌پذیری کامل در طراحی نحوه نمایش اطلاعات درون صفحات نوشن.

16. Create Notion Page

• وظیفه Node: ارسال درخواست HTTP POST به Endpoint رسمی Notion API برای ساخت برگه جدید.

• ورودی: بدنه JSON آماده‌شده و توکن اختصاصی Notion از Airtable.

• خروجی: پاسخ موفقیت یا خطای API نوشن.

• تنظیمات مهم: استفاده از Bearer Token پویا و تعیین نسخه هدر Notion-Version: 2022-06-28.

• نکات قابل تغییر: اضافه کردن مشخصات (Properties) بیشتر به صفحه نوشن.

• دلیل استفاده: ثبت مستقیم اطلاعات پردازش‌شده درون دیتابیس نوشن.

17. Add Label “Processed”

• وظیفه Node: علامت‌گذاری ایمیل با برچسب Processed پس از ثبت موفق در نوشن.

• ورودی: شناسه پیام Gmail و شناسه برچسب پردازش‌شده.

• خروجی: بروزرسانی برچسب در Gmail.

• تنظیمات مهم: فراخوانی عملیات addLabels.

• نکات قابل تغییر: انتخاب نام یا شناسه برچسب دیگر.

• دلیل استفاده: مشخص شدن ایمیل‌های پردازش‌شده در صندوق ورودی.

18. Deactivate Route

• وظیفه Node: غیرفعال کردن مسیر در Airtable در صورت بروز خطا در فراخوانی Notion API.

• ورودی: سیگنال خطا از نود Create Notion Page.

• خروجی: به‌روزرسانی فیلد Active به مقدار false.

• تنظیمات مهم: آپدیت رکورد بر اساس شناسه اختصاصی مسیر.

• نکات قابل تغییر: افزودن فیلد دلیل خطا به رکورد Airtable.

• دلیل استفاده: جلوگیری از بروز خطاهای تکراری و مسدودسازی مسیرهای معیوب.

19. Send notification about deactivated route

• وظیفه Node: ارسال ایمیل هشدار به فرستنده در صورت غیرفعال شدن مسیر به علت خطا در نوشن.

• ورودی: آدرس ایمیل فرستنده.

• خروجی: ارسال پیام اطلاع‌رسانی.

• تنظیمات مهم: موضوع و متن ایمیل هشدار دهنده.

• نکات قابل تغییر: سفارشی‌سازی متن ایمیل هشدار.

• دلیل استفاده: مطلع ساختن سریع کاربر از عدم ثبت اطلاعات در نوشن.

20. Add Label “Error”

• وظیفه Node: الصاق برچسب Error به ایمیل‌هایی که با خطا مواجه شده‌اند.

• ورودی: شناسه پیام و شناسه برچسب خطا.

• خروجی: ثبت برچسب خطا روی ایمیل.

• تنظیمات مهم: استفاده از متغیر errorLabelID.

• نکات قابل تغییر: تغییر برچسب خطای مربوطه.

• دلیل استفاده: جداسازی ایمیل‌های ناموفق جهت بررسی دستی.

21. No Operation, do nothing

• وظیفه Node: نود واسط کنترل منطق (NoOp) برای مسیرهایی که غیرفعال هستند یا در Airtable وجود ندارند.

• ورودی: خروجی شرطی از Airtable.

• خروجی: هدایت به مرحله ارسال ایمیل اطلاع‌رسانی نبود مسیر.

• تنظیمات مهم: بدون تنظیمات خاص.

• نکات قابل تغییر: نیازی به تغییر ندارد.

• دلیل استفاده: ساختاردهی شفاف به شاخه‌های شرطی ورک‌فلو.

22. Send notification about missing route

• وظیفه Node: ارسال ایمیل به کاربر در صورت ارسال پیام به آلیاسی که مسیر فعال در Airtable ندارد.

• ورودی: آدرس ایمیل فرستنده.

• خروجی: ارسال پیام راهنما.

• تنظیمات مهم: متن راهنمای مربوط به عدم اتصال آلیاس.

• نکات قابل تغییر: تغییر متن پیام اطلاع‌رسانی.

• دلیل استفاده: راهنمایی کاربر جهت اصلاح آدرس آلیاس یا تنظیمات مسیر.

23. When clicking ‘Test workflow’

• وظیفه Node: محرک دستی (Manual Trigger) جهت اجرای اولیه ورک‌فلو و استخراج برچسب‌های Gmail.

• ورودی: کلیک کاربر در محیط n8n.

• خروجی: اجرای زنجیره استخراج برچسب‌ها.

• تنظیمات مهم: حالت اجرا دستی.

• نکات قابل تغییر: نیازی به تغییر ندارد.

• دلیل استفاده: تسهیل پیکربندی اولیه شناسه برچسب‌ها.

24. Get all labels

• وظیفه Node: دریافت فهرست کامل برچسب‌های موجود در حساب Gmail کاربر.

• ورودی: سیگنال اجرای نود تست دستی.

• خروجی: لیست کامل برچسب‌ها به همراه Name و ID.

• تنظیمات مهم: پارامتر returnAll: true.

• نکات قابل تغییر: ندارد.

• دلیل استفاده: یافتن شناسه واقعی برچسب‌های Error و Processed.

25. Required labels

• وظیفه Node: فیلتر کردن لیست برچسب‌ها و جدا کردن برچسب‌های مرتبط با خطا و پردازش.

• ورودی: تمام برچسب‌های Gmail.

• خروجی: فقط برچسب‌های دارای عبارت Error یا Processed.

• تنظیمات مهم: شروط متنی Contains برای نام برچسب‌ها.

• نکات قابل تغییر: تغییر عبارت شرط متناسب با نام برچسب‌های کاربر.

• دلیل استفاده: آسان‌سازی کپی کردن شناسه‌ها در زمان راه‌اندازی.

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

برای هماهنگ‌سازی این ورک‌فلو با نیازهای سیستم خود می‌توانید بخش‌های زیر را تغییر دهید:

• تغییر Promptها: پرامپت‌های موجود در دو نود AI Agent را بازنویسی کنید تا خروجی وظایف بر اساس استانداردهای مدیریت پروژه شما (مانند چارچوب Scrum یا Eisenhower Matrix) استخراج شوند.

• تغییر مدل AI: می‌توانید به جای مدل gpt-4o از مدل‌های دیگر مانند gpt-4o-mini یا مدل‌های شرکت Anthropic در نودهای Chat Model استفاده کنید.

• تغییر الگوی آلیاس: در صورت استفاده از الگوی متفاوتی برای ایمیل‌های آلیاس، عبارت منظم (Regex) موجود در نود Extract Route ID را تغییر دهید.

• سفارشی‌سازی بلاک‌های نوشن: با ویرایش کدهای جاوا اسکریپت در نود Format Notion Page Blocks می‌توانید ویژگی‌ها (Properties)، رنگ متون، آیکون‌ها و جداکننده‌های جدیدی به صفحه نوشن اضافه کنید.

مزایای استفاده از اتوماسیون انتقال ایمیل به نوشن با n8n

1. مسیریابی پویا و هوشمند: امکان ارسال ایمیل‌ها به چندین دیتابیس مختلف نوشن بر اساس آدرس آلیاس بدون نیاز به ساخت ورک‌فلوهای جداگانه.

2. استخراج هوشمند وظایف: تبدیل ایمیل‌های متنی پیچیده به وظایف مشخص شامل عنوان کوتاه، توضیحات دقیق و نکات اجرایی.

3. خلاصه‌سازی کامل متون: ارائه‌دهنده خلاصه کاربردی از محتوای پیام‌ها به همراه استخراج دقیق فرستنده، موضوع و تاریخ اصلی.

4. مدیریت خطای خودکار: غیرفعال‌سازی هوشمند مسیرهای معیوب در Airtable و ارسال اطلاع‌رسانی فوری به کاربر در صورت بروز خطا.

5. امنیت بالای اطلاعات: عدم ذخیره سخت‌افزاری (Hardcode) توکن‌ها و استفاده از Airtable به عنوان پایگاه داده امن برای مدیریت دسترسی‌ها.

6. کاهش شدید هزینه‌های زمانی: حذف کامل فرآیند زمان‌بر ثبت دستی اطلاعات از ایمیل به ابزارهای مدیریت پروژه.

نکات مهم برای ذخیره صفحات Notion در Supabase با n8n

1. تنظیم اولیه Globals: در اولین راه‌اندازی، حتماً یک‌بار نود When clicking ‘Test workflow’ را اجرا کرده و شناسه واقعی برچسب‌های Gmail را در نود Globals وارد کنید.

2. اعطای دسترسی در نوشن: اینتگریشن نوشن شما باید حتماً به تمام دیتابیس‌های هدف دسترسی (Access) داشته باشد؛ در غیر این صورت با خطای عدم احراز هویت مواجه خواهید شد.

3. پشتیبانی از Plus Addressing: مطمئن شوید سرویس‌دهنده ایمیل شما از قابلیت آدرس‌دهی با علامت + (آلیاس) پشتیبانی می‌کند (Gmail به‌صورت پیش‌فرض پشتیبانی می‌کند).

4. ساختار جدول Airtable: جدول Routes در Airtable باید دقیقاً شامل فیلدهای id ،Token ،NotionDatabase و Active باشد.

5. پایش مصرف OpenAI: به دلیل استفاده از دو ایجنت هوش مصنوعی، میزان مصرف توکن‌های API حساب OpenAI خود را کنترل کنید.

6. جلوگیری از اسپم: می‌توانید شروط فیلتر بیشتری در نود Filter for unprocessed mails برای مسدودسازی فرستنده‌های نامعتبر قرار دهید.

7. فرمت لینک نوشن در Airtable: لینک دیتابیس نوشن در Airtable باید حاوی URL کامل شامل شناسه ۳۲ کاراکتری دیتابیس باشد.

8. غیرفعال‌سازی نودهای تست: پس از اتمام پیکربندی اولیه، نودهای مربوط به تست دستی برچسب‌ها را غیرفعال نگه دارید.

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

۱. خطای عدم استخراج Route ID از ایمیل

• علت: ایمیل دریافتی فاقد علامت + یا ساختار آلیاس تعریف‌شده در عبارت منظم است.

• راه‌حل: ایمیل را حتماً به آدرسی با فرمت name+routeid@domain.com ارسال کرده یا کد رگکس نود Extract Route ID را متناسب با الگوی خود ویرایش کنید.

۲. خطای 401 Unauthorized در نود Create Notion Page

• علت: توکن Notion واردشده در جدول Airtable معتبر نیست یا دسترسی Integration به دیتابیس مربوطه اعطا نشده است.

• راه‌حل: توکن API نوشن را بررسی کنید و از بخش Share در دیتابیس نوشن، دسترسی ساختار Integration را فعال نمایید.

۳. خطای Record not found در Airtable

• علت: شناسه Route استخراج‌شده از ایمیل با فیلد id هیچ‌یک از رکوردهای جدول Airtable مطابقت ندارد.

• راه‌حل: شناسه رکورد را در Airtable بررسی کنید و از یکسان بودن آن با بخش آلیاس ایمیل مطمئن شوید.

۴. عدم پردازش ایمیل‌ها و اجرا نشدن ورک‌فلو

• علت: ورک‌فلو در حالت Active قرار ندارد یا برچسب‌های Error یا Processed از قبل روی ایمیل وجود دارند.

• راه‌حل: وضعیت ورک‌فلو را در محیط n8n به Active تغییر دهید و برچسب‌های قبلی را از روی ایمیل تست پاک کنید.

۵. خطای Rate Limit در نودهای OpenAI

• علت: اتمام اعتبار حساب OpenAI یا ارسال درخواست‌های بیش از حد مجاز در دقیقه.

• راه‌حل: اعتبار مالی حساب OpenAI را بررسی کنید یا مدل زبانی سبک‌تری را در نودهای Chat Model انتخاب نمایید.

جمع‌بندی

اتوماسیون انتقال ایمیل به نوشن با n8n یکی از قدرتمندترین راهکارها برای بهینه‌سازی جریان کاری و دستیابی به مدیریت هوشمندانه صندوق ورودی است. در این الگوی پیشرفته (mails2notion V2)، ترکیب قابلیت‌های قدرتمند مسیریابی پویای Airtable، پردازش هوشمند زبان طبیعی با OpenAI GPT-4o و انعطاف‌پذیری بی‌نظیر n8n، سیستمی استثنایی را ایجاد کرده است که تمام ایمیل‌های مهم کاری شما را بدون نیاز به مداخله دستی به وظایف و اسناد طبقه‌بندی‌شده در نوشن تبدیل می‌کند.

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

سوالات متداول در مورد ذخیره صفحات Notion در Supabase با n8n

۱. آیا برای استفاده از این ورک‌فلو حتماً باید حساب پولی OpenAI داشته باشیم؟

بله، جهت استفاده از API مدل GPT-4o نیاز به حساب OpenAI با اعتبار فعال (Credit) دارید، زیرا ایجنت‌های هوش مصنوعی برای استخراج اطلاعات و خلاصه‌سازی متون از این API استفاده می‌کنند.

۲. آیا امکان اتصال ایمیل‌ها به چندین دیتابیس مختلف نوشن وجود دارد؟

بله، این ورک‌فلو کاملاً پویا طراحی شده است. شما می‌توانید در جدول Airtable رکوردهای متعددی بسازید و هر آلیاس ایمیل را به یک دیتابیس مجزای نوشن متصل کنید.

۳. چگونه می‌توانم برچسب‌های اختصاصی خود را در Gmail جایگزین کنم؟

کافیست برچسب‌های دلخواه خود را در Gmail بسازید، سپس با اجرای یک‌باره نودهای بخش Setup شناسه برچسب‌ها را به دست آورده و در نود Globals جایگزین کنید.

۴. اگر ایمیلی فوروارد شده باشد، هوش مصنوعی فرستنده اصلی را تشخیص می‌دهد؟

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

۵. در صورت قطع شدن ارتباط با نوشن چه اتفاقی می‌افتد؟

ورک‌فلو به صورت خودکار خطا را مدیریت کرده، مسیر مربوطه را در Airtable غیرفعال می‌کند، برچسب Error را روی ایمیل می‌زند و یک ایمیل اطلاع‌رسانی شامل علت خطا برای شما ارسال می‌نماید.

GIT