コンテンツにスキップ

讓外部 AI 助理幫顧客預約

このコンテンツはまだ日本語訳がありません。

開通「外部 AI 助理預約」後,CL Booking 以外的 AI 助理(例如你自己架的客服機器人、合作夥伴的 AI 系統)可以直接查你店裡的服務與空檔,替顧客預約、改期、取消。

位置:這個功能沒有在店家後台設定,由我們替你開通。有沒有開通,可以在側欄 › 帳號 › 方案 的「外部 AI 助理預約」看到(店家擁有者、員工都看得到)。

一般情況下,顧客透過 LINE 對話或預約網頁預約。開通這個功能後,外部的 AI 助理也能用 CL Booking 提供的介面,直接操作你店裡的預約。

  • 外部 AI 助理和 LINE 上的 AI 用同一套預約規則:營業時間、服務人員、時段是否被佔用都照你的後台設定。
  • 外部 AI 助理只能碰你這一家店,而且只能代表拿到授權碼的那位顧客操作,看不到其他顧客的預約。
  • 它不經過 AI 對話開關:就算你關掉 AI 對話,外部 AI 助理照樣可以預約,也不算在 AI 對話的每月用量裡。
  1. 透過聯絡我們申請,說明要開通「外部 AI 助理預約」,以及要接的是哪一個 AI 助理。
  2. 一併告訴我們要不要限制:
    • 只開放部分服務給外部 AI 助理預約(預設全部服務)。
    • 只開放查詢、取消,不開放新增預約。
  3. 我們開通後,會提供店家 API 金鑰給你(或你指定的開發者)。金鑰只會顯示一次,請直接交給串接的人保管,不要貼在群組或文件裡。
  4. 開發者把金鑰設定到 AI 助理裡(見下方「給開發者」)。

外部 AI 助理要代表某位顧客預約時,需要這位顧客的顧客授權碼。授權碼由我們簽發,綁定「你的店+這位顧客」,預設 30 天有效,可以隨時撤銷。

  1. 顧客在 AI 助理裡說想預約,例如「幫我約下週二下午剪髮」。
  2. AI 助理查你店裡的服務與空檔,列出可以選的時段。
  3. 顧客選好時段,AI 助理先保留時段(預設保留 10 分鐘),再向顧客唸一次內容確認。
  4. 顧客確認後完成預約。預約會出現在你的行事曆,來源標示「外部 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 要先列入白名單,否則回 403 ORIGIN_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 助理預約了,怎麼關?”

透過聯絡我們申請停用。也可以只關「新增預約」,保留顧客查詢、取消已經約好的預約。