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

Contact centers

從 Genesys Cloud 連接

透過 BYOC Cloud 中繼線,將 Genesys Cloud 通話連同對話 ID 及 UUI 傳送至 ThunderPhone 智能體,並透過 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,編碼為十六進位。
    • 取回及轉接,讓 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(如顯示十六進位數字,請確認中繼的 UUI 編碼設為 Hex)。然後使用 GET /v1/calls/{call_id} 開啟通話:external_call_id 應為對話 ID。

限制

  • 取得 SIP 標頭動作只會讀取初始 INVITE,因此無法讀取智能體 REFER 中的任何內容。交接只會透過 UUI 傳送至 Genesys。
  • 當通話包含多於一個 UUI 標頭時,Genesys 會捨棄所有 UUI。
  • 轉接位址限制為 254 個字元,因此較長的 UUI 會被截斷以符合限制。交接 ID 必定能夠容納。