این گردش کار چگونه KlickTipp را با هوش مصنوعی ادغام میکند؟

این گردش کار از MCP Server به عنوان یک رابط برای دریافت دستورات زبان طبیعی استفاده میکند. سپس این دستورات توسط نودهای KlickTipp تفسیر شده و با استفاده از عبارات خاص `$fromAI()`، پارامترهای لازم برای عملیات KlickTipp استخراج میشود.

چه عملیاتی را میتوان با این گردش کار روی مخاطبین KlickTipp انجام داد؟

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

آیا برای استفاده از این گردش کار نیاز به دانش برنامهنویسی است؟

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

مدیریت هوشمند مخاطبین KlickTipp با هوش مصنوعی و MCP Server

مدیریت مخاطبین با هوش مصنوعی در KlickTipp با استفاده از MCP Server

این گردش کار، MCP Server را با KlickTipp ادغام می‌کند و از یک مدل زبانی بزرگ (LLM) برای مدیریت هوشمند مخاطبین استفاده می‌کند. این امکان پرس‌وجوی زبان طبیعی، بخش‌بندی و عملیات خودکار مخاطبین را در KlickTipp فراهم می‌کند.

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

جستجوی پویا مخاطبین
برچسب‌گذاری و بخش‌بندی
عملیات خودکار مخاطبین
راه‌اندازی کمپین
مدیریت فرآیند تأیید (Opt-in)

این گردش کار و موارد دیگر را در کاتالوگ n8n شرکت Axeto.ai کاوش کنید.

---

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

این گردش کار به چندین بلوک عملکردی تقسیم شده است:

۱. دریافت ورودی از طریق تریگر MCP Server

مرور کلی: این بلوک به عنوان نقطه ورود گردش کار عمل می‌کند و درخواست‌های ورودی MCP Server را در یک مسیر وب‌هوک مشخص گوش می‌دهد. سپس داده‌های دریافتی را به نودهای پردازش هوش مصنوعی ارسال می‌کند.
نودها:

* MCP Server Trigger (@n8n/n8n-nodes-langchain.mcpTrigger)

* پیکربندی: در مسیر وب‌هوک "klicktipp-mcp" گوش می‌دهد.

* ورودی: درخواست‌های HTTP ورودی خارجی از طریق MCP Server.

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

* موارد استثنا: خطاهای احتمالی احراز هویت وب‌هوک یا اتصال، داده‌های ورودی نامعتبر.

* نکات: به عنوان تریگر مرکزی برای تمام عملیات بعدی عمل می‌کند.

۲. استخراج و پردازش داده با قدرت هوش مصنوعی

مرور کلی: این گردش کار، ادغام هوش مصنوعی را مستقیماً در نودهای عملیاتی KlickTipp تعبیه می‌کند. ورودی زبان طبیعی از MCP Server Trigger با استفاده از عبارات $fromAI() برای استخراج پارامترهای ساختاریافته برای فراخوانی API KlickTipp تفسیر می‌شود.
نودها: نود LLM اختصاصی وجود ندارد؛ ادغام هوش مصنوعی از طریق عبارات در نودهای KlickTipp حاصل می‌شود.
جزئیات نود:

* عباراتی مانند {{$fromAI("fieldName", "Description", "type", "default")}} در نودهای KlickTipp برای درخواست داده‌های خاص از تفسیر LLM استفاده می‌شوند.

* موارد استثنا: هوش مصنوعی ممکن است داده‌های ناقص یا غیرمنتظره‌ای را برگرداند. در صورت نامعتبر بودن خروجی هوش مصنوعی، ممکن است ارزیابی عبارات با شکست مواجه شود.

۳. عملیات مدیریت مخاطبین

مرور کلی: این بلوک تمام عملیات مربوط به مشترکین را مدیریت می‌کند، از جمله افزودن، به‌روزرسانی، بازیابی، لیست کردن، لغو اشتراک و حذف مخاطبین.
نودها:

* Add or Update Contact (n8n-nodes-klicktipp.klicktippTool)

* عملیات: subscribe (بر اساس ایمیل اضافه یا به‌روزرسانی می‌کند).

* پارامترها: از متغیرهای هوش مصنوعی برای ایمیل، تگ‌ها، فیلدهای داده (نام، آدرس، تلفن‌ها، تاریخ تولد، ارزش سرنخ، وب‌سایت)، شناسه تأیید (opt-in ID) و شماره پیامک استفاده می‌کند.

* اعتبارنامه‌ها: به اعتبارنامه‌های API KlickTipp نیاز دارد.

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

* Update Contact (n8n-nodes-klicktipp.klicktippTool)

* عملیات: به‌روزرسانی مشترک بر اساس شناسه.

* پارامترها: فیلدهای داده مبتنی بر هوش مصنوعی مشابه "Add or Update Contact".

* موارد استثنا: شناسه مخاطب یافت نشد، به‌روزرسانی‌های جزئی، فرمت‌های نامعتبر داده.

* Get Contact (n8n-nodes-klicktipp.klicktippTool)

* عملیات: بازیابی مشترک بر اساس شناسه.

* موارد استثنا: شناسه مخاطب ناموجود، خطاهای شبکه/API.

* List Contacts (n8n-nodes-klicktipp.klicktippTool)

* عملیات: لیست کردن مشترکین برای دریافت شناسه‌های مخاطب.

* موارد استثنا: مجموعه داده‌های بزرگ، محدودیت نرخ API.

* Delete Contact (n8n-nodes-klicktipp.klicktippTool)

* عملیات: حذف مشترک بر اساس شناسه.

* موارد استثنا: تلاش برای حذف مخاطبین ناموجود، مشکلات مجوز.

* Unsubscribe Contact (n8n-nodes-klicktipp.klicktippTool)

* عملیات: لغو اشتراک مشترک بر اساس ایمیل.

* موارد استثنا: مخاطب یافت نشد، خطاهای فرمت ایمیل.

* Get Contact ID (n8n-nodes-klicktipp.klicktippTool)

* عملیات: جستجوی مشترک بر اساس ایمیل برای برگرداندن شناسه مخاطب.

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

۴. عملیات تگ‌گذاری مخاطبین

مرور کلی: فرآیند تگ‌گذاری و حذف تگ از مخاطبین و همچنین لیست کردن مخاطبین مرتبط با تگ‌های خاص را مدیریت می‌کند.
نودها:

* Tag Contact (n8n-nodes-klicktipp.klicktippTool)

* عملیات: افزودن یک یا چند تگ به مخاطب بر اساس ایمیل. تگ‌ها از ورودی آرایه JSON هوش مصنوعی تجزیه شده و به شناسه‌های عددی نگاشت می‌شوند.

* موارد استثنا: شناسه‌های تگ نامعتبر، مخاطب یافت نشد.

* Untag Contact (n8n-nodes-klicktipp.klicktippTool)

* عملیات: حذف یک تگ از مخاطب بر اساس ایمیل.

* موارد استثنا: تگ یا مخاطب وجود ندارد.

* List Tagged Contacts (n8n-nodes-klicktipp.klicktippTool)

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

* موارد استثنا: نتایج خالی، شناسه تگ نامعتبر.

۵. مدیریت تگ‌ها

مرور کلی: امکان ایجاد، بازیابی، به‌روزرسانی، حذف و لیست کردن تگ‌ها در KlickTipp را فراهم می‌کند.
نودها:

* List Tags (n8n-nodes-klicktipp.klicktippTool)

* عملیات: برگرداندن تمام شناسه‌ها و نام‌های تگ.

* موارد استثنا: تعداد زیاد تگ، محدودیت نرخ API.

* Create Tag (n8n-nodes-klicktipp.klicktippTool)

* عملیات: ایجاد یک تگ دستی جدید با نام و توضیحات ارائه شده توسط هوش مصنوعی.

* موارد استثنا: نام‌های تگ تکراری، ورودی نامعتبر.

* Get Tag (n8n-nodes-klicktipp.klicktippTool)

* عملیات: بازیابی اطلاعات دقیق برای یک تگ خاص بر اساس شناسه آن.

* موارد استثنا: شناسه تگ یافت نشد.

* Update Tag (n8n-nodes-klicktipp.klicktippTool)

* عملیات: به‌روزرسانی نام و توضیحات یک تگ بر اساس شناسه آن.

* موارد استثنا: تگ یافت نشد، داده‌های به‌روزرسانی نامعتبر.

* Delete Tag (n8n-nodes-klicktipp.klicktippTool)

* عملیات: حذف یک تگ بر اساس شناسه آن.

* موارد استثنا: تگ در حال استفاده است، محدودیت‌های حذف.

۶. مدیریت فرآیند تأیید (Opt-in)

مرور کلی: لیست کردن و بازیابی اطلاعات دقیق در مورد فرآیندهای تأیید را مدیریت می‌کند.
نودها:

* List Opt-in Processes (n8n-nodes-klicktipp.klicktippTool)

* عملیات: لیست کردن تمام شناسه‌ها و نام‌های فرآیند تأیید.

* موارد استثنا: لیست خالی، خطاهای API.

* Get Opt-in Process (n8n-nodes-klicktipp.klicktippTool)

* عملیات: برگرداندن داده‌های دقیق برای یک شناسه فرآیند تأیید مشخص.

* موارد استثنا: شناسه تأیید نامعتبر.

۷. عملیات فیلدهای داده

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

* List Data Fields (n8n-nodes-klicktipp.klicktippTool)

* عملیات: لیست کردن شناسه‌ها و نام‌های تمام فیلدهای داده موجود.

* موارد استثنا: خطاهای API.

* Get Data Field (n8n-nodes-klicktipp.klicktippTool)

* عملیات: بازیابی اطلاعات دقیق برای یک فیلد داده خاص بر اساس شناسه آن.

* موارد استثنا: شناسه فیلد نامعتبر.

۸. بازیابی URL هدایت مجدد

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

* Get Redirect URL (n8n-nodes-klicktipp.klicktippTool)

* پارامترها: ایمیل مخاطب و شناسه فرآیند تأیید.

* خروجی: URL هدایت مجدد را برای فرآیند تأیید و مخاطب مشخص شده برمی‌گرداند.

* موارد استثنا: مخاطب یا فرآیند تأیید یافت نشد.

۹. ابزارهای کمکی

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

Timestamp to date (n8n-nodes-base.stickyNote - نکته: این یک جایگزین است، نود واقعی یک نود Function خواهد بود*)

* عملکرد: مُهر زمانی یونیکس (بر حسب ثانیه) را به رشته‌های تاریخ فرمت‌بندی شده، با استفاده از منطقه زمانی Europe/Berlin تبدیل می‌کند.

* موارد استثنا: ورودی مُهر زمانی نامعتبر منجر به یک رشته خالی می‌شود.

Date to timestamp (n8n-nodes-base.stickyNote - نکته: این یک جایگزین است، نود واقعی یک نود Function خواهد بود*)

* عملکرد: فرمت‌های مختلف تاریخ قابل خواندن توسط انسان را به مُهر زمانی یونیکس (بر حسب ثانیه) تبدیل می‌کند، با در نظر گرفتن منطقه زمانی Europe/Berlin. از چندین فرمت پشتیبانی می‌کند و در صورت شکست به تجزیه ISO و SQL بازمی‌گردد.

* موارد استثنا: در صورت شکست تجزیه تاریخ به دلیل فرمت‌های نامعتبر یا پشتیبانی نشده، "N/A" را برمی‌گرداند.

---

جدول خلاصه

نام نود (Node Name)	نوع نود (Node Type)	نقش عملکردی (Functional Role)	نود(های) ورودی (Input Node(s))	نود(های) خروجی (Output Node(s))	یادداشت چسبان (Sticky Note)
MCP Server Trigger	`@n8n/n8n-nodes-langchain.mcpTrigger`	تریگر ورودی برای درخواست‌های MCP	Webhook خارجی (External webhook)	تمام نودهای عملیات KlickTipp (All KlickTipp operation nodes)
Add or Update Contact	`n8n-nodes-klicktipp.klicktippTool`	افزودن یا به‌روزرسانی مشترک	MCP Server Trigger	None	## مدیریت مخاطبین (Contact Management)
Update Contact	`n8n-nodes-klicktipp.klicktippTool`	به‌روزرسانی مشترک بر اساس شناسه (ID)	MCP Server Trigger	None	## مدیریت مخاطبین (Contact Management)
Get Contact	`n8n-nodes-klicktipp.klicktippTool`	دریافت داده‌های مشترک بر اساس شناسه (ID)	MCP Server Trigger	None	## مدیریت مخاطبین (Contact Management)
List Contacts	`n8n-nodes-klicktipp.klicktippTool`	لیست شناسه‌های مشترک (Subscriber IDs)	MCP Server Trigger	None	## مدیریت مخاطبین (Contact Management)
Delete Contact	`n8n-nodes-klicktipp.klicktippTool`	حذف مشترک بر اساس شناسه (ID)	MCP Server Trigger	None	## مدیریت مخاطبین (Contact Management)
Unsubscribe Contact	`n8n-nodes-klicktipp.klicktippTool`	لغو اشتراک مشترک بر اساس ایمیل	MCP Server Trigger	None	## مدیریت مخاطبین (Contact Management)
Get Contact ID	`n8n-nodes-klicktipp.klicktippTool`	جستجوی شناسه مشترک بر اساس ایمیل	MCP Server Trigger	None	## مدیریت مخاطبین (Contact Management)
Tag Contact	`n8n-nodes-klicktipp.klicktippTool`	افزودن تگ به مخاطب	MCP Server Trigger	None	## تگ‌گذاری مخاطبین (Contact Tagging)
Untag Contact	`n8n-nodes-klicktipp.klicktippTool`	حذف تگ از مخاطب	MCP Server Trigger	None	## تگ‌گذاری مخاطبین (Contact Tagging)
List Tagged Contacts	`n8n-nodes-klicktipp.klicktippTool`	لیست مخاطبین بر اساس تگ	MCP Server Trigger	None	## تگ‌گذاری مخاطبین (Contact Tagging)
List Tags	`n8n-nodes-klicktipp.klicktippTool`	لیست تمام تگ‌ها	MCP Server Trigger	None	## مدیریت تگ‌ها (Tag Management)
Create Tag	`n8n-nodes-klicktipp.klicktippTool`	ایجاد تگ جدید	MCP Server Trigger	None	## مدیریت تگ‌ها (Tag Management)
Get Tag	`n8n-nodes-klicktipp.klicktippTool`	دریافت جزئیات تگ بر اساس شناسه (ID)	MCP Server Trigger	None	## مدیریت تگ‌ها (Tag Management)
Update Tag	`n8n-nodes-klicktipp.klicktippTool`	به‌روزرسانی تگ بر اساس شناسه (ID)	MCP Server Trigger	None	## مدیریت تگ‌ها (Tag Management)
Delete Tag	`n8n-nodes-klicktipp.klicktippTool`	حذف تگ بر اساس شناسه (ID)	MCP Server Trigger	None	## مدیریت تگ‌ها (Tag Management)
List Opt-in Processes	`n8n-nodes-klicktipp.klicktippTool`	لیست فرآیندهای تأیید (Opt-in processes)	MCP Server Trigger	None	## مدیریت فرآیندهای تأیید (Opt-in Process Handling)
Get Opt-in Process	`n8n-nodes-klicktipp.klicktippTool`	دریافت جزئیات فرآیند تأیید	MCP Server Trigger	None	## مدیریت فرآیندهای تأیید (Opt-in Process Handling)
List Data Fields	`n8n-nodes-klicktipp.klicktippTool`	لیست فیلدهای داده سفارشی	MCP Server Trigger	None	## عملیات فیلدهای داده (Data Field Operations)
Get Data Field	`n8n-nodes-klicktipp.klicktippTool`	دریافت جزئیات فیلد داده بر اساس شناسه (ID)	MCP Server Trigger	None	## عملیات فیلدهای داده (Data Field Operations)
Get Redirect URL	`n8n-nodes-klicktipp.klicktippTool`	دریافت URL هدایت مجدد تأیید (Opt-in redirect URL)	MCP Server Trigger	None	## بازیابی URL هدایت مجدد (Redirect URL Retrieval)
Timestamp to date	`n8n-nodes-base.stickyNote` (Function)	تبدیل مُهر زمانی یونیکس (Unix timestamp) به تاریخ	MCP Server Trigger	None	## ابزارهای کمکی (Utility Tools)
Date to timestamp	`n8n-nodes-base.stickyNote` (Function)	تبدیل رشته تاریخ به مُهر زمانی یونیکس (Unix timestamp)	MCP Server Trigger	None	## ابزارهای کمکی (Utility Tools)