ל-EvaSay יש יומן תורים משלו: סוכנים עם פונקציות קביעת התורים בודקים בו זמנים פנויים, קובעים ומבטלים תורים במהלך שיחות וצ׳אטים, והצוות שלכם רואה אותו בדף תורים. ה-API עובד על אותו יומן, כך שגם האתר שלכם, מערכת התורים או הקבלה יכולים להשתמש בו. ימי ושעות הפעילות, אורך תור והצוות מוגדרים ב-תורים ← שעות קביעת תורים; התאריכים והשעות הם באזור הזמן של היומן.
| שיטה | נתיב | מה עושה |
|---|---|---|
| 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.