EvaSay ma własny kalendarz rezerwacji: agenci z funkcjami rezerwacji sprawdzają w nim wolne terminy, rezerwują i odwołują wizyty podczas rozmów i czatów, a Twój zespół widzi go na stronie Wizyty. API działa na tym samym kalendarzu, więc może z niego korzystać także Twoja strona, system rezerwacji lub recepcja. Dni i godziny otwarcia, długość wizyty i personel ustawiasz w Wizyty → Godziny rezerwacji; daty i godziny są w strefie czasowej kalendarza.
| Metoda | Ścieżka | Co robi |
|---|---|---|
| GET | /api/v1/voice/appointments/availability?date=2030-01-07 | Wolne godziny rozpoczęcia tego dnia; staff dla jednej osoby |
| GET | /api/v1/voice/appointments?from=2030-01-07&days=7 | Wizyty od tego dnia (days do 31) wraz z settings kalendarza |
| POST | /api/v1/voice/appointments | Zarezerwuj wizytę |
| GET | /api/v1/voice/appointments/{id} | Jedna wizyta |
| PATCH | /api/v1/voice/appointments/{id} | Zmień jej status, notes lub 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 i name są wymagane; phone, email, service, staff i notes są opcjonalne. Rezerwacja podlega tym samym zasadom co u agenta: kalendarz musi być wtedy otwarty i ktoś musi być wolny, osoba wskazana w staff albo, bez wskazania, ktokolwiek (bez personelu firma przyjmuje jedną wizytę naraz). Zajęty termin lub termin poza godzinami otwarcia zwraca 409 z kodem appointment_conflict. Numer telefonu w formacie międzynarodowym wiąże wizytę z tym klientem albo dodaje go do Twoich klientów. Odpowiedzią jest wizyta z source równym api.
Wizyta ma stan booked, completed (odbyła się), no_show lub cancelled; ta, która czeka na miejsce, ma stan waitlisted. Oznacz wizytę po fakcie:
{ "status": "completed" }
Odbyta wizyta liczy się do wizyt klienta. Odwołanie zwalnia termin; jeśli do niego zostało więcej niż 15 minut, pierwsza osoba z listy oczekujących na ten termin zostaje zapisana. Wizytę z listy oczekujących można tylko odwołać. Twoje systemy od razu dowiadują się o rezerwacjach dzięki zdarzeniom webhook appointment.created i appointment.updated.