EvaSay’in kendi randevu takvimi vardır: randevu işlevleri olan agent’lar aramalarda ve sohbetlerde bu takvimde boş saatlere bakar, randevu verir ve iptal eder; ekibiniz takvimi Randevular sayfasında görür. API aynı takvim üzerinde çalışır; böylece web siteniz, randevu sisteminiz veya resepsiyonunuz da onu kullanabilir. Açık günler ve saatler, bir randevunun süresi ve personel Randevular → Randevu saatleri altında ayarlanır; tarihler ve saatler takvimin saat dilimindedir.
| Yöntem | Yol | Ne yapar |
|---|---|---|
| GET | /api/v1/voice/appointments/availability?date=2030-01-07 | O gün boş başlangıç saatleri; tek bir kişininkiler için staff |
| GET | /api/v1/voice/appointments?from=2030-01-07&days=7 | O günden itibaren randevular (days en fazla 31), takvimin settings değeriyle |
| POST | /api/v1/voice/appointments | Randevu alır |
| GET | /api/v1/voice/appointments/{id} | Bir randevu |
| PATCH | /api/v1/voice/appointments/{id} | status, notes veya service değerini değiştirir |
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 ve name zorunludur; phone, email, service, staff ve notes isteğe bağlıdır. Bir randevu agent’ın kurallarına uyar: takvim o saatte açık olmalı ve biri boş olmalıdır; ya staff ile istenen kişi ya da belirtilmezse herhangi biri (personel yoksa işletme aynı anda tek randevu alır). Dolu bir saat veya çalışma saatleri dışındaki bir saat 409 ve appointment_conflict koduyla yanıt verir. Uluslararası biçimdeki bir telefon numarası randevuyu o müşteriye bağlar ya da müşterilerinize ekler. Yanıt, source değeri api olan randevudur.
Bir randevu booked, completed (geldi), no_show veya cancelled olur; yer bekleyen randevu waitlisted olur. Ziyareti sonradan işaretleyin:
{ "status": "completed" }
Tamamlanan bir ziyaret müşterinin ziyaretlerine sayılır. İptal saati boşaltır; randevuya 15 dakikadan fazla varsa o saat için bekleme listesindeki ilk kişi yerleştirilir. Bekleme listesindeki bir randevu yalnızca iptal edilebilir. Sistemleriniz randevulardan appointment.created ve appointment.updated webhook olaylarıyla anında haberdar olur.