EvaSay には独自の予約カレンダーがあります。予約機能を持つ Agent は通話やチャット中にここで空き時間を確認し、予約やキャンセルを行い、チームは 予約 ページで確認します。API も同じカレンダーを使うため、Web サイト、予約システム、受付からも利用できます。営業日と営業時間、1 件の予約の長さ、スタッフは 予約 → 予約時間 で設定します。日付と時刻はカレンダーのタイムゾーンです。
| メソッド | パス | 内容 |
|---|---|---|
| GET | /api/v1/voice/appointments/availability?date=2030-01-07 | その日の空いている開始時刻。staff で 1 人分に絞り込み |
| 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 は任意です。予約は Agent と同じルールに従います。その時間にカレンダーが開いていて、staff で指定した人、指定がなければ誰かが空いている必要があります(スタッフがいない場合、同時に受ける予約は 1 件です)。埋まっている時間や営業時間外は 409、コード appointment_conflict を返します。国際形式の電話番号を渡すと、予約はその顧客に紐づき、いなければ顧客に追加されます。レスポンスは予約で、source は api です。
予約の状態は booked、completed(来店済み)、no_show、cancelled のいずれかで、空きを待つ予約は waitlisted です。来店後に記録します:
{ "status": "completed" }
来店済みの予約は顧客の来店回数に加算されます。キャンセルするとその時間が空き、開始まで 15 分以上あれば、その時間のキャンセル待ちの先頭の人が予約されます。キャンセル待ちの予約はキャンセルのみできます。予約が入ったり変わったりしたことは、appointment.created と appointment.updated の Webhook イベント ですぐに受け取れます。