Integration Hub

本頁面中的檔案適用於受控發布 (CR) 版本中的產品或功能。如果您不是 CR 群組成員，但希望獲得更多資訊，請聯絡 CXone 客戶代表。

Integration Hub提供了處理CXone與第三方驗證和 Web 服務整合的標準化方法。Web 服務可以是應用程式、平台或系統。

Integration Hub是用於在CXone中調用 REST API 的方式之一。使用Integration Hub的好處是您可以新增連接並將其用於多個位置。其他方法需要在每次使用時建立連接。

此外，您可以將需要增強安全性的資料儲存在Integration Hub中。新增為秘密的資料已加密，無法直接存取。

連接和連接範本

連接定義 API 請求的詳細資訊、驗證詳細資訊以及您要在CXone中使用的秘密。連接不必包含所有類型的連接資訊。它可以儲存受支援的資訊類型的任意組合。

新增到Integration Hub的每個連接都是基於連接範本建立的。範本定義要套用至將使用該範本建立的所有連接的基本資訊。其中包括：

連接範本在建立後無法修改。如果稍後需要更改範本中的某些內容，則必須刪除該範本並建立新範本。然而，連接本身是可以修改的。刪除範本不會影響使用該範本建立的連接。

範本可在Integration Hub的連接庫中找到。連接列在Integration Hub中的「我的連接」下。您最多可以建立 50 個連接。範本數量沒有限制。

請求是 API 調用。其指定以下資訊，這些資訊用於連接到 Web 服務：

URL：您要連接的資源的位置。
方法（動詞）：您希望請求執行的動作，例如檢索資料或建立新記錄。Integration Hub支援以下動詞：GET、PUT、POST、DELETE、TRACE、PATCH、HEAD、OPTIONS。可在連接中使用的動詞在用於建立連接的範本中定義。
標頭：是請求的一部分，包含有關請求的其他資訊。這可以包括語言、認證等。
查詢參數：一種透過 API 請求傳遞資訊的方法。其被配置為鍵/值對。其可用於篩選、排序、自訂或控制回應中傳回的資料。
正文：請求的內容。格式取決於您要連接的 API 的要求。正文的媒體類型必須與您要連結的資源期望的媒體類型相符。也稱為MIME 類型或內容類型。以下清單顯示了受支援的選項以及每個選項所使用的內容標頭：
- ApplicationJson： application/json
- ApplicationJsonPatch： application/json-patch+json
- FormURLEncoded： application/x-www-form-urlencoded
- TextHtml： text/html
- TextPlain： text/plain
- TextXml： text/xml

每個Integration Hub連線最多可以有 50 個請求。對於一次可以有多少個活躍請求沒有限制。

CXone對回應大小有32 KB 限制。使用查詢參數來篩選傳回的資料。這可以幫助您保持在該限制以下。

Integration Hub支援連接中請求的兩種選項：

手動：使用「新增請求」頁面上的選項在Integration Hub中構建手動要求。您可以在其中使用秘密。手動請求通常用於資料不變的情況。其可以直接從Integration Hub執行，而不需要Studio指令碼。其也可以在Studio指令碼中執行。
Studio：在某些情況下，API 請求無法在Integration Hub中構建為手動請求。例如，需要路徑參數、變數替換或連接到 SOAP Web 服務的請求必須在Studio指令碼中建構。但是，您可能希望在Integration Hub連接中追蹤這些請求。Studio請求選項可讓您執行此操作。Studio請求與此連接具有的所有手動請求一起顯示在連接的「請求」標籤上。

Integration Hub允許您將敏感資訊儲存為秘密。您可以將其用於任何需要額外安全性的資訊，例如密碼或金鑰。

秘密可以用於您在其中建立秘密的連接。如果您在Studio指令碼中執行連接或驗證要求，則可以使用指令碼中該連接的秘密。

秘密在靜態時被加密。Integration Hub使用進階加密標準 (AES) 來加密資料。其儲存在加密的資料庫中。資料被解密的唯一時間是在執行時。

當您想要使用驗證或在Studio指令碼中發出請求時，請使用以下Studio動作：

有關使用這些動作的關鍵資訊：