ThunderPhone v3 現已上線。自助開通,每分鐘 2¢ 起。查看公告

Contact centers

從 Genesys Cloud 連線

透過 BYOC Cloud 中繼將 Genesys Cloud 通話連接至 ThunderPhone 智慧體,並傳送對話 ID 和 UUI,再透過 UUI 中的交接將通話接回。

你的 Architect 流程會透過 BYOC Cloud 中繼線,將來電者連同對話 ID 和你設定的任何 UUI 傳送給智慧體。當來電者需要真人服務時,智慧體會傳送 SIP REFER,Genesys 會接回通話,而交接 ID 會出現在通話的 UUI 中。

開始前準備

  • 一個 ThunderPhone 智慧體和組織的 API 金鑰。
  • 已啟用 BYOC Cloud 的 Genesys Cloud,以及已啟用下列設定的外部中繼線(類型為 BYOC Carrier 或 PBX) (外部中繼線設定):
    • 對話標頭,讓 Genesys 在 x-inin-cnv 中傳送其對話 ID。此設定預設為關閉。
    • UUI 直通,標頭類型為 User-To-User,編碼為 Hex。
    • 接回與轉接,讓 Genesys 接受智慧體的 REFER。

1. 建立 SIP 端點

Genesys 會回應摘要驗證挑戰,因此請使用標準端點:

curl -X POST https://api.thunderphone.com/v1/sip-endpoints \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"agent_id": 12, "name": "Genesys Cloud"}'

請立即儲存回應中的 password;它只會顯示一次。在中繼線上:

設定值
SIP 伺服器sip.thunderphone.com,連接埠 5061
通訊協定TLS
摘要驗證端點的 username 和 password
編解碼器PCMU、PCMA 或 G.722

將中繼線加入你站點的外撥路由,其號碼方案必須涵蓋流程撥打的位址。

2. 傳送附帶情境資訊的通話

在你的 Architect 流程中:

  1. 你可以選擇新增 設定 UUI 資料 動作,為智慧體提供情境資訊,例如 account=12345。Genesys 建議不超過 128 個字元。
  2. 新增 轉接至號碼 動作,並填入端點的 sip_uri,例如 sip:agent-12-jhxmginwjx@sip.thunderphone.com。

Genesys 會在 x-inin-cnv 中傳送對話 ID。ThunderPhone 會將其儲存為通話的 external_call_id。UUI 會以解碼後的形式傳入提示詞,作為 {{sip_uui}}。

Genesys 中繼線自訂標頭是靜態的,因此請將每通通話的值放入 UUI。Genesys 保留 x-inin、x-genesys、x-pcv 和 x-gcv 標頭前綴供自身使用。

3. 接回通話

智慧體會使用 REFER 轉接至 Genesys 上的位址,且交接 ID 會以十六進位 UUI 的形式包含在該位址中。新增此轉接號碼(請參閱 新增轉接號碼 和轉接位址中的標頭):

{
  "name": "Genesys support",
  "number": "sip:support@acme.byoc.mypurecloud.com",
  "headers": {"User-to-User": "{{handoff_id}}"},
  "headers_in_uri": true,
  "uui_encoding": "hex"
}

請將該位址替換為可路由回應接聽來電者的佇列或流程的位址,並向 Genesys 確認其格式。REFER 如下所示:

Refer-To: <sip:support@acme.byoc.mypurecloud.com?User-to-User=5A72336D59...%3Bencoding%3Dhex>

啟用 接回與轉接 後,Genesys 會從中繼線接回通話,並將其路由至該位址。Genesys 文件指出傳入的 UUI 會存入 Call.UUIData;文件未說明接回通話是否同樣如此,因此請向 Genesys 確認,或透過測試通話確認接聽來電者的流程能在該處找到交接 ID。若要取得摘要和意圖,請在 Web Services Data Actions 整合上使用 通話資料動作 呼叫交接查詢:

  • 請求:GET https://api.thunderphone.com/v1/calls/handoff?handoff_id= 後接 Call.UUIData 中的 ID。
  • 憑證:你的 API 金鑰,以 Authorization: Bearer sk_live_… 傳送。
  • 輸出:將 handoff.summary 和 handoff.intent 對應至流程變數。

請參閱查詢已交接的通話。

測試

撥打可進入此流程的號碼,向智慧體要求轉接給某人,並確認 Genesys 將通話轉至你設定的位址。在該流程中,確認 Call.UUIData 以文字形式保存交接 ID(若顯示十六進位數字,請確認 trunk 的 UUI 編碼為 Hex)。接著使用 GET /v1/calls/{call_id} 開啟通話: external_call_id 應為對話 ID。

限制

  • 取得 SIP 標頭 動作僅讀取初始的 INVITE,因此無法 讀取智慧體 REFER 中的任何內容。交接僅會透過 UUI 傳送至 Genesys。
  • 當通話包含多個 UUI 標頭時,Genesys 會捨棄所有 UUI。
  • 轉接位址最長保留 254 個字元,因此過長的 UUI 會遭截斷以符合限制。 交接 ID 一律可完整容納。