Το EvaSay έχει δικό του ημερολόγιο κρατήσεων: οι agents με τις λειτουργίες κρατήσεων βλέπουν σε αυτό τις ελεύθερες ώρες, κλείνουν και ακυρώνουν ραντεβού κατά τις κλήσεις και τις συνομιλίες, και η ομάδα σας το βλέπει στη σελίδα Ραντεβού. Το API δουλεύει στο ίδιο ημερολόγιο, ώστε να μπορούν να το χρησιμοποιούν και ο ιστότοπός σας, το σύστημα κρατήσεών σας ή η υποδοχή. Οι ημέρες και ώρες λειτουργίας, η διάρκεια μιας κράτησης και το προσωπικό ορίζονται στο Ραντεβού → Ώρες κρατήσεων· ημερομηνίες και ώρες είναι στη ζώνη ώρας του ημερολογίου.
| Μέθοδος | Διαδρομή | Τι κάνει |
|---|---|---|
| GET | /api/v1/voice/appointments/availability?date=2030-01-07 | Οι ελεύθερες ώρες έναρξης εκείνη την ημέρα· staff για ενός ατόμου |
| GET | /api/v1/voice/appointments?from=2030-01-07&days=7 | Τα ραντεβού από εκείνη την ημέρα (days έως 31), με τα settings του ημερολογίου |
| POST | /api/v1/voice/appointments | Κλείστε ραντεβού |
| GET | /api/v1/voice/appointments/{id} | Ένα ραντεβού |
| PATCH | /api/v1/voice/appointments/{id} | Αλλάξτε το status, τις notes ή την 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 και name είναι υποχρεωτικά· τα phone, email, service, staff και notes προαιρετικά. Μια κράτηση ακολουθεί τους κανόνες του agent: το ημερολόγιο πρέπει να είναι ανοιχτό εκείνη την ώρα και κάποιος να είναι ελεύθερος, το άτομο που ζητήθηκε στο staff ή, χωρίς αυτό, οποιοσδήποτε (χωρίς προσωπικό η επιχείρηση δέχεται ένα ραντεβού τη φορά). Μια κατειλημμένη ώρα ή ώρα εκτός λειτουργίας απαντά 409 με τον κωδικό appointment_conflict. Ένα τηλέφωνο σε διεθνή μορφή συνδέει την κράτηση με αυτόν τον πελάτη ή τον προσθέτει στους πελάτες σας. Η απάντηση είναι το ραντεβού, με source api.
Ένα ραντεβού είναι booked, completed (ήρθε), no_show ή cancelled· όποιο περιμένει θέση είναι waitlisted. Σημειώστε την επίσκεψη μετά:
{ "status": "completed" }
Μια ολοκληρωμένη επίσκεψη μετρά στις επισκέψεις του πελάτη. Η ακύρωση ελευθερώνει την ώρα· αν απέχει πάνω από 15 λεπτά, ο πρώτος στη λίστα αναμονής για εκείνη την ώρα παίρνει τη θέση. Ένα ραντεβού σε λίστα αναμονής μπορεί μόνο να ακυρωθεί. Τα συστήματά σας μαθαίνουν τις κρατήσεις τη στιγμή που γίνονται μέσω των συμβάντων webhook appointment.created και appointment.updated.