EvaSay har en egen bokningskalender: agenter med bokningsfunktionerna kollar lediga tider, bokar och avbokar i den under samtal och chattar, och ditt team ser den på sidan Bokningar. API:t arbetar mot samma kalender, så att din webbplats, ditt bokningssystem eller din reception också kan använda den. Öppetdagar och -tider, en boknings längd och personalen ställs in under Bokningar → Bokningstider; datum och tider är i kalenderns tidszon.
| Metod | Sökväg | Vad den gör |
|---|---|---|
| GET | /api/v1/voice/appointments/availability?date=2030-01-07 | De lediga starttiderna den dagen; staff för en persons |
| GET | /api/v1/voice/appointments?from=2030-01-07&days=7 | Bokningarna från den dagen (days upp till 31), med kalenderns settings |
| POST | /api/v1/voice/appointments | Boka en tid |
| GET | /api/v1/voice/appointments/{id} | En bokning |
| PATCH | /api/v1/voice/appointments/{id} | Ändra dess status, notes eller 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 och name krävs; phone, email, service, staff och notes är valfria. En bokning följer agentens regler: kalendern måste vara öppen då och någon måste vara ledig, antingen den person som efterfrågas i staff eller, utan den, vem som helst (utan personal tar verksamheten en bokning i taget). En upptagen tid eller en tid utanför öppettiderna svarar 409 med koden appointment_conflict. Ett telefonnummer i internationellt format kopplar bokningen till den kunden, eller lägger till kunden bland dina kunder. Svaret är bokningen, med source api.
En bokning är booked, completed (besökt), no_show eller cancelled; en som väntar på plats är waitlisted. Markera besöket efteråt:
{ "status": "completed" }
Ett genomfört besök räknas till kundens besök. En avbokning frigör tiden; ligger den mer än 15 minuter fram i tiden bokas den första på väntelistan för den tiden in. En bokning på väntelistan kan bara avbokas. Dina system får veta om bokningar direkt via webhook-händelserna appointment.created och appointment.updated.