اتوماسیون ایمیل سرد با هوش مصنوعی و n8n: افزایش فروش

هوش مصنوعی برای ارتباط با مشتریان بالقوه و ردیابی با Gmail، GPT-4 و توالی ایمیل

این گردش کار، ارتباط با مشتریان بالقوه و ردیابی ایمیل را با ادغام Google Sheets، OpenAI GPT-4، Gmail و APIهای ردیابی InboxPlus خودکار می‌کند. این سیستم برای تیم‌های فروش و بازاریابی طراحی شده است که به دنبال ارسال ایمیل‌های سرد و شخصی‌سازی شده در مقیاس بزرگ و در عین حال نظارت بر تعامل از طریق ردیابی ایمیل هستند.

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

۱. بازیابی و پیمایش داده‌ها: به طور دوره‌ای لیدهای در انتظار را از یک Google Sheet دریافت کرده و آن‌ها را برای پردازش فردی آماده می‌کند.

۲. تولید ایمیل با هوش مصنوعی و ایجاد شناسه ردیابی: از GPT-4 از طریق Langchain برای ایجاد محتوای ایمیل ارتباطی شخصی‌سازی شده استفاده کرده و یک شناسه ردیابی منحصربه‌فرد از InboxPlus دریافت می‌کند.

۳. ارسال ایمیل، دریافت پیام و شروع توالی ردیابی: ایمیل تولید شده را از طریق Gmail ارسال کرده، جزئیات پیام ارسال شده را بازیابی می‌کند، ردیابی را با InboxPlus آغاز کرده و وضعیت لید را در Google Sheet به‌روزرسانی می‌کند.

---

۱. بازیابی و پیمایش داده‌ها

این بخش مسئول دریافت اولیه لیدها از Google Sheet شما و آماده‌سازی آن‌ها برای مراحل بعدی مبتنی بر هوش مصنوعی است.

نودهای درگیر:

• Schedule Trigger
• Get row(s) in sheet
• Loop Over Items

جزئیات نود:

• Schedule Trigger

* نوع: scheduleTrigger

* نقش: اجرای گردش کار را روزانه در ساعت ۱۳:۰۰ (ساعت ۱ بعد از ظهر) آغاز می‌کند.

* پیکربندی: برای فعال شدن روزانه در ساعت 13 تنظیم شده است.

* ورودی‌ها: ندارد.

* خروجی‌ها: به Get row(s) in sheet متصل می‌شود.

* موارد خاص: اگر نمونه n8n در زمان برنامه‌ریزی شده آفلاین یا متوقف باشد، گردش کار اجرا نخواهد شد.

• Get row(s) in sheet

* نوع: googleSheets

* نقش: ردیف‌ها را از یک Google Sheet که ستون "Status" آن "Pending" است، می‌خواند.

* پیکربندی:

* documentId: 16vN03K8d0zjNpmMORi26Bu_juodIDZdeujzVm0lvz0o

* sheetName: gid=0 (Sheet1)

* filter: Status = Pending

* ورودی‌ها: توسط Schedule Trigger فعال می‌شود.

* خروجی‌ها: ردیف‌های مطابق با شرط فیلتر، که به Loop Over Items ارسال می‌شوند.

* اعتبارنامه‌ها: از اعتبارنامه‌های Google Sheets OAuth2 به نام "Google Sheets account - (DEV)" استفاده می‌کند.

* موارد خاص:

* هیچ ردیفی با فیلتر مطابقت ندارد: گردش کار بدون پردازش هیچ لیدی ادامه می‌یابد.

* محدودیت‌های نرخ API یا شکست احراز هویت.

• Loop Over Items

* نوع: splitInBatches

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

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

* ورودی‌ها: ردیف‌ها از Get row(s) in sheet.

* خروجی‌ها: هر مورد لید به صورت جداگانه به AI Agent ارسال می‌شود.

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

---

۲. تولید ایمیل با هوش مصنوعی و ایجاد شناسه ردیابی

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

گره‌های (Nodes) درگیر:

• AI Agent
• OpenAI Chat Model
• Structured Output Parser
• Generates Tracking ID

جزئیات گره‌ها:

• AI Agent

* نوع: langchainAgent

* نقش: تولید یک موضوع ایمیل شخصی‌سازی شده و بدنه HTML برای هر سرنخ در قالب JSON.

* پیکربندی:

* دستورالعمل (prompt) با دقت تنظیم شده است تا GPT-4 را برای تولید یک ایمیل خوش‌آمدگویانه، حرفه‌ای و مختصر برای ارتباطات سرد هدایت کند. این دستورالعمل بر قالب‌بندی دقیق HTML تأکید دارد و شامل جای‌نگاه‌هایی برای داده‌های سرنخ مانند Name، Email و Number است.

* خروجی به گونه‌ای پیکربندی شده است که یک شیء JSON تک‌خطی با کلیدهای subject و body باشد.

* این گره به OpenAI Chat Model به عنوان مدل زبانی خود متصل می‌شود.

* Structured Output Parser برای اجبار قالب خروجی JSON استفاده می‌شود.

* ورودی‌ها: یک مورد سرنخ از Loop Over Items.

* خروجی‌ها: JSON حاوی subject و body ایمیل، که به Generates Tracking ID منتقل می‌شود.

* موارد مرزی (Edge Cases):

* خطاهای API مربوط به GPT-4 (مانند محدودیت‌های نرخ، قطع شدن ارتباط).

* خطاهای تجزیه (parsing) در صورتی که خروجی هوش مصنوعی بدشکل باشد یا JSON معتبر نباشد.

* فیلدهای سرنخ گمشده در داده‌های ورودی می‌تواند بر اجرای دستورالعمل تأثیر بگذارد.

• OpenAI Chat Model

* نوع: langchainLmChatOpenAi

* نقش: ارائه مدل زبانی GPT-4.1-mini برای AI Agent.

* پیکربندی: مدل روی gpt-4.1-mini تنظیم شده است.

* اعتبارنامه‌ها (Credentials): کلید API OpenAI با نام "OpenAi account" پیکربندی شده است.

* ورودی‌ها: دستورالعمل (prompt) از AI Agent.

* خروجی‌ها: پاسخ خام مدل، که سپس توسط AI Agent پردازش می‌شود.

* موارد مرزی (Edge Cases): شکست احراز هویت، اتمام سهمیه API، یا مشکلات اتصال شبکه.

• Structured Output Parser

* نوع: langchainOutputParserStructured

* نقش: تجزیه خروجی مدل هوش مصنوعی برای اطمینان از انطباق آن با ساختار JSON مشخص، که نیازمند کلیدهای subject و body است.

* پیکربندی: یک مثال طرحواره JSON (JSON schema) برای اجبار کلیدهای دقیق مورد نیاز برای موضوع و بدنه ارائه شده است.

* ورودی‌ها: خروجی خام هوش مصنوعی از OpenAI Chat Model.

* خروجی‌ها: داده‌های JSON ساختاریافته، که به AI Agent بازگردانده می‌شود.

* موارد مرزی (Edge Cases): شکست تجزیه در صورتی که خروجی هوش مصنوعی به طور قابل توجهی از فرمت مورد انتظار منحرف شود.

• Generates Tracking ID

* نوع: httpRequest

* نقش: فراخوانی API InboxPlus برای تولید یک شناسه ردیابی منحصربه‌فرد برای ایمیل خروجی. این شناسه برای ردیابی باز شدن ایمیل و تعاملات ضروری است.

* پیکربندی:

* متد (Method): POST

* آدرس URL: https://api.inboxpl.us/user-emails/n8n/tracking-id

* سربرگ‌ها (Headers): api_key تنظیم شده بر روی کلید API InboxPlus شما.

* ورودی‌ها: محتوای ایمیل تولید شده توسط AI Agent.

* خروجی‌ها: پاسخ JSON حاوی شناسه ردیابی، که به Send a message منتقل می‌شود.

* موارد مرزی (Edge Cases): خطاهای API، کلید API نامعتبر، قطع شدن ارتباط شبکه.

---

۳. ارسال ایمیل، دریافت پیام و شروع توالی ردیابی

این بخش نهایی به ارسال واقعی ایمیل، بازیابی جزئیات آن برای ردیابی و به‌روزرسانی وضعیت سرنخ می‌پردازد.

گره‌های درگیر:

• Send a message
• Fetches Email Data
• Starts Sequence
• Append or update row in sheet

جزئیات گره:

• Send a message

* نوع: gmail

* نقش: ایمیل شخصی‌سازی شده را به آدرس ایمیل سرنخ ارسال می‌کند. URL تصویر ردیابی به‌دست‌آمده از Generates Tracking ID به بدنه ایمیل اضافه می‌شود.

* پیکربندی:

* به (To): آدرس ایمیل سرنخ (از Loop Over Items).

* موضوع (Subject): موضوع تولید شده از AI Agent.

* پیام (Message): بدنه HTML تولید شده از AI Agent، شامل URL تصویر ردیابی.

* اعتبارنامه‌ها (Credentials): اعتبارنامه‌های Gmail OAuth2 به نام "Gmail account 10 - (DEV)".

* گزینه‌ها (Options): Attribution غیرفعال شده است تا از پاورقی‌های اضافی جلوگیری شود.

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

* خروجی‌ها: داده‌های پیام ارسال شده، شامل messageId، که به Fetches Email Data منتقل می‌شود.

* موارد مرزی (Edge Cases): خرابی در ارسال ایمیل، انقضای توکن Gmail OAuth، آدرس ایمیل گیرنده نامعتبر.

• Fetches Email Data

* نوع: gmail

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

* پیکربندی: از messageId به‌دست‌آمده از خروجی گره Send a message استفاده می‌کند.

* ورودی‌ها: خروجی پیام ارسال شده از Send a message.

* خروجی‌ها: فراداده ایمیل، که به Starts Sequence منتقل می‌شود.

* موارد مرزی (Edge Cases): پیام یافت نشد، محدودیت‌های نرخ API جیمیل.

• Starts Sequence

* نوع: httpRequest

* نقش: API InboxPlus را برای شروع ردیابی توالی ایمیل برای پیام ارسال شده فراخوانی می‌کند.

* پیکربندی:

* متد (Method): POST

* URL: https://api.inboxpl.us/user-emails/n8n

* بدنه (Body): شامل ایمیل گیرنده، موضوع، threadId، message_id، ایمیل فرستنده، tracking_id و یک sequenceId ثابت (مانند "Your_Sequence_ID").

* هدرها (Headers): کلید API InboxPlus.

* ورودی‌ها: فراداده ایمیل از Fetches Email Data و tracking_id از Generates Tracking ID.

* خروجی‌ها: پاسخ API، که به Append or update row in sheet منتقل می‌شود.

* موارد مرزی (Edge Cases): خطاهای API، شناسه‌های نامعتبر، مشکلات شبکه.

• Append or update row in sheet

* نوع: googleSheets

* نقش: ردیف مربوطه را در Google Sheet به‌روزرسانی می‌کند تا خروجی را به‌عنوان تکمیل شده علامت‌گذاری کند. "وضعیت" (Status) را روی "انجام شد" (Done) تنظیم می‌کند و اطلاعات پیام مربوطه را ثبت می‌کند.

* پیکربندی:

* سند و صفحه (Document and Sheet): همانند آنچه در مرحله بازیابی داده‌ها استفاده شد.

* حالت به‌روزرسانی (Update Mode): Update یا Insert (تطبیق بر اساس ستون Email برای به‌روزرسانی ردیف موجود).

* ستون‌های به‌روزرسانی (Columns to Update): Email, Name, Number, Status (تنظیم شده روی "Done") و Message (می‌تواند جزئیات پیام ارسال شده را ذخیره کند).

* اعتبارنامه‌ها (Credentials): Google Sheets OAuth2 "Google Sheets account - (DEV)".

* ورودی‌ها: داده‌ها از گره Starts Sequence.

* خروجی‌ها: حلقه گردش کار از طریق Loop Over Items به سرنخ بعدی ادامه می‌یابد.

* موارد مرزی (Edge Cases): خرابی در به‌روزرسانی صفحه، تداخلات احتمالی اگر صفحه به‌طور همزمان توسط فرآیندهای دیگر اصلاح شود.

---

۴. جدول خلاصه