لدى EvaSay تقويم حجز خاص به: يتحقق الوكلاء الذين لديهم وظائف الحجز من الأوقات المتاحة فيه، ويحجزون ويلغون أثناء المكالمات والمحادثات، ويراه فريقك في صفحة المواعيد. تعمل الواجهة البرمجية على التقويم نفسه، فيمكن لموقعك أو نظام الحجز لديك أو مكتب الاستقبال استخدامه أيضًا. تُضبط أيام العمل وساعاته ومدة الحجز والموظفون من المواعيد ← أوقات الحجز؛ والتواريخ والأوقات بالمنطقة الزمنية للتقويم.
| الطريقة | المسار | ما تفعله |
|---|---|---|
| GET | /api/v1/voice/appointments/availability?date=2030-01-07 | أوقات البدء المتاحة في ذلك اليوم؛ وstaff لأوقات شخص واحد |
| GET | /api/v1/voice/appointments?from=2030-01-07&days=7 | المواعيد بدءًا من ذلك اليوم (days حتى 31)، مع settings التقويم |
| POST | /api/v1/voice/appointments | حجز موعد |
| GET | /api/v1/voice/appointments/{id} | موعد واحد |
| PATCH | /api/v1/voice/appointments/{id} | تغيير status أو notes أو service |
curl https://evasay.com/api/v1/voice/appointments \
-X POST \
-H "Authorization: Bearer sk-your-key" \
-H "Content-Type: application/json" \
-d '{ "date": "2030-01-07", "time": "10:00", "name": "Ana Silva", "phone": "+14155550123", "service": "Haircut" }'
الحقول date وtime وname مطلوبة؛ وphone وemail وservice وstaff وnotes اختيارية. يتبع الحجز قواعد الوكيل: يجب أن يكون التقويم مفتوحًا في ذلك الوقت وأن يكون أحدهم متاحًا، إما الموظف المطلوب في staff أو أي شخص إن لم يُحدَّد (ومن دون موظفين يقبل النشاط حجزًا واحدًا في كل مرة). الوقت المحجوز أو الواقع خارج ساعات العمل يُرجع 409 مع الرمز appointment_conflict. رقم الهاتف بالصيغة الدولية يربط الحجز بذلك العميل أو يضيفه إلى عملائك. الرد هو الموعد، وقيمة source فيه api.
يكون الموعد booked أو completed (حضر) أو no_show أو cancelled؛ والموعد الذي ينتظر مكانًا يكون waitlisted. علّم الزيارة بعدها:
{ "status": "completed" }
تُحتسب الزيارة المكتملة ضمن زيارات العميل. إلغاء الموعد يحرّر وقته؛ وإن بقي عليه أكثر من 15 دقيقة يُحجز فيه أول شخص على قائمة الانتظار لذلك الوقت. لا يمكن إلا إلغاء الموعد الموجود على قائمة الانتظار. وتعلم أنظمتك بالحجوزات فور حدوثها عبر أحداث webhook appointment.created وappointment.updated.