EvaSay har sin egen bookingkalender: agenter med bookingfunktionerne tjekker ledige tider, booker og aflyser i den under opkald og chats, og dit team ser den på siden Aftaler. API’et arbejder på den samme kalender, så dit websted, dit bookingsystem eller din reception også kan bruge den. Åbningsdage og -tider, en bookings længde og personalet indstilles under Aftaler → Bookingtider; datoer og tider er i kalenderens tidszone.
| Metode | Sti | Hvad den gør |
|---|---|---|
| GET | /api/v1/voice/appointments/availability?date=2030-01-07 | De ledige starttider den dag; staff for én persons |
| GET | /api/v1/voice/appointments?from=2030-01-07&days=7 | Aftalerne fra den dag (days op til 31), med kalenderens settings |
| POST | /api/v1/voice/appointments | Book en aftale |
| GET | /api/v1/voice/appointments/{id} | Én aftale |
| PATCH | /api/v1/voice/appointments/{id} | Ændr dens 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 og name er påkrævede; phone, email, service, staff og notes er valgfrie. En booking følger agentens regler: kalenderen skal være åben på det tidspunkt, og nogen skal være ledig, enten den person, der bedes om i staff, eller uden den hvem som helst (uden personale tager virksomheden én booking ad gangen). Et optaget tidspunkt eller et uden for åbningstiden svarer 409 med koden appointment_conflict. Et telefonnummer i internationalt format knytter bookingen til den kunde eller tilføjer kunden til dine kunder. Svaret er aftalen, med source api.
En aftale er booked, completed (fremmødt), no_show eller cancelled; en, der venter på en plads, er waitlisted. Markér besøget bagefter:
{ "status": "completed" }
Et gennemført besøg tæller med i kundens besøg. En aflysning frigør tiden; er den mere end 15 minutter ude i fremtiden, bliver den første på ventelisten til den tid booket ind. En aftale på ventelisten kan kun aflyses. Dine systemer hører om bookinger, når de sker, via webhook-hændelserne appointment.created og appointment.updated.