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": "剪发" }'
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 事件 收到通知。