ربط واتساب بنظام حجز مواعيد للعيادات
حجز العيادة يمر عبر واتساب التجاري وجدول واحد يشاركه الاستقبال، فلا يُحجز نفس الكرسي مرتين. العربون اختياري، والمطابقة برقم العملية والمبلغ.
عيادة أسنان بدمشق كانت تأخذ المواعيد من واتساب ومن مكتب الاستقبال في الوقت نفسه. الموظفة ترد على الرسائل بين مريضين واقفين عند المكتب. الساعة 11:00 يوم الثلاثاء تُحجز مرتين: مرة من المحادثة ومرة من الدفتر. أحد المريضين يصل ويجد الكرسي مشغولًا. هذا هو المكان الذي أضع فيه نظام حجز يتصل بواتساب: الموعد لا يُعتبر محجوزًا إلا بعد ما ينكتب في جدول واحد، بنفس القواعد، سواء جاء الطلب من المحادثة أو من الاستقبال.
هذا غير بوت واتساب للطلبات والدفع بشام كاش. هناك السلعة تخرج من المخزون. هنا الكرسي والطبيب والمدة. إذا انحجزت المدة مرتين، تخسر وقت الطبيب وثقة المريض معًا.
ما الذي يفعله النظام
المريض يراسل الرقم التجاري، يختار الخدمة والطبيب إن وُجد أكثر من واحد، ويرى الأوقات المتاحة، ثم يؤكد. النظام يقفل الفترة في قاعدة البيانات قبل أن يرد «تم الحجز». إذا وصلت رسالتان في اللحظة نفسها على نفس الفترة، واحدة تنجح والثانية تحصل على أقرب وقت بديل.
بعض العيادات تطلب عربونًا حتى يقل الإلغاء في آخر لحظة. تحويل شام كاش أو سيريتل كاش ما فيه حقل ملاحظة، لذلك لا أطلب من المريض كتابة رقم الموعد داخل التحويل. بعد الدفع يظهر رقم العملية، وهذا ما يرسله في واتساب. المطابقة تتم برقم العملية والمبلغ. رقم المرسل يعود دائمًا مع التحويل، وأحفظه مع الموعد، من دون أن أستخدمه شرطًا للمطابقة.
بوابة الدفع التي أقدّمها تتصل برقم أو حساب تملكه العيادة. سيريتل كاش دولاران للرقم في الشهر، وشام كاش خمسة دولارات للحساب. باقة بوت الدفع تبدأ من 120 دولارًا مرة واحدة. الإعداد يتم في اليوم نفسه، والبوابة مستضافة من دون تسليم كود مصدري. العيادة التي لا تريد عربونًا تكتفي بنظام المواعيد وحده.
خطوات ربط المحفظة نفسها موجودة في كيف تربط شام كاش API بمتجرك. المنطق هنا مماثل، والعنصر المحجوز هو الموعد لا الطلب.
ليش واتساب الرسمي، مو الرقم الشخصي
للإنتاج أستخدم WhatsApp Business Platform (Cloud API) على رقم تجاري، مع webhook يستقبل الرسائل. الرقم الشخصي مع أدوات غير رسمية لقراءة واتساب ويب ينكسر عند أول تحقق أمني، وقد يُحظر في يوم الدوام الكامل. فاتورة ميتا لاستخدام Cloud API منفصلة وتُحسب حسب أسعارهم الحالية؛ أذكرها عند الاتفاق ولا أثبت رقمًا لها هنا لأنه يتغيّر.
الرسائل المختلطة («بدي موعد»، «كم سعر التنظيف»، «ألغي»، لصق رقم عملية) تحتاج تصنيفًا قبل أن يدخل الحجز. كتبت عن هذا النوع من الردود في بوت دعم عربي للزبائن. نظام المواعيد يتعامل مع النية بعد ما تصير واضحة: حجز، تعديل، إلغاء، أو دفع عربون.
جدول المواعيد، مو قائمة رسائل
كل فترة لها صف: الطبيب، الخدمة، وقت البداية، المدة، الحالة (متاحة، معلّقة بانتظار العربون، مؤكدة، ملغاة). قيد فريد على العمودين doctor_id وstart_at، حيث الحالة ليست ملغاة، يمنع موعدين على نفس الكرسي. المدة تختلف: كشف قصير، وجلسة أطول تحتاج كتلة متصلة في الجدول، لا خانة ساعة مدوّرة إذا كانت الخدمة أطول من ذلك.
التوقيت توقيت دمشق. أُظهر للمريض الساعة كما يفهمها، وأخزّنها بوضوح حتى لا يتحرك الموعد إذا تغيّر إعداد السيرفر. الإجازات وأوقات الاستراحة تُستثنى من القائمة المعروضة.
إذا كان الطبيب يعمل في أيام محددة، أو في أكثر من مكان، الجدول يحمل هذه القيود. الاستقبال يستخدم الشاشة نفسها التي يكتب فيها البوت، حتى لا يعود الدفتر مصدرًا ثانيًا للحقيقة.
تدفق المحادثة الذي أعتمده
المريض يكتب أنه يريد موعدًا، أو يضغط زرًا إذا كانت القائمة جاهزة. البوت يسأل عن الخدمة، ثم عن الطبيب إن لزم. يعرض أقرب ثلاثة أو أربعة أوقات حقيقية من الجدول، مع إمكانية طلب يوم آخر. بعد الاختيار يقفل الفترة. إذا كانت العيادة تطلب عربونًا، تبقى الحالة معلّقة ويظهر رقم المحفظة والمبلغ. بعد أن يلصق المريض رقم العملية، يتحقق البوت من المبلغ عبر البوابة ويحوّل الحالة إلى مؤكد. إذا لم يكن هناك عربون، يتأكد الموعد مباشرة.
قبل الموعد تُرسل رسالة تذكير. إذا ألغى المريض، تُفتح الفترة لغيره.
عرض أربعة أوقات يكفي في أول رد. إذا لم يناسب أي وقت، يكتب يومًا مثل «صباح الخميس»، والنظام يعيد الحساب.
منع الحجز المزدوج في الكود
المشكلة ليست في إرسال رسالة واتساب. المشكلة أن رسالتين تصلان معًا، أو أن الموظفة تضغط حفظ في اللحظة التي يؤكد فيها المريض من الهاتف. الحل قيد فريد مع معاملة قاعدة بيانات. لا تعتمد على فحص «هل الفترة فارغة؟» ثم إدخال منفصل من دون قفل.
```python import os import psycopg from fastapi import FastAPI, Request, HTTPException from fastapi.responses import PlainTextResponse
app = FastAPI() GRAPH = "https://graph.facebook.com/v21.0" TOKEN = os.environ["WHATSAPP_TOKEN"] PHONE_ID = os.environ["WHATSAPP_PHONE_ID"] VERIFY_TOKEN = os.environ["WHATSAPP_VERIFY_TOKEN"]
def send_text(to: str, body: str) -> None: import httpx
httpx.post( f"{GRAPH}/{PHONE_ID}/messages", headers={"Authorization": f"Bearer {TOKEN}"}, json={ "messaging_product": "whatsapp", "to": to, "type": "text", "text": {"body": body}, }, timeout=20, ).raise_for_status()
@app.get("/webhook") def verify(request: Request): q = request.query_params if q.get("hub.verify_token") == VERIFY_TOKEN and q.get("hub.mode") == "subscribe": return PlainTextResponse(q.get("hub.challenge", "")) raise HTTPException(status_code=403)
def book_slot(conn, doctor_id: int, start_at: str, patient_phone: str, service: str): try: with conn.transaction(): row = conn.execute( """ INSERT INTO appointments (doctor_id, start_at, patient_phone, service, status) VALUES (%s, %s, %s, %s, 'confirmed') RETURNING id """, (doctor_id, start_at, patient_phone, service), ).fetchone() return row["id"] except psycopg.errors.UniqueViolation: return None
@app.post("/webhook") async def incoming(request: Request): payload = await request.json() try: msg = payload["entry"][0]["changes"][0]["value"]["messages"][0] from_wa = msg["from"] text = msg.get("text", {}).get("body", "").strip() except (KeyError, IndexError): return {"ok": True}
if text.startswith("BOOK "): parts = text.split(" ", 2) if len(parts) != 3: send_text(from_wa, "صيغة التأكيد غير مكتملة. اطلب الأوقات من جديد.") return {"ok": True} _, doctor_id, start_at = parts with psycopg.connect( os.environ["DATABASE_URL"], row_factory=psycopg.rows.dict_row ) as conn: appointment_id = book_slot( conn, int(doctor_id), start_at, from_wa, "checkup" ) if appointment_id: send_text(from_wa, f"تم حجز الموعد. رقم التأكيد: {appointment_id}") else: send_text(from_wa, "هذا الوقت أُخذ للتو. أرسل «أوقات» لترى أقرب بديل.") return {"ok": True} ```
القيد في قاعدة البيانات يكون بهذا الشكل:
``sql CREATE UNIQUE INDEX appointments_one_chair ON appointments (doctor_id, start_at) WHERE status <> 'cancelled'; ``
هذا أهم سطر في النظام. من دونه، فحص «هل الفترة فارغة؟» يفشل تحت التزامن.
إذا طُلب عربون، أُدرج الصف بحالة pending_deposit بنفس القيد، ثم أحوّل الحالة إلى confirmed بعد نجاح التحقق من رقم العملية والمبلغ، مع منع استعمال رقم العملية نفسه مرتين.
التذكير والإلغاء والتعديل
رسالة التذكير قبل الموعد بيوم، وأحيانًا في صباح نفس اليوم، تقلل الغياب. القوالب الموافقة من ميتا لازمة للرسائل التي تبدأها العيادة خارج نافذة المحادثة. نص التذكير يبقي اسم الطبيب والساعة، مع تعليمات واضحة للإلغاء.
الإلغاء يفتح الفترة لغيره فورًا. التعديل إلغاء ثم حجز جديد في معاملة واحدة، حتى لا يبقى المريض من دون موعد إذا فشل الحجز الجديد. سياسة العربون عند الإلغاء المتأخر شأن العيادة، وأكتبها في رسالة التأكيد كما تقررها هي. لا أنقل عن شام كاش أو سيريتل كاش سياسة استرداد رسمية؛ ما يسري هو اتفاق العيادة مع محفظتها، وما تسجّله في نظامها بعد إعادة المبلغ من التطبيق إذا قررت ذلك.
العيادة التي تريد قناة ثانية على تيليغرام تستخدم نفس الجدول. فكرة البوت مع الدفع مشروحة في بوت تيليغرام يستقبل دفعات سيريتل كاش. المصدر واحد: جدول المواعيد، لا نسختان منفصلتان.
ماذا أجهز قبل الإطلاق
تحتاج رقم واتساب تجاري على Cloud API، واسم العيادة ظاهر في الملف. قائمة الخدمات والمدد الحقيقية، لا تقدير عام. أيام عمل كل طبيب والإجازات القادمة. قرار واضح: هل الموعد يُثبت بالرسالة أم بعد العربون. إن وُجد عربون، حساب شام كاش أو رقم سيريتل كاش جاهز، ومبلغ مكتوب لكل نوع خدمة أو مبلغ موحّد.
أول أسبوع أبدأ بطبيب واحد أو نوع خدمة واحد. أراقب كيف يكتب الناس الساعة: «11»، «بعد الظهر»، «نفس وقت الأسبوع الماضي». بعدها أوسّع القائمة أو أضيف العربون.
أسئلة تتكرر
هل أقدر أشغّل النظام على واتساب الشخصي؟
للإنتاج لا. استخدم رقمًا تجاريًا على Cloud API. الرقم الشخصي والأدوات غير الرسمية تنكسر أو تُحظر في أسوأ وقت.
هل لازم عربون حتى يشتغل الحجز؟
لا. كثير من العيادات تثبّت الموعد بالرسالة وتعتمد على التذكير. العربون خيار إذا كان الإلغاء المتأخر يفرّغ جدول الطبيب.
كيف تتم مطابقة العربون إذا دفع المريض؟
برقم العملية والمبلغ. تحويل شام كاش وسيريتل كاش ما فيه حقل ملاحظة. رقم المرسل يعود مع التحويل وأحفظه، من دون أن يكون شرط المطابقة.
ماذا لو حجز الاستقبال والمريض من واتساب في اللحظة نفسها؟
القيد الفريد يحسم الأمر. واحد ينجح، والثاني يأخذ وقتًا بديلًا. الاستقبال لازم يستخدم نفس النظام، لا دفترًا جانبًا.
هل السيرفر لازم يكون داخل سوريا؟
لا. البوابة ونظام المواعيد يعملان من خارج سوريا من دون وسيط سوري ومن دون VPN.
كم يستغرق الإعداد؟
بعد جاهزية الرقم التجاري وجدول الأطباء، الإعداد يتم في اليوم نفسه إذا أرادت العيادة بوابة الدفع أيضًا. تسعيرة البوابة: دولاران للرقم أو خمسة دولارات للحساب شهريًا، وباقة البوت من 120 دولارًا مرة واحدة.
إذا بدك ربط واتساب بنظام حجز مواعيد لعيادتك، أو إضافة عربون عبر شام كاش أو سيريتل كاش، راسلني من صفحة الموقع أو على fayezalshami.dev@gmail.com. اذكر عدد الأطباء، وهل الموعد يُثبت برسالة أم بعد دفع، وهل عندك رقم واتساب تجاري جاهز.
بقلم فايز الشامي | Fayez Alshami، مطور باك إند وبوابات دفع سيريتل كاش وشام كاش.