رزرو هوشمند رستوران: تلگرام، تقویم و ایمیل با n8n

سیستم رزرو رستوران با هوش مصنوعی با اعلان‌های تلگرام، تقویم و ایمیل

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

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

---

نمای کلی گردش کار

سیستم به سه بخش منطقی اصلی تقسیم شده است:

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

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

3. نهایی کردن رزرو: جزئیات رزرو را تأیید می‌کند، رویداد تقویم گوگل را ایجاد می‌کند، ایمیل تأییدیه را ارسال می‌کند و کاربر را از طریق تلگرام مطلع می‌سازد.

---

تحلیل دقیق نودها

بلوک ۱: دریافت ورودی و پردازش هوش مصنوعی

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

نودها:

• Telegram Trigger (n8n-nodes-base.telegramTrigger)

* نقش: برای شروع گردش کار، منتظر پیام‌های جدید از ربات تلگرام می‌ماند.

* پیکربندی: برای گوش دادن به به‌روزرسانی‌های "message" تنظیم شده است.

* ورودی: ندارد (تریگر).

* خروجی: داده‌های پیام کاربر.

* نکات: نیاز به اعتبارنامه Telegram Bot Token و تنظیمات webhook دارد.

• Information Gathering Agent (@n8n/n8n-nodes-langchain.agent)

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

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

* ورودی: پیام تلگرام، حافظه هوش مصنوعی و مدل‌های زبان.

* خروجی: JSON با پرچم is_pass_next و محتوای پیام برای مرحله بعدی یا تأیید رزرو.

* نسخه: 1.8

* نکات: از عبارات ورودی مانند {{ $json.message.text }} و مُهر زمانی برای مفروضات منطقه زمانی استفاده می‌کند.

• Simple Memory (@n8n/n8n-nodes-langchain.memoryBufferWindow)

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

* پیکربندی: پنجره زمینه روی 15 پیام تنظیم شده است.

* ورودی: خروجی Telegram Trigger.

* خروجی: زمینه حافظه مکالمه‌ای.

* حالت‌های شکست: سرریز احتمالی حافظه یا تداخل کلید جلسه.

• OpenAI Chat Model (@n8n/n8n-nodes-langchain.lmChatOpenAi)

* نقش: درک زبان هوش مصنوعی و تولید پاسخ را با استفاده از مدل "o3-mini" فراهم می‌کند.

* پیکربندی: مدل برای تکمیل چت کارآمد روی "o3-mini" تنظیم شده است.

* ورودی: Information Gathering Agent.

* خروجی: متن تولید شده توسط هوش مصنوعی.

* حالت‌های شکست: خطاهای کلید API/احراز هویت، محدودیت‌های نرخ، مشکلات شبکه.

• OpenAI Chat Model1 (@n8n/n8n-nodes-langchain.lmChatOpenAi)

* نقش: نمونه دیگری از مدل هوش مصنوعی (مدل "gpt-4.1-mini") که برای پالایش خروجی استفاده می‌شود.

* ورودی: خروجی از Auto-fixing Output Parser.

* خروجی: متنی که به Structured Output Parser ارسال می‌شود.

* حالت‌های شکست: مشابه OpenAI Chat Model.

• Auto-fixing Output Parser (@n8n/n8n-nodes-langchain.outputParserAutofixing)

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

* ورودی: خروجی از OpenAI Chat Model1.

* خروجی: داده‌های JSON پاکسازی شده.

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

• Structured Output Parser (@n8n/n8n-nodes-langchain.outputParserStructured)

* نقش: طرحواره خروجی را اعتبارسنجی و اعمال می‌کند و انتظار یک مقدار بولی is_pass_next و یک رشته message را دارد.

* ورودی: خروجی از OpenAI Chat Model1.

* خروجی: داده‌های تجزیه شده برای نقطه تصمیم‌گیری بعدی.

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

بلوک ۲: مدیریت مکالمه و مسیریابی تصمیم‌گیری

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

نودها:

• Switch (n8n-nodes-base.switch)

* نقش: گردش کار را بر اساس مقدار بولی is_pass_next از خروجی هوش مصنوعی مسیریابی می‌کند:

* true: به مسیر رزرو ادامه می‌دهد.

* false: به مسیر بازخورد ادامه می‌دهد.

* ورودی: خروجی از Information Gathering Agent.

* خروجی: دو شاخه: "Booking" و "Feedback".

* حالت‌های شکست: ورودی JSON گم شده یا بدشکل.

• Telegram1 (n8n-nodes-base.telegram)

* نقش: برای بازخورد یا تعاملات غیرمرتبط با رزرو، پیام تأیید ارسال می‌کند.

* پیکربندی: متن ثابت تشکر از کاربر و اعلام اینکه ایمیل متعاقباً ارسال خواهد شد.

* ورودی: از شاخه "Feedback" نود Switch.

* خروجی: نود Edit Fields را برای یک سناریوی جایگزین رزرو نادر آغاز می‌کند.

* حالت‌های شکست: مشکلات API تلگرام یا شناسه چت گم شده.

• Telegram (n8n-nodes-base.telegram)

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

* پیکربندی: متن پیام تأیید را به صورت پویا از خروجی Information Gathering Agent دریافت می‌کند.

* ورودی: از شاخه "Booking" نود Switch.

* خروجی: در این شاخه دیگر خروجی ندارد.

* حالت‌های شکست: خرابی‌های API تلگرام.

• Edit Fields (n8n-nodes-base.set)

* نقش: داده‌های رزرو را به عنوان JSON رشته‌ای (user_data) برای پردازش بعدی آماده و اختصاص می‌دهد.

* پیکربندی: فیلد user_data را از محتوای پیام خروجی نود Switch اختصاص می‌دهد.

* ورودی: از نود Telegram1.

* خروجی: داده‌های رزرو به Booking Agent.

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

بلوک ۳: نهایی‌سازی رزرو

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

نودها:

• Booking Agent (@n8n/n8n-nodes-langchain.agent)

* نقش: جزئیات نهایی رزرو را پردازش می‌کند تا یک رویداد تقویم ساختاریافته و بدنه ایمیل HTML قالب‌بندی شده تولید کند.

* پیکربندی: یک prompt سفارشی ساختار JSON خروجی را تعریف می‌کند، شامل اشیاء calendar_event و email با مُهر زمانی ISO 8601، قالب‌بندی ایمیل و مدت زمان پیش‌فرض 2 ساعته.

* ورودی: user_data از نود Edit Fields.

* خروجی: داده‌های JSON ساختاریافته برای ایجاد تقویم و ایمیل.

* نسخه: 1.8

* حالت‌های شکست: خطاهای API هوش مصنوعی، مشکلات تجزیه خروجی.

• OpenAI Chat Model2 (@n8n/n8n-nodes-langchain.lmChatOpenAi)

* نقش: با استفاده از مدل "gpt-4.1-mini"، از Booking Agent با تولید زبان هوش مصنوعی پشتیبانی می‌کند.

* ورودی: ورودی مدل زبان هوش مصنوعی Booking Agent.

* خروجی: ورودی برای Structured Output Parser1.

* حالت‌های شکست: مشکلات API.

• Structured Output Parser1 (@n8n/n8n-nodes-langchain.outputParserStructured)

* نقش: خروجی JSON هوش مصنوعی Booking Agent را در برابر طرحواره مورد انتظار، که شامل فیلدهای calendar_event و email است، اعتبارسنجی و تجزیه می‌کند.

* ورودی: خروجی از OpenAI Chat Model2.

* خروجی: داده‌های تجزیه شده برای نودهای Google Calendar و Send a message (Gmail).

* حالت‌های شکست: خطاهای تجزیه یا اعتبارسنجی طرحواره.

• Google Calendar (n8n-nodes-base.googleCalendar)

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

* پیکربندی: از تقویم "techcupid28@gmail.com" استفاده می‌کند، یادآورهای پیش‌فرض را غیرفعال می‌کند و رنگ رویداد را روی "7" تنظیم می‌کند.

* ورودی: داده‌های ساختاریافته از Structured Output Parser1.

* خروجی: ندارد (یک اثر جانبی در Google Calendar ایجاد می‌کند).

* حالت‌های شکست: خطاهای احراز هویت API گوگل، خرابی ایجاد رویداد.

• Send a message (Gmail) (n8n-nodes-base.gmail)

* نقش: ایمیل تأیید را به کاربر ارسال می‌کند، شامل موضوع و بدنه HTML تولید شده توسط Booking Agent.

* پیکربندی: از اعتبارنامه‌های Gmail استفاده می‌کند، گیرنده، موضوع و بدنه پیام را به صورت پویا تنظیم می‌کند.

* ورودی: داده‌های ساختاریافته از Structured Output Parser1.

* خروجی: نود Telegram3 را برای اطلاع‌رسانی نهایی به کاربر آغاز می‌کند.

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

• Telegram3 (n8n-nodes-base.telegram)

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

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

* ورودی: خروجی از Send a message (Gmail).

* خروجی: ندارد.

* حالت‌های شکست: API تلگرام یا شناسه چت گم شده.

---

جدول خلاصه