بوت تيليغرام لإدارة طلبات مطعم
قائمة داخل تيليغرام، سلة واضحة، وطلب مرتب يصل مجموعة المطبخ بعد العنوان أو بعد تأكيد الدفع.
مطعم بدمشق كان يستقبل الطلبات من واتساب ومن اتصال هاتفي ومن رسائل تيليغرام المختلطة مع أسئلة الزبائن. في ساعة الذروة يكتب ثلاثة موظفين الطلب على ورقة ثم يدخلونه للكاشير. طبق يُنسى، عنوان يصل ناقصًا، وزبون يدفع بسيريتل كاش ويرسل صورة فتختلط الفواتير. الحل الذي أركّبه لهذه الحالات هو بوت تيليغرام لإدارة طلبات المطعم: القائمة داخل المحادثة، السلة واضحة قبل التأكيد، والطلب يصل مجموعة المطبخ برسالة واحدة مرتبة.
هذا المقال عن إدارة الطلب نفسه، من فتح القائمة حتى تسليمه. تأكيد الدفع بسيريتل كاش له مسار مفصل في بوت تيليغرام يستقبل دفعات سيريتل كاش. إذا كان المطعم يعتمد واتساب أكثر من تيليغرام، التدفق القريب مشروح في بوت واتساب للطلبات مع شام كاش.
باقة بوت الطلبات عندي تبدأ من 120 دولارًا مرة واحدة. إذا كان الدفع عبر سيريتل كاش، اشتراك الـAPI دولاران للرقم في الشهر. الإعداد يتم في اليوم نفسه، والتسليم خدمة جاهزة من دون كود مصدري للبوابة.
ماذا يعمل البوت، وماذا يبقى للمطعم
البوت يعرض الأصناف مع الأسعار، يبني سلة، يسأل طريقة الاستلام (توصيل أو استلام من المحل)، ويأخذ العنوان أو رقم الطاولة، ثم ينشئ طلبًا برقم واضح. بعد التأكيد يرسل ملخصًا لمجموعة تيليغرام خاصة بالمطبخ أو للكاشير، ويحدّث الزبون عندما تتغير الحالة: قيد التحضير، خرج للتوصيل، تم التسليم.
القائمة نفسها تبقى مسؤوليتك. غيّر سعرًا أو أوقف صنفًا نافدًا من لوحة بسيطة أو من ملف إعداد، لا من تعديل الكود في كل مرة. ساعات العمل أيضًا تُغلق البوت برسالة واضحة خارج الدوام، وإلا يصل المطبخ طلب الساعة الثانية ليلًا ولا أحد يرد عليه.
البوت لا يسجّل محفظة سيريتل كاش بدلًا عنك، ولا يحدّد سقف الاستلام الرسمي. الحدود تختلف حسب نوع الحساب وقد تتغير، فتأكد من الحد الحالي لرقمك مع سيريتل إذا كنت تتوقع يومًا مزدحمًا أو طلبات بمبالغ كبيرة.
تدفق الطلب داخل المحادثة
الزبون يبدأ بـ /start أو يضغط زر «قائمة اليوم». تظهر التصنيفات: مشاوي، مقبلات، مشروبات. داخل كل تصنيف أزرار للأصناف. كل ضغطة تضيف واحدة للسلة وتعرض المجموع الحالي. زر «إنهاء الطلب» يعرض السلة كاملة، مع إمكانية حذف صنف أو تعديل الكمية قبل أي دفع.
بعد السلة أسأل: توصيل أم استلام؟ للتوصيل أحفظ العنوان ورقم الهاتف في نفس المحادثة. لا أعتمد على اسم مستخدم تيليغرام وحده؛ كثير من الزبائن بلا اسم ظاهر، والمندوب يحتاج رقمًا يتصل عليه.
ثم طريقة الدفع. في المطاعم التي أعمل معها غالبًا خياران: الدفع عند الاستلام، أو تحويل سيريتل كاش، وأحيانًا شام كاش. تحويل سيريتل كاش ما فيه حقل ملاحظة. لا تطلب من الزبون كتابة رقم الطلب داخل التحويل، هذا الحقل غير موجود. بعد الدفع يلصق رقم العملية في المحادثة، والتحقق يتم على رقم العملية والمبلغ معًا. رقم المرسل يعود من البوابة وأحفظه كمعلومة إضافية، من دون أن أستخدمه شرطًا للمطابقة. تفاصيل الربط للمتاجر في كيف تربط سيريتل كاش بمتجرك الإلكتروني.
إذا اختار الدفع عند الاستلام، الحالة تصبح «مؤكد، ينتظر التحضير» مباشرة، ويُرسل الملخص للمطبخ.
مثال للكود: سلة وطلب يصل المطبخ
المثال يستخدم python-telegram-bot. الحالة تُحفظ في الذاكرة للتجربة. في الإنتاج انقلها إلى Postgres أو Redis حتى لا تضيع السلة إن أُعيد تشغيل العملية.
```python import os from decimal import Decimal
from telegram import InlineKeyboardButton, InlineKeyboardMarkup, Update from telegram.ext import ( Application, CallbackQueryHandler, CommandHandler, ContextTypes, MessageHandler, filters, )
MENU = { "kibbeh": ("كبة مقلية", Decimal("25000")), "grill": ("مشاوي مشكلة", Decimal("85000")), "cola": ("كولا", Decimal("8000")), }
KITCHEN_CHAT_ID = int(os.environ["KITCHEN_CHAT_ID"])
def cart_total(cart): return sum(MENU[sku][1] * qty for sku, qty in cart.items())
def menu_keyboard(): rows = [ [InlineKeyboardButton(f"{name} ({price} ل.س)", callback_data=f"add:{sku}")] for sku, (name, price) in MENU.items() ] rows.append([InlineKeyboardButton("إنهاء الطلب", callback_data="checkout")]) return InlineKeyboardMarkup(rows)
async def start(update: Update, context: ContextTypes.DEFAULT_TYPE): context.user_data["cart"] = {} await update.message.reply_text( "أهلاً، هذه قائمة اليوم. اختر صنفاً ليضاف إلى سلتك.", reply_markup=menu_keyboard(), )
async def on_button(update: Update, context: ContextTypes.DEFAULT_TYPE): query = update.callback_query await query.answer() cart = context.user_data.setdefault("cart", {})
if query.data.startswith("add:"): sku = query.data.split(":", 1)[1] cart[sku] = cart.get(sku, 0) + 1 name, _ = MENU[sku] await query.edit_message_text( f"أضفنا {name}. المجموع الحالي {cart_total(cart)} ل.س.", reply_markup=menu_keyboard(), ) return
if query.data == "checkout": if not cart: await query.edit_message_text("السلة فارغة. اختر صنفاً أولاً.", reply_markup=menu_keyboard()) return lines = [f"{MENU[sku][0]} × {qty}" for sku, qty in cart.items()] total = cart_total(cart) context.user_data["pending_total"] = str(total) await query.edit_message_text( "طلبك:\n" + "\n".join(lines) + f"\nالمجموع: {total} ل.س\n\n" "أرسل عنوان التوصيل ورقم هاتف واضح، أو اكتب «استلام من المحل»." )
async def on_address(update: Update, context: ContextTypes.DEFAULT_TYPE): cart = context.user_data.get("cart") or {} total = context.user_data.get("pending_total") if not cart or not total: await update.message.reply_text("ابدأ بـ /start لتختار من القائمة.") return
order_id = f"R{update.effective_user.id}-{update.message.message_id}" summary = ( f"طلب جديد {order_id}\n" + "\n".join(f"{MENU[sku][0]} × {qty}" for sku, qty in cart.items()) + f"\nالمجموع: {total} ل.س\n" + f"التوصيل: {update.message.text}\n" + f"تيليغرام: {update.effective_user.id}" ) await context.bot.send_message(KITCHEN_CHAT_ID, summary) context.user_data["cart"] = {} context.user_data.pop("pending_total", None) await update.message.reply_text( f"وصلنا طلبك برقم {order_id}. المطبخ يبدأ التحضير، ونعلمك عند خروج الطلب." )
def main(): app = Application.builder().token(os.environ["TELEGRAM_BOT_TOKEN"]).build() app.add_handler(CommandHandler("start", start)) app.add_handler(CallbackQueryHandler(on_button)) app.add_handler(MessageHandler(filters.TEXT & ~filters.COMMAND, on_address)) app.run_polling()
if __name__ == "__main__": main() ```
هذا المثال يوقف عند إرسال الطلب للمطبخ بعد العنوان، ويفترض الدفع عند الاستلام. إذا كان الدفع تحويل سيريتل كاش، لا ترسل للمطبخ إلا بعد نجاح التحقق من رقم العملية والمبلغ. رقم العملية يُحفظ بقيد فريد حتى لا يُستخدم على طلبين. المبلغ المختلف يدخل المراجعة ويُربط بالرقم حتى لا يُغلق طلبًا آخر.
KITCHEN_CHAT_ID مجموعة خاصة أو محادثة مع الكاشير، ليست القناة العامة للمطعم. أضف البوت للمجموعة وأعطه حق الإرسال، ثم خذ معرّف المحادثة من تحديث خام مرة واحدة واحفظه في متغير البيئة.
حالات تكسر الطلب إذا لم تُعالَج
الصنف ينفد بعد أن يضيفه الزبون إلى السلة. إذا ضغط «إنهاء الطلب» وكان الصنف قد أُوقف، احذف الكمية من السلة واطلب التأكيد من جديد. لا تسمح بتأكيد طلب على طبق لم يعد يُحضَّر.
الزبون يترك المحادثة ثم يعود بعد ساعة. السلة في الذاكرة تكون اختفت إن أُعيد تشغيل السيرفر. احفظ السلة مع وقت انتهاء، وبعد المهلة ابدأ طلبًا جديدًا بالقائمة الحالية لا بالأسعار القديمة.
طلبان من نفس الحساب في وقت واحد نادر لكنه يحدث إذا فتح الزبون المحادثة من جهازين. اربط السلة بمعرّف المستخدم، واسمح بطلب مفتوح واحد حتى يُؤكد أو يُلغى.
العنوان يصل بجملة ناقصة: «حمص جنب المسجد». أعد السؤال عن أقرب نقطة دالة ورقم الهاتف قبل إرسال المطبخ. رسالة المطبخ بلا رقم اتصال تضيع وقت المندوب.
إذا وصل إشعار المطبخ وفشل الإرسال، لا تلغِ الطلب المؤكد. أعد المحاولة من طابور، لأن حالة الطلب وحالة الرسالة قناتان منفصلتان. نفس الفكرة تظهر عندما تربط المتجر بأدوات أتمتة في أتمتة شغل متجرك بـ n8n.
قائمة تحقق قبل استقبال طلبات حقيقية
- القائمة والأسعار تُعدَّل من مكان واحد، والصنف النافد يُوقف من دون نشر نسخة جديدة من البوت.
- ساعات العمل تغلق الاستقبال برسالة واضحة.
- السلة تُحفظ خارج ذاكرة العملية، ولها مهلة.
- العنوان ورقم الهاتف يُطلبان قبل إرسال المطبخ في طلبات التوصيل.
- الدفع عند الاستلام يؤكد الطلب فورًا. تحويل سيريتل كاش أو شام كاش ينتظر رقم العملية، والمطابقة على الرقم والمبلغ، من دون حقل ملاحظة في التحويل.
- رقم العملية بقيد فريد، والمبلغ المختلف يدخل المراجعة.
- مجموعة المطبخ تستقبل ملخصًا واحدًا بعد التأكيد، وفشل الإشعار يعاد من دون تغيير حالة الطلب.
- الزبون يصله تحديث عند التحضير والخروج والتسليم، مع أمر إلغاء واضح قبل بدء التحضير إن كنت تسمح بالإلغاء.
أسئلة تتكرر
هل البوت يغني عن مندوب أو كاشير؟
لا. البوت يرتّب الطلب ويمنع اللخبطة في الكتابة. التحضير والتوصيل وتأكيد العنوان الغامض يبقى شغل المطعم. الكاشير يحتاج زرًا يغيّر الحالة حتى يصل التحديث للزبون.
هل أقدّم القائمة كصور فقط؟
الصور تفيد في القناة التسويقية. داخل البوت أفضل أن يكون كل صنف زرًا بسعر واضح، حتى تُحسب السلة من دون لبس في اسم الطبق. يمكنك إرفاق صورة مع زر الصنف، لكن القرار يبقى الزر لا التعليق أسفل الصورة.
ماذا لو دفع الزبون قبل أن يؤكد السلة؟
إذا كان التحويل سيريتل كاش أو شام كاش، لا تطابق على المبلغ وحدَه. انتظر رقم العملية على طلب مفتوح بمبلغ معروف. إذا دفع بلا طلب، اطلب منه رقم العملية بعد إنشاء الطلب يدويًا وراجع الحالة.
هل أقدر أشغّل نفس البوت لفرعين؟
نعم، إذا كانت كل قائمة ومجموعة مطبخ مربوطة بفرع. لا تخلط سلال فرعين في نفس المحادثة من دون أن يختار الزبون الفرع أولًا. اشتراك سيريتل كاش يبقى دولارين لكل رقم في الشهر، وشام كاش خمسة دولارات لكل حساب.
كم يستغرق الإعداد؟
الإعداد يتم في اليوم نفسه بعد جاهزية توكن البوت ومجموعة المطبخ، وبعد ربط المحفظة إن كان الدفع إلكترونيًا. يمكن تجربة السلة والإشعار قبل الحساب الحي.
بعد أول أسبوع تشغيل
ابدأ بقائمة قصيرة وساعات عمل مكتوبة ومراجعة يدوية للعناوين الغامضة. راقب يومين كيف يكتب الناس العنوان، ومتى يلغون بعد التأكيد، ومتى يرسلون صورة تحويل بدل رقم العملية. بعدها توسّع في التصنيفات أو تضيف فرعًا ثانيًا.
إذا بدك بوت تيليغرام لطلبات مطعم، أو بوابة دفع بسيريتل كاش وشام كاش يتصل بها البوت، راسلني من صفحة الموقع أو على fayezalshami.dev@gmail.com. اذكر عدد الفروع، وطريقة الدفع الحالية، وهل عندك مجموعة مطبخ جاهزة أم نبدأ من هذه الخطوة أيضًا.