Skip to main content
POST
建立外撥電話
建立外撥電話請求。電話會進入佇列並由外撥排程器派送;此端點在請求被接受時即回傳,而非在電話接通時。 用於通話的 Agent 會自動從專案解析得出 — 沒有 Agent 選擇器。每個專案對應一個 Agent。

請求

標頭

Authorization
string
required
使用您的 Developer Key(dk_...)進行 Bearer 令牌認證。

請求主體

projectId
string
required
將擁有此通話的專案。已認證的使用者必須是此專案的成員。
fromNumber
string
required
來源電話號碼。必須在已認證使用者所屬的號碼池中處於 active 狀態,且必須已設定外撥中繼線(trunk)。
toNumber
string
required
目的地電話號碼,採用 E.164 格式(例如 +886912345678)。
dynamicVariables
object
選填的鍵值對應,會作為執行時變數注入 Agent 會話。這些值可從您的路徑與提示中引用。

範例

回應

當通話請求被接受進入派送佇列後,回傳 200 OK

錯誤

說明

  • Agent:Agent 會自動從 projectId 解析得出。該專案所設定的 Agent 會負責處理此通話。
  • 來源號碼的擁有權:呼叫者(Developer Key 使用者)必須是擁有 fromNumber 的號碼池成員。projectId 的專案成員資格則會分開檢查。
  • 變數dynamicVariables 會被字串化後寫入 LiveKit 房間的 metadata,並在整個會話期間提供給 Agent 使用。
  • 並行:同一個 toNumber 在同一時間內無法有超過一通進行中的外撥電話。請等待前一通通話完成後再重試。