EvaSay 有自己的預約日曆:帶預約功能的 Agent 在通話和聊天中在這裡查空閒時間、預約和取消,你的團隊在「預約」頁查看。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 可選。預約和 Agent 用同樣的規則:那個時間必須在營業時間內,而且要有人空著,指定了 staff 就看這位員工,沒指定就看任何人(沒設員工時,同一時間只接一個預約)。時間已被占用或不在營業時間內時回傳 409,錯誤碼 appointment_conflict。國際格式的電話號碼會把預約關聯到那個客戶,沒有的話會新增客戶。回傳的是這筆預約,source 是 api。
預約的狀態是 booked、completed(已到店)、no_show 或 cancelled;排隊候補的是 waitlisted。到店後標記:
{ "status": "completed" }
標記為已到店的預約會計入客戶的到店次數。取消預約會空出那個時間;如果離開始還有 15 分鐘以上,排在這個時間候補的第一個人會自動約上。候補中的預約只能取消。預約發生時,你的系統可以透過 appointment.created 和 appointment.updated 這兩個 Webhook 事件 收到通知。