更新日誌

​

Webhook payload 直接帶對話逐字稿

• session.ended 與 session.finalized payload 新增 messages —— 以 { role, content, timestamp? } 呈現的對話逐字稿（僅 user/assistant 輪次）。Receiver 不用再回打 session API 撈逐字稿。
• messagesCount 改為 messages 的長度。若你原本把它當含 tool 訊息的總數使用，數字會變小。
• session.finalized 補上 recordingUrl 欄位文件，並更新說明：call session 的錄音處理會 gate finalization —— 收到 session.finalized 時錄音結果已確定，成功的錄音 URL 就在 payload 裡。
• Webhook 設定 UI 將四種事件合併為單一清單。
• 詳見更新後的 payload reference。

​

舊版 API 路徑遷移至 /v1 —— 2026-07-11 下架

• 對話補全、會話、Webhook 訂閱與外撥電話現在都有 /v1 路徑。新路徑即日起上線，使用相同的 Developer Key 認證。
• /project/:projectId/integration/* 與 /project/:projectId/webhooks/* 底下的舊路徑已棄用，將於 2026-07-11 停止運作。在此之前仍可使用，回應會帶 Deprecation / Sunset 標頭。
• 只有路徑改變 —— 請求與回應主體不變。完整的新舊路徑對照見遷移指南。

​

Post Webhook 多事件支援

• Post-session webhook 新增四種事件 —— session.ended、call.ended、session.finalized、recording.ready —— 可在 agent 設定中複選。
• session.finalized 在所有預期步驟（對話結束 + 通話結束，依 session 而定）都到齊時觸發，payload 已合併前面事件的資料，receiver 只需處理一個 callback。
• recording.ready（call session 限定）在通話錄音處理完成時觸發，成功時帶短期有效的下載連結。它與 session.finalized 獨立，可能在它之前或之後到。 （已過時 —— 錄音處理現在會 gate session.finalized，見上方 2026 年 7 月更新。）
• Webhook 設定 UI 新增多選介面，每個事件附上觸發時機與 payload 欄位的 tooltip 說明。
• 新增 Post Webhooks API reference，涵蓋設定方式、payload schema、投遞語意，以及完整的 receiver 範例。

​

舊版 API 金鑰標記為 Deprecated — 2026-05-10 下架

• 舊版專案層級 API 金鑰（sk_ 與 buzz_live_ 前綴）以及 x-api-key header 標記為 deprecated，2026-05-10 起停止接受。
• 舊的 /knowledgebases/* 路徑同步 deprecated，請改用 /v1/projects/:projectId/knowledgebases/*。
• 所有外部整合請改以 Developer Key（dk_ 前綴）透過 Authorization: Bearer dk_... 認證。可在帳號選單的 Developer Keys 建立。
• 詳細遷移步驟請參考 Legacy API Key 遷移指引。

​

Number Pool 統一管理

• 上線 Number Pool 統一管理能力，支援 inbound/outbound 共用號碼營運。
• 擴展自動化串接範圍，讓電話流程可在更多工作流中協同運作。

​

後台用量與成本介面

• 重構管理後台與用量檢視介面，提升成本與額度追蹤可讀性。

​

Inbound 穩定性修復

• 修正匿名來電識別映射，並強化 inbound 設定刪除流程的穩定性。

​

會話生命週期控制

• 新增 Session 終止 API 與自動終止控制，強化語音會話可控性。
• 新增 Agent Memory，提升跨多次互動的上下文延續能力。

​

外呼流程擴充

• 擴充 App 內外呼流程，並優化結束通話訊息設定體驗。

​

通話流程穩定性修復

• 修正重複轉接觸發、來電過早結束與逾時失敗等關鍵問題。

​

權限治理與可控性

• 上線三層 RBAC（Admin / Manager / Viewer）。
• 將 call logs 深度整合進 session history，並補強 post-session 資料抽取能力。

​

Session 與語音介面重構

• 重構 session history、語音設定與 agent editor 介面，提升營運可視化。

​

通話狀態一致性修復

• 修正掛斷邊界情境，並提升通話狀態一致性與會話收尾可靠性。

​

App 內外呼上線

• 上線 App 內外呼能力，並支援事件驅動的連續外呼流程。
• 升級 call logs 與 session history，補強錄音播放與協作檢視體驗。

​

整合設定與變數 UI 優化

• 重構整合設定與變數管理相關 UI，提升客服操作效率。

​

錄音與歷史紀錄修復

• 修正錄音時序、重複外呼號碼處理與 session history 載入穩定性。

​

即時電話 Agent 上線

• 上線即時電話 Agent 介面，支援 live 通話營運。
• 重構執行模式與 before-start 初始化流程，提升通話流程可預期性。

​

Pathway Editor 重構

• 優化 pathway editor 與導覽介面，包含分頁化流程與可收合側欄。

​

預覽與連線修復

• 修正重複語音連線、session ID 邊界情境與預覽通話穩定性問題。

​

語音與 SIP 能力擴充

• 擴充語音設定覆蓋範圍，提升多語系電話情境處理品質。
• 強化 SIP trunking 與 session 控制，補強重試、驗證與路由行為。

​

營運檢視體驗優化

• 優化 session history 與通話預覽介面，提升營運檢視效率。

​

Session 穩定性修復

• 修正 session 序列化錯誤、空知識庫故障與 SIP 逾時中斷問題。

​

電話核心能力建置

• 完成 End Call、End Session、Transfer 等電話 Agent 核心能力建置。
• 上線 call log 與錄音能力，提升 QA 與客服追蹤效率。

​

核心操作介面重構

• 重構核心操作頁與共用 UI 元件，提升日常營運可用性。

​

核心穩定性修復

• 修正重複建立 session、首句延遲與預覽/轉錄互動等關鍵問題。