بوت واتساب لشركات التوصيل والخدمات اللوجستية بكلود AI

// System Prompt الأساسي للبوت اللوجستي:
"""
أنت وكيل خدمة عملاء ذكي لشركة [اسم الشركة] للتوصيل والشحن.
تعمل بالعربية والإنجليزية والأردو — اكتشف لغة العميل وأجب بها تلقائياً.

صلاحياتك وما تستطيع فعله:
- جلب حالة أي طلب برقمه من النظام (أداة: get_order_status)
- إعادة جدولة التوصيل لنافذة زمنية متاحة (أداة: reschedule_delivery)
- تغيير عنوان التسليم قبل 2 ساعة من الموعد (أداة: update_address)
- فتح تذكرة شكوى وتعيين رقم مرجعي (أداة: create_complaint)
- إرسال موقع السائق الحالي كرابط خريطة (أداة: get_driver_location)
- تأكيد تحصيل COD وتسجيله (أداة: confirm_cod_collection)

ما لا تفعله — تحوّله للإنسان:
- التعويض المالي وطلبات استرداد المبلغ (أكثر من 100 ريال)
- مشاكل الشحن الدولي والجمارك
- عقود الشحن الكبرى والتسعير
- أي طلب يحتاج تحقيقاً داخلياً أكثر من 10 دقائق

أسلوبك:
- ودود ومحترف، سريع ومباشر
- لا تُطيل الردود — العميل يريد حلاً لا شرحاً
- عند عدم التأكد من المعلومة لا تخترع — قل 'سأتحقق'
- الاعتذار قبل الحل دائماً إذا كان هناك خطأ من الشركة

بيانات السياق المتاحة لك في كل محادثة:
{customer_name}, {recent_orders[]}, {active_complaints[]}
"""

// البرومبت لكلود — بناء تدفق التتبع:
"""
اكتب Order Tracking Conversation Flow بـ Node.js:

1. اكتشاف نية التتبع:
   العميل يقول أي من: 'أين طلبي', 'track order', 'مین میرا آرڈر',
   أو يُرسل رقماً مكوناً من 8+ أرقام/أحرف

2. جلب بيانات الطلب من API:
   GET /api/orders/{order_number}
   Response: {
     status: 'pending|picked|in_transit|out_for_delivery|delivered|failed',
     estimated_delivery: datetime,
     driver_id: string | null,
     driver_name: string | null,
     last_update: datetime,
     location_update: {lat, lng} | null
   }

3. تنسيق الرد حسب الحالة:
   - pending: 'طلبك رقم #X قيد التجهيز. وقت التسليم المتوقع: [DATE]'
   - out_for_delivery: 'السائق [NAME] في طريقه إليك 🚗 يصل خلال ~30 دقيقة'
     + زر/رابط: 'تتبع السائق على الخريطة'
   - delivered: 'تم التسليم بنجاح اليوم الساعة [TIME]. شكراً لثقتك!'
   - failed: 'تعذّر التوصيل. إليك خياراك:
     1️⃣ إعادة التوصيل غداً
     2️⃣ تغيير العنوان
     3️⃣ الاستلام من فرعنا في [BRANCH]'

4. الرسائل الاستباقية Proactive:
   عند تغيير حالة الطلب → أرسل إشعاذاً واتساب فوراً للعميل

   قوالب مُعتمدة مسبقاً من Meta:
   - order_confirmed: 'تأكيد طلبك رقم {{1}} قيمة {{2}} ريال'
   - driver_assigned: 'السائق {{1}} سيوصل طلبك خلال {{2}} ساعة'
   - delivery_imminent: 'سائقنا على بعد 15 دقيقة من موقعك!'
   - delivery_confirmed: 'تم التوصيل. قيّم تجربتك 1-5: {{1}}'
"""

// البرومبت لكلود — COD Management System:
"""
اكتب COD Management Module يُدير تدفق الدفع عند الاستلام:

جانب السائق (Driver App via WhatsApp):
1. عند التوصيل: يتلقى السائق رسالة 'طلب #X — المبلغ: 245 ريال
   الزبون: [الاسم] — الهاتف: [PHONE]'
   خيارات الرد:
   ✅ 'تحصّلت' — يطلب البوت صورة الإيصال أو بصمة العميل
   ❌ 'رفض الاستلام' — يطلب سبب: [لا يوجد / طلب إلغاء / غائب]
   🔄 'تأجيل' — يُسأل عن الوقت المناسب

2. تسوية يومية للسائق:
   في نهاية كل يوم: 'مجموع COD المحصّل اليوم: X ريال
   عدد الطلبات: Y — يرجى الإيداع في حساب الشركة
   رقم المرجع: [AUTO-GENERATED]'

جانب العميل:
1. إشعار قبل التوصيل بساعة:
   'سيصلك طلبك خلال ساعة. المبلغ المطلوب: 245 ريال نقداً
   لا تملك نقداً؟ اضغط هنا لتحويل للدفع الإلكتروني'

2. عند تغيير لدفع إلكتروني:
   إرسال رابط دفع Tap/Moyasar للعميل
   عند الدفع: إشعار السائق بعدم الحاجة لتحصيل نقد

جانب الإدارة (Dashboard):
- تقرير COD اليومي: مُحصَّل / مرفوض / معلق
- إشعار فوري عند كل رفض مع تفاصيل السبب
- تتبع الإيداعات اليومية للسائقين مقابل المطلوب
- تنبيه إذا تجاوز معدل رفض سائق معين 15%
"""

// البرومبت لكلود — Zone-Based Driver Assignment:
"""
اكتب Driver Assignment Service يُعيّن السائقين بذكاء:

هيكل المناطق (قابل للتعديل في قاعدة البيانات):
zones = {
  'north_riyadh': {
    'polygons': [[lat,lng], [lat,lng], ...],  // حدود المنطقة
    'drivers': ['D001', 'D002', 'D003'],
    'max_deliveries_per_driver': 20
  },
  'south_riyadh': { ... },
  'east_riyadh': { ... }
}

خوارزمية التعيين:
1. تحديد منطقة العنوان:
   استخدم Google Maps Geocoding API للعنوان النصي
   أو احتسب polygon containment للإحداثيات المشاركة

2. البحث عن أفضل سائق في المنطقة:
   معايير الترتيب (بالأولوية):
   a. متاح ولم يتجاوز الحد اليومي (< 20 توصيل)
   b. أقل حمل حالي (أقل طلبات معلقة)
   c. الأقرب جغرافياً للعنوان (من آخر موقع مُبلَّغ)
   d. أعلى معدل تسليم ناجح (تاريخياً)

3. Fallback عند عدم وجود سائق:
   a. ابحث في المنطقة المجاورة
   b. إذا تعذّر: أضف لـ overflow pool للتسليم الغد
   c. أشعر dispatcher بشريّاً

4. إعادة التخطيط الديناميكي:
   إذا أبلغ سائق عن عطل أو طارئ:
   أعد توزيع طلباته المتبقية على أقرب السائقين المتاحين
   مع إشعار العملاء المتأثرين بالتأخير الجديد
"""

// البرومبت لكلود — Driver WhatsApp Portal:
"""
اكتب تدفق محادثة للسائق عبر رقم واتساب منفصل:

1. بداية يوم العمل:
   السائق يُرسل 'جاهز' → البوت يُرسل قائمة توصيلاته اليوم:
   '🚚 مرحباً أحمد! لديك 14 توصيل اليوم
   المنطقة: شمال الرياض
   أول توصيل: [العنوان] — طلب #1234
   اضغط [بدء] لتفعيل التتبع'

2. تسلّم كل طلب:
   السائق يُرسل صورة الباركود أو رقم الطلب →
   البوت يُؤكد: 'استلمت طلب #X ✓ — انطلق لـ [العنوان]'

3. التحديثات خلال التوصيل:
   'وصلت للحي' → البوت يُشعر العميل تلقائياً
   'طرقت الباب لا يرد' → البوت يُرسل رسالة للعميل
   ويُعطي السائق خيار: 'انتظر 5 دق' / 'اتصل هاتفياً' / 'ارجع لاحقاً'

4. تأكيد التسليم:
   السائق يرفع صورة الطرد أمام الباب أو التوقيع الرقمي →
   البوت يُسجّل التسليم ويُشعر العميل والشركة فوراً

5. الإبلاغ عن مشاكل:
   خيارات جاهزة: [طرد تالف] [عنوان خاطئ] [العميل رفض]
   [حادث / عطل] [مشكلة في النظام]
   كل خيار يُشغّل تدفق استجابة مختلف

6. نهاية يوم العمل:
   ملخص تلقائي: X تم، Y مُعاد، Z معلق
   مجموع COD: [المبلغ] ريال
   مطلوب إيداعه قبل 10 مساءً
"""

// البرومبت لكلود — Multilingual Detection & Response:
"""
اكتب LanguageDetectionMiddleware للبوت اللوجستي:

1. كشف اللغة التلقائي:
   استخدم Claude لتصنيف كل رسالة واردة:
   - عربية (AR): خليجية، مصرية، شامية
   - إنجليزية (EN)
   - أردو (UR)
   - مختلطة: تعامل مع اللغة الأكثر حضوراً

   ثم احفظ language preference للعميل في session

2. قوالب الردود متعددة اللغات:
   responses = {
     'tracking_response': {
       'AR': 'طلبك رقم {order_num} — الحالة: {status}',
       'EN': 'Your order #{order_num} — Status: {status}',
       'UR': 'آپ کا آرڈر #{order_num} — حیثیت: {status}'
     },
     'driver_on_way': {
       'AR': 'السائق {driver_name} في طريقه إليك',
       'EN': 'Driver {driver_name} is on the way',
       'UR': 'ڈرائیور {driver_name} آپ کی طرف آ رہا ہے'
     },
     ...
   }

3. للموظفين في المستودع (Urdu-speaking):
   بوابة منفصلة يتلقون بها:
   - قوائم التجهيز اليومية بالأردو
   - تأكيد شحن كل طلب
   - الإبلاغ عن نواقص أو أضرار
   باللغة التي يفهمونها دون الحاجة للترجمة اليدوية
"""

// البرومبت لكلود — Complaint Resolution System:
"""
اكتب ComplaintManagementSystem يُعالج شكاوى التوصيل:

تصنيف تلقائي بالذكاء الاصطناعي:
يُحدّد كلود نوع الشكوى من سياق المحادثة:

نوع 1 — التأخير:
- جمع: الوقت المتوقع الأصلي، الوقت الفعلي، سبب التأخير
- إجراء: اعتذار مُخصّص + وقت تسليم محدّث
- تعويض تلقائي إذا > 24 ساعة: قسيمة خصم 15%

نوع 2 — طرد تالف:
- جمع: صور الضرر من العميل (مطلوبة)
- تقييم آلي: تالف جزئياً / كلياً
- إجراء تلقائي: فتح تذكرة تأمين + إعادة شحن مجانية
- Escalate فوراً للإدارة إذا قيمة > 500 ريال

نوع 3 — خطأ في الطلب:
- تحقق من التطابق مع الطلب الأصلي
- إذا خطأ من الشركة: ترتيب استلام الخطأ + تسليم الصحيح
- إذا خطأ من التاجر: تحويل للتاجر مع رقم المرجع

نوع 4 — السائق غائب / لم يتصل:
- تحقق من logs التواصل
- إذا ثبت إهمال السائق: تسجيل في ملفه + إشعار المشرف
- تعيين سائق بديل فوراً

SLA لكل نوع:
- رد أولي: < 5 دقائق
- حل كامل: 24-48 ساعة حسب النوع
- تصعيد تلقائي إذا لم يُحل خلال SLA
"""