EvaSay a son propre agenda de réservation : les agents dotés des fonctions de réservation y consultent les créneaux libres, réservent et annulent pendant les appels et les chats, et votre équipe le voit sur la page Rendez-vous. L'API travaille sur le même agenda, pour que votre site, votre système de réservation ou votre accueil puissent l'utiliser aussi. Les jours et heures d'ouverture, la durée d'un rendez-vous et le personnel se règlent dans Rendez-vous → Horaires de réservation ; dates et heures sont dans le fuseau horaire de l'agenda.
| Méthode | Chemin | Ce qu'il fait |
|---|---|---|
| GET | /api/v1/voice/appointments/availability?date=2030-01-07 | Les heures de début libres ce jour-là ; staff pour celles d'une personne |
| GET | /api/v1/voice/appointments?from=2030-01-07&days=7 | Les rendez-vous à partir de ce jour (days jusqu'à 31), avec les settings de l'agenda |
| POST | /api/v1/voice/appointments | Réserver un rendez-vous |
| GET | /api/v1/voice/appointments/{id} | Un rendez-vous |
| PATCH | /api/v1/voice/appointments/{id} | Modifier son status, ses notes ou son 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 et name sont obligatoires ; phone, email, service, staff et notes sont facultatifs. Une réservation suit les règles de l'agent : l'agenda doit être ouvert à cette heure et quelqu'un doit être libre, soit la personne demandée dans staff, soit, sans précision, n'importe qui (sans personnel, l'établissement prend un rendez-vous à la fois). Un créneau pris, ou hors des heures d'ouverture, répond 409 avec le code appointment_conflict. Un numéro de téléphone au format international rattache le rendez-vous à ce client, ou l'ajoute à vos clients. La réponse est le rendez-vous, avec source api.
Un rendez-vous est booked, completed (venu), no_show ou cancelled ; celui qui attend une place est waitlisted. Indiquez la visite ensuite :
{ "status": "completed" }
Une visite terminée compte dans les visites du client. Annuler un rendez-vous libère son créneau ; s'il est dans plus de 15 minutes, la première personne de la liste d'attente pour cette heure y est inscrite. Un rendez-vous en liste d'attente ne peut qu'être annulé. Vos systèmes sont prévenus des réservations au moment où elles arrivent par les événements webhook appointment.created et appointment.updated.