مدیریت هوشمند مخاطبین Notion با n8n بر اساس ایمیل

مدیریت مخاطبین در Notion: افزودن، به‌روزرسانی و دریافت بر اساس ایمیل

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

دسته‌بندی‌ها: CRM، ادغام با Notion، مدیریت مخاطبین

کاتالوگ Axeto.ai: Workflows n8n

نمای کلی Workflow

این Workflow برای تعامل با یک پایگاه داده Notion جهت انجام وظایف مدیریت مخاطبین طراحی شده است. این Workflow درخواست‌های ورودی را بر اساس فیلد action در payload JSON مسیریابی می‌کند و امکان عملیات انعطاف‌پذیر را فراهم می‌آورد:

• create: مخاطب جدیدی را به پایگاه داده Notion اضافه می‌کند. اگر مخاطبی با همان ایمیل از قبل وجود داشته باشد، عملیات برای جلوگیری از ایجاد موارد تکراری مسدود می‌شود.
• update: مخاطب موجود را بر اساس ایمیل پیدا کرده و خصوصیات آن را به‌روزرسانی می‌کند.
• get: جزئیات یک مخاطب را بر اساس آدرس ایمیل آن دریافت می‌کند.

مورد استفاده اصلی این Workflow، ارائه یک سیستم CRM سبک است که در آن آدرس‌های ایمیل به عنوان کلیدهای منحصربه‌فرد برای رکوردهای مخاطب عمل می‌کنند. در حالی که این Workflow در حال حاضر برای اجرای دستی با داده‌های نمونه پیکربندی شده است، ساختار آن برای انطباق آسان با رویکرد مبتنی بر API با استفاده از یک Trigger وب‌هوک (Webhook) سازماندهی شده است.

ساختار Workflow

این Workflow به بلوک‌های مجزا سازماندهی شده است که هر کدام جنبه خاصی از فرآیند مدیریت مخاطبین را مدیریت می‌کنند.

۱. دریافت و مسیریابی ورودی

این بلوک اولیه داده‌های ورودی را دریافت کرده و اجرای Workflow را بر اساس پارامتر action به شاخه مناسب هدایت می‌کند.

• Nodes:

* Manual Trigger (n8n-nodes-base.manualTrigger): Workflow را برای تست و توسعه آغاز می‌کند. این Node با داده‌های JSON نمونه شامل name, email, notes, phone, action (create) و status پیکربندی شده است.

* Switch1 (n8n-nodes-base.switch): به عنوان یک مسیریاب عمل می‌کند. فیلد $json.action را ارزیابی کرده و جریان داده را به یکی از سه خروجی متناظر با create, update یا get هدایت می‌کند.

* Sticky Note — Main (n8n-nodes-base.stickyNote): مستنداتی در مورد رفتار Workflow، راه‌اندازی و توصیه‌هایی برای استفاده در محیط عملیاتی ارائه می‌دهد.

* Sticky Note — Switch (n8n-nodes-base.stickyNote): توضیحی بصری از منطق مسیریابی در Node Switch1 ارائه می‌دهد.

۲. شاخه ایجاد مخاطب

این شاخه به افزودن مخاطبین جدید می‌پردازد و اطمینان حاصل می‌کند که موارد تکراری ایجاد نمی‌شوند.

• Nodes:

* Search — Email Exists? (n8n-nodes-base.notion): پایگاه داده Notion را با استفاده از ایمیل ارائه شده برای بررسی وجود رکوردهای موجود جستجو می‌کند. از منبع databasePage با عملیات getAll و یک فیلتر دستی برای خصوصیت Email استفاده می‌کند. limit روی 1 تنظیم شده و alwaysOutputData فعال است.

* Already Exists? (n8n-nodes-base.if): با بررسی وجود id، تعیین می‌کند که آیا جستجوی قبلی نتیجه‌ای بازگردانده است یا خیر.

* اگر true (مخاطب وجود دارد)، اجرا به Block Duplicate ادامه می‌یابد.

* اگر false (مخاطب وجود ندارد)، اجرا به Notion — Create Person1 ادامه می‌یابد.

* Block Duplicate (n8n-nodes-base.respondToWebhook): اگر مخاطب تکراری پیدا شود، این Node یک پیام خطای JSON برمی‌گرداند که نشان می‌دهد مخاطب از قبل وجود دارد و عملیات update را پیشنهاد می‌کند.

* Notion — Create Person1 (n8n-nodes-base.notion): یک صفحه جدید در پایگاه داده Notion مشخص شده ایجاد می‌کند. داده‌های ورودی (name, email, phone, status, notes) را به خصوصیات Notion مربوطه نگاشت می‌کند. فیلد Title با استفاده از name مخاطب تنظیم می‌شود.

* Sticky Note — Create (n8n-nodes-base.stickyNote): منطق جلوگیری از ایجاد مخاطب تکراری را قبل از افزودن یک ورودی جدید مستند می‌کند.

۳. شاخه به‌روزرسانی مخاطب

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

• Nodes:

* Search — Find by Email (n8n-nodes-base.notion): پایگاه داده Notion را برای یافتن مخاطبی که با ایمیل ارائه شده مطابقت دارد، جستجو می‌کند، مشابه بررسی در شاخه ایجاد، اما به طور خاص برای اهداف به‌روزرسانی.

* Person Found? (n8n-nodes-base.if): با تأیید وجود id، بررسی می‌کند که آیا پرس‌وجوی جستجو یک رکورد مخاطب را بازگردانده است یا خیر.

* اگر true (مخاطب پیدا شد)، اجرا به Notion — Update Person1 ادامه می‌یابد.

* اگر false (مخاطب پیدا نشد)، اجرا به Not Found Error ادامه می‌یابد.

* Not Found Error (n8n-nodes-base.respondToWebhook): اگر هیچ مخاطبی با ایمیل ارائه شده مطابقت نداشته باشد، این Node یک پیام خطای JSON برمی‌گرداند که نشان می‌دهد مخاطب پیدا نشده است.

* Notion — Update Person1 (n8n-nodes-base.notion): یک صفحه موجود در پایگاه داده Notion را به‌روزرسانی می‌کند. از منبع databasePage با عملیات update استفاده می‌کند. صفحه‌ای که باید به‌روزرسانی شود با id آن (که از جستجو به دست آمده) شناسایی می‌شود و خصوصیات مشخص شده (name, email, phone, status, notes) با داده‌های ورودی به‌روزرسانی می‌شوند.

* Sticky Note — Update (n8n-nodes-base.stickyNote): مستنداتی برای فرآیند به‌روزرسانی مخاطب، از جمله یافتن رکورد بر اساس ایمیل قبل از تغییر، ارائه می‌دهد.

۴. شاخه دریافت مخاطب

این شاخه مسئول دریافت اطلاعات مخاطب است.

• Nodes:

* Notion — Get Person1 (n8n-nodes-base.notion): داده‌های مخاطب را از پایگاه داده Notion دریافت می‌کند. از منبع databasePage با عملیات get و یک فیلتر دستی برای یافتن صفحه‌ای که با ایمیل ارائه شده مطابقت دارد، استفاده می‌کند.

* Sticky Note — Get (n8n-nodes-base.stickyNote): فرآیند دریافت جزئیات مخاطب با استفاده از آدرس ایمیل را مستند می‌کند.

۵. مدیریت پاسخ

هر شاخه عملیاتی با یک مکانیزم پاسخ به پایان می‌رسد که برای ارائه بازخورد به فراخواننده طراحی شده است.

• Nodes:

* Respond (n8n-nodes-base.respondToWebhook): این Node در انتهای شاخه‌های create و get وجود دارد. این Node برای بازگرداندن یک پاسخ JSON حاوی داده‌های مخاطب تازه ایجاد شده یا خصوصیات مخاطب دریافت شده پیکربندی شده است.

* Respond to Webhook (در Block Duplicate و Not Found Error): این Nodes پیام‌های خطای JSON خاصی را هنگام شناسایی مخاطبین تکراری یا زمانی که مخاطبی در طول عملیات به‌روزرسانی یا دریافت یافت نمی‌شود، برمی‌گردانند.

توجه: در حالی که Nodes Respond to Webhook برای پاسخ‌های وب‌هوک پیکربندی شده‌اند، کاربرد کامل آن‌ها زمانی محقق می‌شود که Manual Trigger با یک Trigger وب‌هوک (Webhook) برای استفاده از API در محیط عملیاتی جایگزین شود.