پردازش سفارش غذا با هوش مصنوعی: مسنجر، شیتس و تقویم

پردازش سفارش غذا با هوش مصنوعی از طریق فیس‌بوک مسنجر، گوگل شیتس و تقویم

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

ویژگی‌های کلیدی:

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

---

تشریح گردش کار (Workflow Breakdown)

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

۱. دریافت و اعتبارسنجی وب‌هوک (Webhook Reception & Validation)

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

نودها (Nodes):

• Webhook - FB Messenger

* نوع (Type): Webhook

* نقش (Role): نقطه ورود برای تمام داده‌های ورودی از فیس‌بوک مسنجر. به درخواست‌های HTTP POST گوش می‌دهد و برای مدیریت تأیید اشتراک و رویدادهای پیام پیکربندی شده است.

* پیکربندی (Configuration):

* مسیر (Path): fb-messenger-webhook

* متدهای HTTP (HTTP Methods): POST

* متغیرهای محیطی (Environment Variables): FB_VERIFY_TOKEN (برای تأیید وب‌هوک).

• اعتبارسنجی اشتراک وب‌هوک (Validate Webhook Subscription)

* نوع (Type): If

* نقش (Role): بررسی می‌کند که آیا درخواست ورودی یک چالش اشتراک وب‌هوک فیس‌بوک است یا خیر.

* پیکربندی (Configuration):

* شرط (Condition): بررسی می‌کند که آیا hub.mode برابر با subscribe است و hub.verify_token با متغیر محیطی پیکربندی شده مطابقت دارد.

• پاسخ به چالش (Respond Challenge)

* نوع (Type): Respond to Webhook

* نقش (Role): اگر درخواست یک چالش اشتراک معتبر باشد، این نود با مقدار hub.challenge پاسخ می‌دهد تا فرآیند تأیید را تکمیل کند.

• پاسخ 202 (خطای جایگزین) (Respond 202 (Error fallback))

* نوع (Type): Respond to Webhook

* نقش (Role): به عنوان یک جایگزین عمل می‌کند و یک پاسخ پذیرفته شده HTTP 202 برای هر درخواستی که بخشی از چالش اشتراک وب‌هوک نیست، ارسال می‌کند.

۲. پردازش هوش مصنوعی و مدیریت مکالمه (AI Processing & Conversation Management)

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

نودها (Nodes):

• مدل OpenRouter (OpenRouter Model)

* نوع (Type): LangChain LM Chat OpenRouter

* نقش (Role): قابلیت‌های مدل زبان هوش مصنوعی را برای عامل فراهم می‌کند.

* پیکربندی (Configuration):

* مدل (Model): deepseek/deepseek-chat:free (یا مدل مناسب دیگر)

• بافر حافظه (جلسه مشتری) (Memory Buffer (Customer Session))

* نوع (Type): LangChain Memory Buffer Window

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

* پیکربندی (Configuration):

* sessionKey: برای ایجاد جلسات منحصر به فرد، روی شناسه فرستنده تنظیم شده است.

* windowSize: تعداد تعاملات گذشته که در حافظه نگهداری می‌شوند را تعیین می‌کند.

• عامل هوش مصنوعی (دستیار سفارش) (AI Agent (Order Assistant))

* نوع (Type): LangChain Agent

* نقش (Role): پیام مشتری را با استفاده از مدل هوش مصنوعی و حافظه پیکربندی شده پردازش می‌کند. این عامل برای درک سفارشات غذا، ارائه اطلاعات و درخواست جزئیات لازم طراحی شده است.

* پیکربندی (Configuration):

* دستور سیستمی (System Prompt): دستوری دقیق که هوش مصنوعی را در مورد منو، فرآیند سفارش، تبلیغات موجود و نحوه رسیدگی به فرصت‌های فروش بیشتر راهنمایی می‌کند.

• پاسخ 200 OK (Respond 200 OK)

* نوع (Type): Respond to Webhook

* نقش (Role): یک پاسخ HTTP 200 OK به فیس‌بوک مسنجر ارسال می‌کند تا دریافت پیام را تأیید کند و از ارسال مجدد آن توسط فیس‌بوک جلوگیری کند.

۳. تجزیه و اعتبارسنجی سفارش (Order Parsing & Validation)

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

نودها (Nodes):

• ارسال پیام به FB (متن) (Send Message to FB (Text))

* نوع (Type): HTTP Request

* نقش (Role): پاسخ متنی عامل هوش مصنوعی را به مشتری در مسنجر ارسال می‌کند.

* پیکربندی (Configuration):

* URL: نقطه پایانی /messages گراف API فیس‌بوک.

* متد (Method): POST

* بدنه (Body): شامل شناسه گیرنده و متن پیام.

* متغیرهای محیطی (Environment Variables): FB_PAGE_ID, FB_PAGE_ACCESS_TOKEN.

• بررسی برای تریگر منو (Check for Menu Trigger)

* نوع (Type): If

* نقش (Role): تعیین می‌کند که آیا پاسخ هوش مصنوعی نشان‌دهنده ارسال کامل منو است یا خیر.

* پیکربندی (Configuration):

* شرط (Condition): برای عبارت خاصی در خروجی هوش مصنوعی (مانند "Here’s our FULL MENU OF FLAVORS...") بررسی می‌کند.

• ارسال پیام به FB (تصویر) (Send Message to FB (Image))

* نوع (Type): HTTP Request

* نقش (Role): یک پیوست تصویری (مانند منو) را به مشتری ارسال می‌کند.

* پیکربندی (Configuration):

* URL: نقطه پایانی /messages گراف API فیس‌بوک.

* متد (Method): POST

* بدنه (Body): شامل URL پیوست پیام (مانند https://i.imgur.com/M4cryeH.jpg).

* متغیرهای محیطی (Environment Variables): FB_PAGE_ID, FB_PAGE_ACCESS_TOKEN.

• ارسال متن عمومی (HTTP) (Send Generic Text (HTTP))

* نوع (Type): HTTP Request

* نقش (Role): پیام‌های متنی عمومی را از هوش مصنوعی به مشتری ارسال می‌کند. این زمانی استفاده می‌شود که تصویر منو ارسال نمی‌شود.

* پیکربندی (Configuration): مشابه Send Message to FB (Text).

• اعتبارسنجی سفارش تجزیه شده (Validate Parsed Order)

* نوع (Type): If

* نقش (Role): قبل از تلاش برای تجزیه جزئیات ضروری سفارش (مانند نام، تاریخ، موارد سفارش، آدرس) از خروجی هوش مصنوعی، حضور آن‌ها را تأیید می‌کند.

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

• تجزیه متن سفارش (Parse Order Text)

* نوع (Type): Code (JavaScript)

* نقش (Role): سفارش متنی آزاد را با تجزیه خطوط و جفت‌های کلید-مقدار به فرمت JSON ساختاریافته تبدیل می‌کند.

• پاسخ موارد خام (اشکال‌زدایی) (Respond Raw Items (Debug))

* نوع (Type): Respond to Webhook

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

۴. ذخیره‌سازی داده و زمان‌بندی (Data Persistence & Scheduling)

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

نودها (Nodes):

• افزودن یا به‌روزرسانی شیت سفارشات (Append or Update Orders Sheet)

* نوع (Type): Google Sheets

* نقش (Role): سفارشات جدید را به یک شیت Google Sheets اضافه می‌کند یا موارد موجود را بر اساس یک فیلد مطابق (مانند نام مشتری) به‌روزرسانی می‌کند.

* پیکربندی (Configuration):

* عملیات (Operation): appendOrUpdate

* شناسه سند (Document ID): شناسه شیت Google شما.

* نام شیت/GID (Sheet Name/GID): شیت خاص برای استفاده.

* نگاشت ستون (Column Mapping): داده‌های سفارش تجزیه شده را به ستون‌های شیت نگاشت می‌کند (تاریخ، زمان، سفارش، نام کامل، شماره تماس، آدرس تحویل).

* ستون مطابق (Matching Column): Full Name (برای به‌روزرسانی‌ها).

* متغیرهای محیطی (Environment Variables): YOUR_GOOGLE_SHEET_ID, YOUR_SHEET_GID_OR_NAME.

• ایجاد رویداد تقویم (Create Calendar Event)

* نوع (Type): Google Calendar

* نقش (Role): یک رویداد جدید در تقویم Google شما برای علامت‌گذاری زمان‌بندی شده برای انجام سفارش ایجاد می‌کند.

* پیکربندی (Configuration):

* تقویم (Calendar): آدرس ایمیل تقویم Google برای استفاده.

* خلاصه (Summary): عنوان رویداد را قالب‌بندی می‌کند (مانند "Pizza ORDERED BY John Doe").

* متغیرهای محیطی (Environment Variables): YOUR_GOOGLE_CALENDAR_EMAIL.

۵. پاسخ و تأیید مسنجر (Messenger Response & Confirmation)

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

نودها (Nodes):

• ارسال پیام به FB (متن) (Send Message to FB (Text)) (مجدد استفاده شده)

* نوع (Type): HTTP Request

* نقش (Role): پیام‌های تأیید، پیشنهادات فروش بیشتر، یا هر ارتباط متنی مرتبط دیگری را به مشتری ارسال می‌کند.

• ارسال پیام به FB (تصویر) (Send Message to FB (Image)) (مجدد استفاده شده)

* نوع (Type): HTTP Request

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

---

جدول خلاصه

راه‌اندازی و پیکربندی

1. یکپارچه‌سازی فیس‌بوک مسنجر:

* یک اپلیکیشن فیس‌بوک راه‌اندازی کرده و یک وب‌هوک مسنجر پیکربندی کنید.

* اطمینان حاصل کنید که URL وب‌هوک به نمونه n8n شما و مسیر fb-messenger-webhook اشاره می‌کند.

* متغیر محیطی FB_VERIFY_TOKEN را در n8n تنظیم کنید تا با توکن پیکربندی شده در اپلیکیشن فیس‌بوک شما مطابقت داشته باشد.

* یک FB_PAGE_ACCESS_TOKEN با مجوزهای لازم دریافت کنید.

2. یکپارچه‌سازی گوگل شیتس:

* حساب گوگل شیتس خود را در n8n احراز هویت کنید.

* متغیرهای محیطی YOUR_GOOGLE_SHEET_ID و YOUR_SHEET_GID_OR_NAME را تنظیم کنید تا به شیت ردیابی سفارشات شما اشاره کنند.

3. یکپارچه‌سازی گوگل کلندر:

* حساب گوگل کلندر خود را در n8n احراز هویت کنید.

* متغیر محیطی YOUR_GOOGLE_CALENDAR_EMAIL را به آدرس ایمیل کلندری که رویدادها باید در آن ایجاد شوند، تنظیم کنید.

4. پیکربندی مدل هوش مصنوعی:

* در صورت نیاز توسط نود LangChain LM Chat OpenRouter، اطمینان حاصل کنید که کلید API OpenRouter شما به درستی پیکربندی شده است.

* پرامپت سیستم را در نود LangChain Agent بازبینی و تنظیم کنید تا منو، قیمت‌گذاری و سیاست‌های سفارش‌دهی شما را به دقت منعکس کند.

5. متغیرهای محیطی:

* FB_VERIFY_TOKEN: برای تأیید وب‌هوک فیس‌بوک.

* FB_PAGE_ID: شناسه صفحه فیس‌بوک شما.

* FB_PAGE_ACCESS_TOKEN: توکن دسترسی صفحه فیس‌بوک شما.

* YOUR_GOOGLE_SHEET_ID: شناسه گوگل شیت شما.

* YOUR_SHEET_GID_OR_NAME: نام یا GID شیت خاص در سند شما.

* YOUR_GOOGLE_CALENDAR_EMAIL: آدرس ایمیل گوگل کلندر شما.

---

توجه: این گردش کار از نودهای کتابخانه پایه n8n و نودهای خاص LangChain استفاده می‌کند. اطمینان حاصل کنید که این‌ها در محیط n8n شما نصب و قابل دسترسی هستند. می‌توانید این گردش کار و موارد دیگر را در کاتالوگ Axeto.ai n8n بیابید.