EvaSaylla on oma varauskalenteri: varaustoiminnoilla varustetut agentit katsovat siitä vapaat ajat, varaavat ja peruvat aikoja puheluiden ja chattien aikana, ja tiimisi näkee sen sivulla Ajanvaraukset. API käyttää samaa kalenteria, joten myös verkkosivustosi, varausjärjestelmäsi tai vastaanottosi voi käyttää sitä. Aukiolopäivät ja -ajat, varauksen kesto ja henkilökunta asetetaan kohdassa Ajanvaraukset → Varausajat; päivämäärät ja kellonajat ovat kalenterin aikavyöhykkeellä.
| Menetelmä | Polku | Mitä se tekee |
|---|---|---|
| GET | /api/v1/voice/appointments/availability?date=2030-01-07 | Päivän vapaat alkamisajat; staff yhden henkilön ajoille |
| GET | /api/v1/voice/appointments?from=2030-01-07&days=7 | Varaukset siitä päivästä alkaen (days enintään 31) ja kalenterin settings |
| POST | /api/v1/voice/appointments | Varaa aika |
| GET | /api/v1/voice/appointments/{id} | Yksi varaus |
| PATCH | /api/v1/voice/appointments/{id} | Muuta sen status, notes tai 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 ja name ovat pakollisia; phone, email, service, staff ja notes ovat valinnaisia. Varaus noudattaa agentin sääntöjä: kalenterin on oltava auki siihen aikaan ja jonkun on oltava vapaana, joko staff-kentässä pyydetyn henkilön tai, ilman sitä, kenen tahansa (ilman henkilökuntaa yritys ottaa yhden varauksen kerrallaan). Varattu aika tai aukioloajan ulkopuolinen aika palauttaa 409 ja koodin appointment_conflict. Kansainvälisessä muodossa oleva puhelinnumero liittää varauksen siihen asiakkaaseen tai lisää hänet asiakkaisiisi. Vastaus on varaus, jonka source on api.
Varaus on booked, completed (käynyt), no_show tai cancelled; paikkaa odottava on waitlisted. Merkitse käynti jälkikäteen:
{ "status": "completed" }
Toteutunut käynti lasketaan asiakkaan käynteihin. Peruutus vapauttaa ajan; jos siihen on yli 15 minuuttia, jonon ensimmäinen samaan aikaan odottava saa paikan. Jonossa olevan varauksen voi vain perua. Järjestelmäsi kuulevat varauksista heti webhook-tapahtumista appointment.created ja appointment.updated.