خدمة الحجز هي نظام شامل لإدارة المواعيد يتيح لك إلى:

• أنشئ وأدار خدمات الحجز لعملك
• حدد مواعيد باستخدام تذكيرات آلية
• حالة حجز المسارات طوال دورة الحياة
• أرسل متابعات آلية بعد المواعيد
• ادمجها مع سير عمل روبوتات الدردشة الخاصة بك

مهم: خدمات الحجز مشتركة عبر جميع الروبوتات في مساحة عملك، مع حد أقصى يبلغ 20 خدمة حجز.

• حدد أنواع التعيينات المختلفة (الاستشارات، الاجتماعات، الخدمات، إلخ)
• حدد المدة الافتراضية لكل نوع خدمة
• تكوين معرفات الخدمة المخصصة (واجهة الخدمة UID)
• تمكين أو تعطيل الخدمات حسب الحاجة

• قم بإعداد حتى 5 تسلسلات تذكيرات لكل خدمة
• ضبط توقيت التذكير (الأيام، الساعات، دقائق قبل الموعد)
• تخصيص رسائل التذكير
• تفعيل التذكير التلقائي بناء على الوقت المجدول

• قم بإعداد ما يصل إلى 5 تسلسلات متابعة لكل خدمة
• أرسل متابعات بعد المواعيد المكتملة أو غير الحضورية
• ضبط توقيت المتابعة (الأيام، الساعات، الدقائق بعد الموعد)
• تخصيص رسائل المتابعة

حجوزات المسارات طوال دورة حياتها الكاملة:

• قيد الانتظار: حالة الحجز الأولي
• تم التأكيد: تم تأكيد الحجز
• جار الاجتماع: بدأ الاجتماع/الموعد
• تم الإكمال: تم الانتهاء بنجاح
• ملغى: تم إلغاء الحجز
• عدم حضور: لم يحضر الزبون
• غير نشط: الخدمة لم تعد نشطة

• أوقات البداية والنهاية
• المدة (بالدقائق)
• تفاصيل الموقع
• تتبع المصدر
• بيانات وصفية مخصصة
• نظام التقييم (0-5 نجوم)
• أسباب الإلغاء/إعادة الجدولة
• سجلات التدقيق الكاملة

• حساب Workspace مع إضافة Ticket/Lists/Bookings مفعلة
• الوصول إلى إدارة خدمة الحجز
• فهم أساسي لمنطقة زمنية مكان عملك

1. انتقل إلى خدمات الحجز
   • اذهب إلى إعدادات مساحة العمل الخاصة بك
   • اختر "خدمات الحجز" من القائمة
2. أنشئ أول خدمة حجز لك
   • انقر على زر "+ خدمة الحجز"
   • املأ المعلومات المطلوبة
   • تكوين التذكيرات والمتابعات
   • وفر خدمتك
3. التكامل مع Chatbot
   • استخدم معرف الخدمة UID للإشارة إلى الخدمة في تدفقات البوت الخاصة بك
   • تكوين المشغلات لحجز الأحداث
   • قم بإعداد الردود الآلية

يعمل نظام الحجز على أساس عمل مجدول:

1. إنشاء الحجز: عند إنشاء الحجز، يقوم النظام تلقائيا بإنشاء تذكيرات وجداول متابعة بناء على إعدادك.
2. معالجة التذكيرات:
   • يستمر كل دقيقة
   • التحقق من التذكيرات المعلقة خلال فترة ساعتين
   • يرسل التذكيرات والتحديثات إلى حالة "تم الإرسال"
3. فعاليات الاجتماعات:
   • بدء الاجتماع: يتم تفعيله تلقائيا عند الوصول إلى وقت البدء
   • نهاية الاجتماع: يتم تفعيلها تلقائيا عند الوصول إلى وقت الانتهاء
4. معالجة المتابعة:
   • تم الجدول بعد انتهاء الحجز أو عدم الحضور
   • يعمل بنفس جدول التذكيرات
   • يرسل فقط للحجوزات المكتملة أو غير الحضورية

الحقول المطلوبة:

• الاسم: اسم العرض لخدمتك (الحد الأقصى 100 حرف)
• معرف الخدمة UID: معرف فريد يستخدم الأحرف الأبجدية الرقمية (حد أقصى 50 حرفا)
  • لا يمكن تغييره بعد الإنشاء
  • مثال: consultation_30min، ، demo_callsupport_session
• الوصف: وصف مفصل (الحد الأقصى 1000 حرف)
• المدة الافتراضية: المدة بالدقائق (0-1000)
• الحالة: نشط أو غير نشط

لكل تذكير:

1. رقم التسلسل: تم تعيينه تلقائيا (1-5)
2. العنوان: وصف مختصر (الحد الأقصى 50 حرفا)
3. الوصف: رسالة مفصلة (الحد الأقصى 500 حرف)
4. التوقيت: حدد متى ترسل التذكير
   • أيام قبل وقت البدء
   • ساعات قبل وقت البدء
   • دقائق قبل وقت البدء
5. الحالة: نشط أو غير نشط

مثال على تكوين التذكير:

Reminder 1:
- Title: "Appointment Tomorrow"
- Days: 1, Hours: 0, Minutes: 0
- Description: "Your appointment is tomorrow at [TIME]"
Reminder 2:
- Title: "Appointment in 1 Hour"
- Days: 0, Hours: 1, Minutes: 0
- Description: "Your appointment starts in 1 hour"

لكل متابعة مميزة:

1. رقم التسلسل: تم تعيينه تلقائيا (1-5)
2. العنوان: وصف مختصر (الحد الأقصى 50 حرفا)
3. الوصف: رسالة مفصلة (الحد الأقصى 500 حرف)
4. التوقيت: حدد متى ترسل المتابعة
   • أيام بعد نهاية الزمن
   • ساعات بعد انتهاء الوقت
   • دقائق بعد انتهاء الوقت
5. الحالة: نشط أو غير نشط

مثال على تكوين المتابعة:

Follow-up 1:
- Title: "How was your appointment?"
- Days: 0, Hours: 2, Minutes: 0
- Description: "We'd love to hear about your experience"
Follow-up 2:
- Title: "Follow-up Survey"
- Days: 1, Hours: 0, Minutes: 0
- Description: "Please take a moment to complete our survey"

المعلومات المطلوبة:

• معرف الخدمة UID أو معرف خدمة الحجز
• وقت البدء (في منطقة توقيت مساحة العمل)
• الحالة الأولية (معلق أو مؤكد)

معلومات اختيارية:

• مدة التعديل (التعديلات الافتراضية)
• الموقع (الحد الأقصى 1,000 حرف)
• المصدر (الحد الأقصى 100 حرف)
• البيانات الوصفية (الحد الأقصى 5,000 حرف)
• ملاحظات (الحد الأقصى 1000 حرف)

ملاحظات مهمة:

• يجب أن يكون وقت البدء في المستقبل
• يتم جدولة التذكيرات تلقائيا

• حالة التغييرات من معلقة إلى مؤكدة
• متاح فقط للحجوزات المعلقة
• الرسائل BOOKING_CONFIRMED الحدث

• وقت بدء التحديثات ووقت الانتهاء ولمدة
• يمكن تغيير الحالة إلى معلق أو مؤكد
• تذكيرات محفوظة أرسلت بالفعل
• إعادة جدولة التذكيرات المتبقية
• يتطلب إعادة جدولة (الحد الأقصى 500 حرف)

القيود:

• لا يمكن إعادة جدولة الحجوزات الجارية
• لا يمكن إعادة جدولة الحجوزات النهائية على مستوى الولاية (ملغاة، مكتملة، غير موجودة)

• حالة التغييرات إلى ملغاة
• إلغاء جميع التذكيرات والمتابعات المعلقة
• يتطلب سبب الإلغاء (الحد الأقصى 500 حرف)
• لا يمكن إلغاء الحجوزات النهائية على مستوى الولاية

• حالة التغييرات إلى مكتمل
• يتخطى أي تذكيرات غير مرسلة
• رسائل المتابعة في الجداول
• لا يمكن إكمال الحجوزات النهائية للولاية

• تغيير الحالة إلى عدم الحضور
• يتخطى أي تذكيرات غير مرسلة
• رسائل المتابعة في الجداول (نفس الرسائل المكتملة)
• لا يمكن تصنيف الحجوزات النهائية على مستوى الولاية كغياب

• تقييم المجموعة من 0 إلى 5 نجوم
• يمكن تحديثه في أي وقت
• يسجل تغيير التصنيف

• تعديل الموقع أو المصدر أو البيانات الوصفية
• لا يؤثر على الحالة أو الجدول الزمني

• إزالة الحجز بشكل دائم
• حذف جميع التذكيرات والمتابعات والسجلات المرتبطة
• لا يمكن التراجع عنها

الجدولة:

• يتم إنشاؤه عند إنشاء الحجز
• محسوبة كالتالي: start_time - (أيام + ساعات + دقائق)
• الحالة مضبوطة على "قيد الانتظار" إذا كان في المستقبل، و"تم تخطي" إذا كانت في الماضي

الإرسال:

• يتم إرسال التذكيرات عند الوصول إلى الوقت المجدول
• تغييرات الحالة في "أرسل"
• أرسلت السجلات طابع زمني
• المحفزات REMINDER_SENDING الحدث

الحالة:

• قيد الانتظار: بانتظار الإرسال
• تم الإرسال: تم التسليم بنجاح
• تم تخطي: لم يتم إرسالها (مر الوقت أو تم إلغاء الحجز)
• ملغى: تم إلغاء الحجز

إعادة الجدولة:

• فقط التذكيرات غير المرسلة يتم إعادة جدولتها
• التذكيرات المرسلة محفوظة
• يتم حساب أوقات مجدولة جديدة

الجدولة:

• يتم إنشاؤه فقط عندما يتم وضع علامة على الحجز كمكتمل أو غير حاضر
• محسوبة كالتالي: end_time + (أيام + ساعات + دقائق)
• الحالة مضبوطة على "قيد الانتظار" إذا كان في المستقبل، و"تم تخطي" إذا كانت في الماضي

الإرسال:

• ترسل المتابعة عند الوصول إلى الوقت المحدد
• تغييرات الحالة في "أرسل"
• أرسلت السجلات طابع زمني
• المحفزات FOLLOWUP_SENDING الحدث

مهم:

• لا يتم إنشاء المتابعة عند وقت الحجز
• يتم جدولتها فقط بعد الانتهاء أو غيابها
• الحجوزات الملغاة لا تتلقى متابعات

Created → Pending → Confirmed → In Progress → Completed
↓ ↓
Cancelled No Show

1. BOOKING_CREATED: إنشاء الحجز الأولي
2. BOOKING_CONFIRMED: تم تأكيد الحجز من قبل المستخدم أو النظام
3. REMINDER_SENDING: كل تذكير عند إرساله
4. MEETING_STARTED: انتهى وقت البدء
5. MEETING_ENDED: وصل وقت الانتهاء (يكمل الحجز تلقائيا)
6. BOOKING_COMPLETED: يتم إكماله يدويا أو تلقائيا
7. BOOKING_NO_SHOW: تم وسم كغير حاضر
8. FOLLOWUP_SENDING: كل متابعة عند إرسالها
9. UPDATE_RATING: تحديث التقييم
10. BOOKING_RESCHEDULED: تغير وقت الحجز
11. BOOKING_CANCELLED: تم إلغاء الحجز

• قيد الانتظار/المؤكد → قيد التنفيذ: متى يتم الوصول إلى start_time
• قيد التنفيذ → اكتمل: عند الوصول إلى end_time (عبر العملية التلقائية)

• list_booking_services: احصل على جميع خدمات الحجز
• get_booking_service: احصل على تفاصيل الخدمة المحددة
• list_booking_service_reminders: احصل على تذكيرات لخدمة
• list_booking_service_followups: احصل على متابعة لخدمة

• list_bookingsاحصل على الحجوزات (مصفية حسب المستخدم، الخدمة، الحالة)
• get_booking: احصل على تفاصيل حجز محددة
• create_booking: إنشاء حجز جديد
• confirm_booking: تأكيد الحجز المعلق
• reschedule_booking: تغيير وقت الحجز
• cancel_booking: إلغاء الحجز
• mark_booking_completed: وسم كمكتمل
• mark_booking_no_show: مارك كغير حاضر
• update_booking_rating: تقييم تحديث

المعايير الشائعة:

• bot_user_nsمعرف مستخدم البوت (للاختبار)
• service_uid: معرف الخدمة الفريد
• booking_id: رقم الحجز المحدد

إنشاء الحجز:

• start_time: تنسيق ISO 8601 UTC (مثلا، "2020-01-02T12:30:00Z")
• duration: الدقائق (اختيارية، تستخدم الافتراضية إذا لم يتم تحديدها)
• pending_or_confirmed: الحالة الأولية
• location: موقع الموعد
• source: مصدر الحجز
• metadata: بيانات مخصصة (سلسلة JSON)
• notes: ملاحظات إضافية

تحديثات الحالة:

• reschedule_reason: سبب إعادة الجدولة (الحد الأقصى 500 حرف)
• cancel_reason: سبب الإلغاء (الحد الأقصى 500 حرف)
• rating: العدد بين 0-5

User → System: Create Booking Request
System → Database: Create booking record
System → Database: Generate reminder schedules
System → Database: Save reminder records
System → EventDispatcher: Dispatch BOOKING_CREATED
EventDispatcher → Triggers: Process configured triggers
System → User: Return booking confirmation

CronJob → System: Run reminder processor (every minute)
System → Database: Query pending reminders (2-hour window)
Database → System: Return pending reminders
System → Validator: Check booking status
Validator → System: Validate service is active
System → BotUser: Retrieve bot user details
System → EventDispatcher: Dispatch REMINDER_SENDING event
EventDispatcher → Triggers: Execute reminder flow
System → Database: Update reminder status to 'sent'
System → Database: Record sent timestamp

User/System → System: Mark booking complete
System → Database: Update booking status to 'completed'
System → Database: Skip unsent reminders
System → Database: Calculate follow-up schedules
System → Database: Create follow-up records
System → EventDispatcher: Dispatch BOOKING_COMPLETED
EventDispatcher → Triggers: Process completion triggers
System → User: Return success response

CronJob → System: Run booking processor (every minute)
System → Database: Query bookings with start_time reached
Database → System: Return matching bookings
System → EventDispatcher: Dispatch MEETING_STARTED event
System → Database: Update status to 'in_progress'
[Later...]
System → Database: Query bookings with end_time reached
Database → System: Return matching bookings
System → EventDispatcher: Dispatch MEETING_ENDED event
System → Database: Update status to 'completed'
System → Database: Schedule follow-ups

User → System: Reschedule request
System → Validator: Check booking status
Validator → System: Validate can reschedule
System → Database: Get sent reminder sequences
System → Database: Delete unsent reminders
System → Database: Update booking times
System → Database: Increment reschedule_count
System → Database: Calculate new reminder schedules
System → Database: Create new reminder records
System → EventDispatcher: Dispatch BOOKING_RESCHEDULED
System → User: Return updated booking

mermaid.live

• استخدم أسماء خدمات واضحة ووصفية
• أنشئ معرفات خدمة فريدة يسهل الرجوع إليها
• حدد مدة افتراضية واقعية
• تذكير الاختبار وتوقيت المتابعة قبل البث

• لا تذكرك كثيرا (عادة ما يكون 2-3 تذكيرات كافية)
• تذكيرات الفراغ بشكل مناسب (مثلا، قبل يوم واحد، أو ساعة قبلها)
• اجعل رسائل التذكير واضحة وقابلة للتنفيذ
• أدرج تفاصيل الحجز ذات الصلة في التذكيرات

• أرسل متابعة فورية للحصول على ملاحظات (بعد 2-4 ساعات)
• أرسل طلب الاستبيان بعد 24 ساعة من الموعد
• حافظ على رسائل المتابعة مختصرة ومركزة
• دائما قم بتضمين خيارات الانسحاب

• دائما قدم أسباب الإلغاء للتحليلات
• استخدم حقل الملاحظات لالتقاط السياق المهم
• تحديث التقييمات لتتبع جودة الخدمة
• راجع سجلات الحجز بانتظام

• اختبر دورة حياة الحجز الكاملة قبل الإطلاق
• تحقق من توقيت التذكير في منطقتك الزمنية
• سيناريوهات إعادة جدولة الاختبار
• التحقق من فعالية إطلاق النار بشكل صحيح

تذكيرات لا ترسل الطلبات:

• التحقق من التذكير مضبوط على "نشط"
• تحقق من أن الوقت المجدول في المستقبل
• تأكد من أن خدمة الحجز نشطة
• حالة حجز الشيك ليست في الحالة النهائية

المتابعة التي لا ترسل الطلبات:

• المتابعة ترسل فقط بعد الانتهاء أو عدم الحضور
• تحقق من المتابعة مضبوطة على "نشط"
• تحقق من اكتمال الحجز/عدم الحضور (لم يلغى)
• تأكد من صحة الوقت المجدول

لا يمكن إعادة الجدولة:

• تأكد من أن الحجز ليس في الحالة النهائية
• تحقق من أن الحجز غير جار حاليا
• خدمة التحقق لا تزال نشطة

مشاكل في المنطقة الزمنية:

• جميع الأوقات المخزنة في UTC
• يتم تحويل أوقات العرض إلى منطقة زمنية في مساحة العمل
• تحقق من صحة إعدادات منطقة الوقت في مساحة العمل

• الحد الأقصى لخدمات الحجز: 20 لكل مساحة عمل
• أقصى تذكيرات: 5 لكل خدمة
• الحد الأقصى للمتابعات: 5 لكل خدمة
• حدود الميدان:
  • الاسم: 100 حرف
  • معرف الخدمة UID: 50 حرفا
  • الوصف: 1000 حرف
  • تذكير/عنوان متابعة: 50 حرفا
  • تذكير/وصف متابعة: 500 حرف
  • سبب إعادة الجدولة: 500 حرف
  • سبب الإلغاء: 500 حرف
  • الموقع: 1,000 حرف
  • المصدر: 100 حرف
  • البيانات الوصفية: 5,000 حرف
  • ملاحظات: 1000 حرف