EvaSay heeft een eigen boekingsagenda: agents met de boekingsfuncties zoeken er tijdens gesprekken en chats vrije tijden in, boeken en annuleren, en je team ziet hem op de pagina Afspraken. De API werkt met dezelfde agenda, zodat ook je website, je boekingssysteem of je receptie hem kan gebruiken. Openingsdagen en -tijden, de duur van een boeking en de medewerkers stel je in onder Afspraken → Boekingstijden; datums en tijden gelden in de tijdzone van de agenda.
| Methode | Pad | Wat het doet |
|---|---|---|
| GET | /api/v1/voice/appointments/availability?date=2030-01-07 | De vrije begintijden op die dag; staff voor die van één persoon |
| GET | /api/v1/voice/appointments?from=2030-01-07&days=7 | De afspraken vanaf die dag (days tot 31), met de settings van de agenda |
| POST | /api/v1/voice/appointments | Een afspraak boeken |
| GET | /api/v1/voice/appointments/{id} | Eén afspraak |
| PATCH | /api/v1/voice/appointments/{id} | De status, notes of service wijzigen |
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 en name zijn verplicht; phone, email, service, staff en notes zijn optioneel. Een boeking volgt de regels van de agent: de agenda moet op dat moment open zijn en er moet iemand vrij zijn, de gevraagde medewerker uit staff of, zonder voorkeur, iemand (zonder medewerkers neemt het bedrijf één boeking tegelijk aan). Een bezette tijd of een tijd buiten de openingstijden geeft 409 met de code appointment_conflict. Een telefoonnummer in internationaal formaat koppelt de boeking aan die klant, of voegt die toe aan je klanten. Het antwoord is de afspraak, met source api.
Een afspraak is booked, completed (geweest), no_show of cancelled; een afspraak die op een plek wacht, is waitlisted. Markeer het bezoek achteraf:
{ "status": "completed" }
Een afgerond bezoek telt mee bij de bezoeken van de klant. Annuleren maakt de tijd vrij; ligt die meer dan 15 minuten in de toekomst, dan krijgt de eerste op de wachtlijst voor die tijd de plek. Een afspraak op de wachtlijst kan alleen geannuleerd worden. Je systemen horen direct van boekingen via de webhook-gebeurtenissen appointment.created en appointment.updated.