EvaSay hat einen eigenen Buchungskalender: Agents mit den Buchungsfunktionen prüfen darin während Anrufen und Chats freie Zeiten, buchen und stornieren, und Ihr Team sieht ihn auf der Seite Termine. Die API arbeitet mit demselben Kalender, sodass auch Ihre Website, Ihr Buchungssystem oder Ihr Empfang ihn nutzen können. Öffnungstage und -zeiten, die Dauer einer Buchung und das Personal legen Sie unter Termine → Buchungszeiten fest; Daten und Uhrzeiten gelten in der Zeitzone des Kalenders.
| Methode | Pfad | Was er tut |
|---|---|---|
| GET | /api/v1/voice/appointments/availability?date=2030-01-07 | Die freien Startzeiten an diesem Tag; staff für die einer Person |
| GET | /api/v1/voice/appointments?from=2030-01-07&days=7 | Die Termine ab diesem Tag (days bis 31), mit den settings des Kalenders |
| POST | /api/v1/voice/appointments | Einen Termin buchen |
| GET | /api/v1/voice/appointments/{id} | Ein Termin |
| PATCH | /api/v1/voice/appointments/{id} | status, notes oder service ändern |
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 und name sind erforderlich; phone, email, service, staff und notes sind optional. Eine Buchung folgt den Regeln des Agents: Der Kalender muss zu der Zeit geöffnet sein, und jemand muss frei sein, entweder die gewünschte Person aus staff oder, ohne Angabe, irgendwer (ohne Personal nimmt das Geschäft jeweils eine Buchung an). Eine belegte Zeit oder eine Zeit außerhalb der Öffnungszeiten antwortet mit 409 und dem Code appointment_conflict. Eine Telefonnummer im internationalen Format verknüpft die Buchung mit diesem Kunden oder legt ihn bei Ihren Kunden an. Die Antwort ist der Termin, mit source api.
Ein Termin ist booked, completed (besucht), no_show oder cancelled; einer, der auf einen Platz wartet, ist waitlisted. Markieren Sie den Besuch danach:
{ "status": "completed" }
Ein abgeschlossener Besuch zählt zu den Besuchen des Kunden. Eine Stornierung gibt die Zeit frei; liegt sie mehr als 15 Minuten in der Zukunft, wird die erste Person auf der Warteliste für diese Zeit eingebucht. Ein Termin auf der Warteliste kann nur storniert werden. Ihre Systeme erfahren von Buchungen sofort über die Webhook-Ereignisse appointment.created und appointment.updated.