EvaSay에는 자체 예약 캘린더가 있습니다. 예약 기능이 있는 에이전트는 통화와 채팅 중에 이 캘린더에서 빈 시간을 확인하고 예약하거나 취소하며, 팀은 예약 페이지에서 확인합니다. API도 같은 캘린더를 사용하므로 웹사이트, 예약 시스템, 프런트 데스크에서도 쓸 수 있습니다. 영업일과 영업시간, 예약 1건의 길이, 직원은 예약 → 예약 시간에서 설정하며, 날짜와 시간은 캘린더의 시간대 기준입니다.
| 메서드 | 경로 | 하는 일 |
|---|---|---|
| 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} | 예약 1건 |
| 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로 지정한 사람이나 지정이 없으면 누구든 비어 있어야 합니다(직원이 없으면 한 번에 예약 1건만 받습니다). 이미 찬 시간이나 영업시간 밖이면 409와 코드 appointment_conflict를 반환합니다. 국제 형식의 전화번호를 보내면 예약이 그 고객에게 연결되고, 없으면 고객으로 추가됩니다. 응답은 예약이며 source는 api입니다.
예약 상태는 booked, completed(방문함), no_show, cancelled 중 하나이고, 자리를 기다리는 예약은 waitlisted입니다. 방문 후 표시합니다:
{ "status": "completed" }
완료된 방문은 고객의 방문 횟수에 더해집니다. 예약을 취소하면 그 시간이 비고, 시작까지 15분 넘게 남았으면 그 시간 대기 명단의 첫 번째 사람이 예약됩니다. 대기 중인 예약은 취소만 할 수 있습니다. 예약이 생기거나 바뀌면 appointment.created와 appointment.updated 웹훅 이벤트로 바로 받을 수 있습니다.