Az EvaSay saját foglalási naptárral rendelkezik: a foglalási funkciókkal rendelkező ügynökök hívások és csevegések közben ebben nézik meg a szabad időpontokat, foglalnak és mondanak le, csapata pedig az Időpontok oldalon látja. Az API ugyanezzel a naptárral dolgozik, így webhelye, foglalási rendszere vagy recepciója is használhatja. A nyitvatartási napokat és órákat, egy foglalás hosszát és a munkatársakat az Időpontok → Foglalási idők alatt állíthatja be; a dátumok és időpontok a naptár időzónájában értendők.
| Metódus | Útvonal | Mit csinál |
|---|---|---|
| GET | /api/v1/voice/appointments/availability?date=2030-01-07 | Az aznapi szabad kezdési időpontok; staff egy személyéhez |
| GET | /api/v1/voice/appointments?from=2030-01-07&days=7 | Az időpontok attól a naptól (days legfeljebb 31), a naptár settings értékével |
| POST | /api/v1/voice/appointments | Időpont foglalása |
| GET | /api/v1/voice/appointments/{id} | Egy időpont |
| PATCH | /api/v1/voice/appointments/{id} | A status, notes vagy service módosítása |
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" }'
A date, time és name kötelező; a phone, email, service, staff és notes nem kötelező. A foglalás az ügynök szabályait követi: a naptárnak akkor nyitva kell lennie, és valakinek szabadnak kell lennie, vagy a staff mezőben kért munkatársnak, vagy ennek hiányában bárkinek (munkatársak nélkül a vállalkozás egyszerre egy foglalást fogad). Foglalt időpontra vagy nyitvatartáson kívüli időpontra a válasz 409, appointment_conflict kóddal. A nemzetközi formátumú telefonszám az ügyfélhez kapcsolja a foglalást, vagy felveszi őt az ügyfelei közé. A válasz maga az időpont, source értéke api.
Egy időpont booked, completed (megjelent), no_show vagy cancelled; a helyre várakozó waitlisted. Utána jelölje meg a látogatást:
{ "status": "completed" }
A teljesült látogatás beszámít az ügyfél látogatásaiba. A lemondás felszabadítja az időpontot; ha még több mint 15 perc van hátra, a várólistán arra az időpontra első személy kerül be. Várólistás időpontot csak lemondani lehet. Rendszerei azonnal értesülnek a foglalásokról az appointment.created és appointment.updated webhook-eseményekből.