Open in
從 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。
- 對話標頭,讓 Genesys 在
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 流程中:
- 你可以選擇新增 設定 UUI 資料 動作,為智慧體提供情境資訊,例如
account=12345。Genesys 建議不超過 128 個字元。 - 新增 轉接至號碼 動作,並填入端點的
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 一律可完整容納。