讓外部 AI 助理幫顧客預約
開通「外部 AI 助理預約」後,CL Booking 以外的 AI 助理(例如你自己架的客服機器人、合作夥伴的 AI 系統)可以直接查你店裡的服務與空檔,替顧客預約、改期、取消。
位置:這個功能沒有在店家後台設定,由我們替你開通。有沒有開通,可以在側欄 › 帳號 › 方案 的「外部 AI 助理預約」看到(店家擁有者、員工都看得到)。
一般情況下,顧客透過 LINE 對話或預約網頁預約。開通這個功能後,外部的 AI 助理也能用 CL Booking 提供的介面,直接操作你店裡的預約。
- 外部 AI 助理和 LINE 上的 AI 用同一套預約規則:營業時間、服務人員、時段是否被佔用都照你的後台設定。
- 外部 AI 助理只能碰你這一家店,而且只能代表拿到授權碼的那位顧客操作,看不到其他顧客的預約。
- 它不經過 AI 對話開關:就算你關掉 AI 對話,外部 AI 助理照樣可以預約,也不算在 AI 對話的每月用量裡。
- 透過聯絡我們申請,說明要開通「外部 AI 助理預約」,以及要接的是哪一個 AI 助理。
- 一併告訴我們要不要限制:
- 只開放部分服務給外部 AI 助理預約(預設全部服務)。
- 只開放查詢、取消,不開放新增預約。
- 我們開通後,會提供店家 API 金鑰給你(或你指定的開發者)。金鑰只會顯示一次,請直接交給串接的人保管,不要貼在群組或文件裡。
- 開發者把金鑰設定到 AI 助理裡(見下方「給開發者」)。
外部 AI 助理要代表某位顧客預約時,需要這位顧客的顧客授權碼。授權碼由我們簽發,綁定「你的店+這位顧客」,預設 30 天有效,可以隨時撤銷。
- 顧客在 AI 助理裡說想預約,例如「幫我約下週二下午剪髮」。
- AI 助理查你店裡的服務與空檔,列出可以選的時段。
- 顧客選好時段,AI 助理先保留時段(預設保留 10 分鐘),再向顧客唸一次內容確認。
- 顧客確認後完成預約。預約會出現在你的行事曆,來源標示「外部 AI 預約」。
查服務、查空檔不需要授權碼;保留時段、預約、改期、取消、查詢自己的預約都需要。
外部 AI 助理完成的預約,會顯示在側欄 › 帳號 › 每月用量 的「外部 AI 助理完成的預約」一欄。
外部 AI 助理透過 MCP(Model Context Protocol,讓 AI 模型呼叫外部工具的標準)或 REST API 連線。
- MCP 端點:
POST /mcp(Streamable HTTP、無狀態,回 JSON)。完整網址由我們在開通時提供。 - REST:
/v1/services、/v1/slots、/v1/holds、/v1/holds/:id/extend、/v1/bookings等。 - 每次請求帶兩個標頭:
Authorization: Bearer <店家 API 金鑰>:決定是哪一家店。X-Customer-Grant: <顧客授權碼>:代表哪一位顧客。查服務、查空檔可以不帶。
- MCP 工具:
list_services、find_slots、hold_slot、extend_hold(延長保留時段)、create_booking、reschedule_booking、cancel_booking、get_booking。 - 速率限制:每把金鑰預設每分鐘 60 次,超過回 429 並帶
Retry-After。 - 瀏覽器來源:從瀏覽器呼叫
/mcp時,Origin要先列入白名單,否則回 403ORIGIN_NOT_ALLOWED;伺服器對伺服器呼叫不受影響。 - 不能指定顧客:顧客由授權碼決定,在參數裡帶別人的顧客 ID 會被拒絕。
最小的 MCP 連線範例(TypeScript,官方 SDK):
import { Client } from "@modelcontextprotocol/sdk/client/index.js";import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
const client = new Client({ name: "my-agent", version: "1.0.0" });await client.connect( new StreamableHTTPClientTransport(new URL("https://<我們提供的網址>/mcp"), { requestInit: { headers: { authorization: `Bearer ${STORE_API_KEY}`, "x-customer-grant": CUSTOMER_GRANT } }, }),);const services = await client.callTool({ name: "list_services", arguments: {} });建議流程:list_services → find_slots → hold_slot → 向顧客唸回確認 → create_booking。沒有拿到成功回應前,不要告訴顧客已經預約好。
我不想讓外部 AI 助理預約了,怎麼關?
Section titled “我不想讓外部 AI 助理預約了,怎麼關?”透過聯絡我們申請停用。也可以只關「新增預約」,保留顧客查詢、取消已經約好的預約。