EvaSay має власний календар записів: агенти з функціями запису перевіряють у ньому вільний час, записують і скасовують записи під час дзвінків і чатів, а ваша команда бачить його на сторінці Записи. 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 — за бажанням. Запис підлягає тим самим правилам, що й в агента: календар має бути відкритий у цей час, і хтось має бути вільний — працівник із staff або, якщо його не вказано, будь-хто (без працівників бізнес приймає один запис за раз). Зайнятий час або час поза робочими годинами повертає 409 з кодом appointment_conflict. Телефон у міжнародному форматі пов’язує запис із цим клієнтом або додає його до ваших клієнтів. У відповіді — запис із source, що дорівнює api.
Запис буває booked, completed (клієнт прийшов), no_show або cancelled; запис, що чекає на місце, — waitlisted. Після візиту позначте його:
{ "status": "completed" }
Візит, що відбувся, зараховується клієнту. Скасування звільняє час; якщо до нього понад 15 хвилин, перший у листі очікування на цей час отримує місце. Запис із листа очікування можна лише скасувати. Ваші системи одразу дізнаються про записи через події вебхуків appointment.created і appointment.updated.