У 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.