EvaSay har sin egen bookingkalender: agenter med bookingfunksjonene sjekker ledige tider, booker og avlyser i den under samtaler og chatter, og teamet ditt ser den på siden Avtaler. API-et jobber på den samme kalenderen, så nettstedet ditt, bookingsystemet eller resepsjonen også kan bruke den. Åpningsdager og -tider, lengden på en booking og de ansatte stilles inn under Avtaler → Bookingtider; datoer og tider er i kalenderens tidssone.
| Metode | Sti | Hva den gjør |
|---|---|---|
| GET | /api/v1/voice/appointments/availability?date=2030-01-07 | De ledige starttidene den dagen; staff for én persons |
| GET | /api/v1/voice/appointments?from=2030-01-07&days=7 | Avtalene fra den dagen (days opptil 31), med kalenderens settings |
| POST | /api/v1/voice/appointments | Book en avtale |
| GET | /api/v1/voice/appointments/{id} | Én avtale |
| PATCH | /api/v1/voice/appointments/{id} | Endre status, notes eller 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 og name er påkrevd; phone, email, service, staff og notes er valgfrie. En booking følger agentens regler: kalenderen må være åpen da, og noen må være ledig, enten personen det bes om i staff, eller uten det hvem som helst (uten ansatte tar virksomheten én booking om gangen). Et opptatt tidspunkt eller et utenfor åpningstiden svarer 409 med koden appointment_conflict. Et telefonnummer i internasjonalt format knytter bookingen til den kunden, eller legger kunden til blant kundene dine. Svaret er avtalen, med source api.
En avtale er booked, completed (møtt), no_show eller cancelled; en som venter på plass, er waitlisted. Marker besøket etterpå:
{ "status": "completed" }
Et fullført besøk teller med i kundens besøk. En avlysning frigjør tiden; er den mer enn 15 minutter frem i tid, blir den første på ventelisten for den tiden booket inn. En avtale på ventelisten kan bare avlyses. Systemene dine får vite om bookinger med en gang via webhook-hendelsene appointment.created og appointment.updated.