符合資格的條件
GET /agents 只傳回組織擁有、且目前符合對外 AI 撥號資格的代理。符合資格表示代理已啟用、已設定供對外撥號使用、可開始處理通話,並與組織內已驗證且可用的對外撥號路由關聯。
此端點接受 calls:read 或 batches:read 任一權限,權限模式為 anyOf。單次通話整合通常使用 calls:read;僅使用批次撥號的整合則可用 batches:read 讀取同一份符合資格的代理目錄。
若清單中沒有某個代理,就不可使用該代理建立通話或批次。請重新列出目錄,不要無限期快取可用性。
唯讀目錄
REST API 僅提供精簡的選取資料:id、name、description、language 與 availability。傳回項目的 availability 為 available。本 API 無法建立或修改代理定義。
選取代理
將傳回的id 作為 POST /calls 或 POST /batches 的 agent_id。請選擇語言與設定行為都適合收話人的代理。自動化會使用自身設定的代理,因此 POST /automation-runs 不接受 agent_id。