電話系統接入操作手冊

透過將 Audio Agent 與電話系統整合，讓您的語音 Agent 直接接聽電話。使用者撥打電話即可與 Agent 進行語音對話。
本期支援範圍：

• Twilio 服務商 · 呼入（使用者打進來）· 號碼呼入，適合「客戶直接撥打一個電話號碼，就能與 Agent 通話」的場景。
• 第三方 SIP 轉接呼入，適合已有呼叫中心或外撥系統，接通客戶後將通話轉接給 Agent 的場景。

一、開始之前（前置準備）

1. 一個已開啟語音能力的 Agent
   Agent 需已設定語音模型、音色與開場白（於 Agent 的語音設定中完成）。電話接通後播放的正是這裡設定的開場白。
2. 一個 Twilio 帳號
   • 若走「公網號碼呼入」：需要您自己的 Twilio 帳號，並已購買一個電話號碼。
   • 若走「第三方 SIP 轉接」：使用 GPTBots 平台提供的共享 SIP 端點，無需自備號碼。
3. 進入路徑：開發空間 → 您的 Agent → 整合 → 電話系統。

二、綁定公網電話號碼（最常用）

適合「客戶直接撥打一個電話號碼，就能與 Agent 通話」的場景。

步驟

1. 服務提供商：選擇 Twilio · Elastic SIP Trunk。

2. 填寫 Twilio 帳號資訊：

   欄位	填寫內容	說明
   Account SID	ACxxxxxxxx…	Twilio 控制台首頁可見
   Auth Token	您的 Twilio Auth Token	用於校驗來電請求簽章（X-Twilio-Signature），防止偽造呼入
   Elastic SIP Trunk 網域	your-trunk.pstn.twilio.com	您的 Trunk 網域
   接入區域	就近選擇（US1 / IE1 / DE1 / AU1 / JP1 / SG1）	影響通話延遲
   綁定電話號碼	+1 415 555 0188	您在 Twilio 購買的號碼，含國家碼
   呼叫方向	僅呼入	本期僅支援呼入

3. 點擊 儲存。儲存成功後，「Webhook」區域會自動產生一條 媒體 / 回呼 URL。

4. 將這條 URL 回填至 Twilio：
   複製「媒體 / 回呼 URL」→ 開啟 Twilio 控制台該號碼的設定 → 找到 A CALL COMES IN（當有來電時） → 方式選 Webhook、貼上該 URL、方法用 HTTP POST → 儲存。

5. 完成。用手機撥打該號碼，應能聽到 Agent 的開場白並開始對話。

三、第三方 SIP 系統轉接呼入（呼叫中心 / PBX）

適合「已有呼叫中心或外撥系統，接通客戶後將通話轉接給 Agent」的場景。此時 GPTBots 本身作為一個 SIP 端點，純 SIP 互聯、無需電話號碼。

該區域僅當服務商為 Twilio、且平台已開通共享 SIP Domain 時顯示。

您會看到的資訊

1. Agent SIP 位址（SIP URI）· 唯一語音入口
   您的第三方系統在接通客戶後，將通話透過 SIP REFER 轉接至此位址，即按「呼入」接入同一個 Agent。
2. SIP 使用者名稱 / SIP 密碼（儲存設定後自動產生）
   您的 PBX / 軟體電話用這組使用者名稱和密碼在 SIP Domain 上鑑權。

   ⚠️ 密碼僅在產生 / 重新產生時顯示一次，平台不保存。請立即複製妥善保管；遺忘只能點「重新產生」換一組新的。

3. 支援能力：SIP REFER / 轉接、自訂標頭（X-headers）傳參、TLS / SRTP。

使用指南

在您的 SIP 系統裡，用上面的 SIP 使用者名稱 + 密碼 向 Agent SIP 位址 發起 / 轉接呼叫即可。若同時也綁定了公網號碼，二者接入的是同一個 Agent，無需重複設定。

四、進階：傳入終端使用者身分，做個人化

預設情況下 Agent 按來電號碼識別來電者。如果您的系統已有自己的使用者體系，可以在 SIP 呼叫時透過自訂標頭（X-headers） 攜帶使用者識別碼：

• 標頭名稱：X-User-Id
• 作用：Agent 會據此關聯該使用者的屬性與歷史對話，實現個人化應答（例如按會員等級、歷史訂單回答）。

未傳 X-User-Id 時，Agent 以主叫號碼作為來訪識別碼，仍可正常對話，只是不做基於使用者檔案的個人化。

五、撥打測試與查看記錄

1. 撥打綁定號碼（或從第三方系統轉接），確認：
   • 能聽到開場白；
   • 能正常多輪對話；
   • 說話可以打斷 Agent 正在播報的內容。
2. 在 日誌 / 對話記錄 頁可查看該通電話：
   • 對話來源標記為 Twilio，並顯示來電號碼；
   • 完整的多輪問答記錄；
   • 執行時序（logtree）：開始節點 → 各輪對話 / 工具呼叫 → 結束語音。

六、常見問題（FAQ）

Q1. 撥打號碼沒反應 / 直接掛斷？

• 檢查「媒體 / 回呼 URL」是否已正確回填至 Twilio 號碼的 A CALL COMES IN，方法為 HTTP POST。
• 檢查 Auth Token 是否填對——填錯會導致來電驗簽失敗被拒接。
• 確認 Agent 的語音能力已設定完整（模型 / 音色 / 開場白）。

Q2. 提示憑證不足 / 無法接通？

• 確認帳戶點數充足：點數耗盡會拒接來電。
• 確認未超並發通話上限：超限的新來電會被拒接。

Q3. SIP 密碼忘了怎麼辦？

• 點「重新產生」取得新密碼（舊密碼即時失效），並同步更新至您的 SIP 系統。密碼只顯示一次，請及時保存。

Q4. 單通電話最長多久？

• 單通通話最長 60 分鐘，超過將自動結束。

Q5. 能讓 Agent 主動打電話出去嗎？

• 本期僅支援呼入（使用者打進來），暫不支援外撥。

七、注意事項

• 本期僅支援 Twilio 服務商與 呼入 方向。
• 通話計費與一般語音 Agent 一致，按用量扣減點數。
• 修改整合設定（號碼、憑證等）後需重新儲存生效。