EvaSay ha un proprio calendario di prenotazione: gli agenti con le funzioni di prenotazione vi controllano gli orari liberi, prenotano e annullano durante chiamate e chat, e il tuo team lo vede nella pagina Appuntamenti. L'API lavora sullo stesso calendario, così anche il tuo sito, il tuo sistema di prenotazione o la tua reception possono usarlo. Giorni e orari di apertura, durata di una prenotazione e personale si impostano in Appuntamenti → Orari di prenotazione; date e orari sono nel fuso orario del calendario.
| Metodo | Percorso | Cosa fa |
|---|---|---|
| GET | /api/v1/voice/appointments/availability?date=2030-01-07 | Gli orari di inizio liberi quel giorno; staff per quelli di una persona |
| GET | /api/v1/voice/appointments?from=2030-01-07&days=7 | Gli appuntamenti da quel giorno in poi (days fino a 31), con i settings del calendario |
| POST | /api/v1/voice/appointments | Prenota un appuntamento |
| GET | /api/v1/voice/appointments/{id} | Un appuntamento |
| PATCH | /api/v1/voice/appointments/{id} | Modifica il suo status, le notes o il 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 e name sono obbligatori; phone, email, service, staff e notes sono facoltativi. Una prenotazione segue le regole dell'agente: il calendario deve essere aperto a quell'ora e qualcuno deve essere libero, la persona richiesta in staff oppure, senza indicazione, chiunque (senza personale, l'attività accetta una prenotazione alla volta). Un orario occupato o fuori dall'orario di apertura risponde 409 con il codice appointment_conflict. Un numero di telefono in formato internazionale collega la prenotazione a quel cliente, o lo aggiunge ai tuoi clienti. La risposta è l'appuntamento, con source api.
Un appuntamento è booked, completed (visitato), no_show o cancelled; quello in attesa di un posto è waitlisted. Segna la visita dopo:
{ "status": "completed" }
Una visita completata conta nelle visite del cliente. Annullare un appuntamento libera il suo orario; se mancano più di 15 minuti, la prima persona in lista d'attesa per quell'orario viene prenotata. Un appuntamento in lista d'attesa può solo essere annullato. I tuoi sistemi sanno delle prenotazioni appena avvengono tramite gli eventi webhook appointment.created e appointment.updated.