使用連接

在Integration Hub中，連接定義驗證詳細資訊和 API 請求。建立並配置連接後，您可以在CXone中使用它。

執行來自Integration Hub的請求

您可以從定義它的Integration Hub連接執行請求。僅手動請求可以從Integration Hub執行。

在 CXone 中，點擊應用程式選擇器 並選擇自動化與 AI > Integration Hub。

1. 從頁面左側的「我的連接」中點擊您要使用的連接。

2. 在請求標籤上，點擊要執行的請求旁邊的測試。將彈出一個頁面並顯示來自連接的 Web 服務的回應。

3. 如果您想保留，請選擇並複製頁面中回應的內容。

4. 查看回覆後，點擊取消。

在指令碼中使用驗證

連接可以儲存驗證詳細資訊。您可以在指令碼中任何需要的地方使用它們。它們可以單獨使用，也可以根據請求一起使用。

1. 打開 Studio 並登入。

2. 開啟您想要新增請求的指令碼。

3. 在指令碼中新增 ConnectAuth 動作。

4. 在ConnectAuth的connectName屬性中，輸入要使用的連接的名稱。如果您不知道連接名稱：

   1. 點擊兩下ConnectAuth開啟Integration Hub。
   2. 在「我的連接」下，點擊要使用的連接旁的剔選符號。
   3. 點擊是將其指派給動作。

   您可以使用變數替換，而不是在connectName屬性中使用特定連接的名稱。建立一個變數來儲存連接名稱，然後使用指令碼邏輯將該名稱傳遞給ConnectAuth。

在指令碼中使用手動請求

您可以在指令碼中任何需要進行 API 調用的位置使用手動請求。此請求必須在Integration Hub連接中的中定義。

該指令碼可能需要更多編輯來處理從請求連接的資源傳回的回應。此外，ConnectRequest 動作可能需要額外的配置。

1. 打開 Studio 並登入。

2. 開啟您想要在其中使用請求的指令碼。

3. 在指令碼中新增 ConnectRequest 動作。

4. 在connectName和requestName屬性中，輸入要使用的連接和請求的名稱。如果您不知道名字：

   1. 點擊兩下ConnectRequest開啟Integration Hub。

   2. 在「我的連接」下，點擊要使用的連接旁的剔選符號。

   3. 點擊是將其指派給動作。

   4. 選擇您剛剛指派給ConnectRequest的連接。

   5. 在「請求」標籤上，點擊您要指派給此動作的請求對應的方塊，然後點擊確定。

   您可以使用變數替換，而不是在connectName和requestName屬性中使用特定連接和請求的名稱。建立變數來儲存名稱，然後使用指令碼邏輯將名稱傳遞給ConnectRequest。

5. 若要使用指令碼中已連結連接中的變數，請將變數名稱括在雙括號 ([[ ]] ) 中。

在指令碼中使用Studio請求

Studio 請求首先將被新增到Integration Hub連接，然後透過ConnectRequest 動作新增到指令碼。請求的詳細資訊可能會因Studio的輸入而更改，因此這些詳細資訊通常在SNIPPET動作建構中，以便可以將其傳遞到ConnectRequest動作。

該指令碼可能需要更多編輯來處理從請求連接的資源傳回的回應。此外，ConnectRequest動作或Snippet動作可能需要額外的配置。

1. 在Integration Hub中建立Studio請求並在指令碼中建構請求物件（如果尚未這樣做）。

2. 在Studio中，打開包含您要使用的請求的指令碼。
3. 將ConnectRequest 動作新增到儲存請求物件的Snippet動作之後的指令碼中，並將其連接。

4. 在ConnectRequest的connectName屬性中，輸入要使用的連接的名稱。如果您不知道名稱：

   1. 點擊兩下ConnectRequest開啟Integration Hub。

   2. 在「我的連接」下，點擊要使用的連接旁的剔選符號。

   3. 點擊是將其指派給動作。

   4. 選擇您剛剛指派給ConnectRequest的連接。

   5. 在「請求」標籤上，點擊您要指派給此動作的請求對應的方塊，然後點擊確定。

   您可以使用變數替換，而不是在connectName屬性中使用特定連接和請求的名稱。建立一個變數來儲存名稱，然後使用指令碼邏輯將名稱傳遞給ConnectRequest。

5. 選擇ConnectRequest動作，並使用儲存 JSON 請求的變數名稱來配置 RequestPayload 欄位。您在Snippet中定義了此變數

6. 若要使用指令碼中已連結連接中的變數，請將變數名稱括在雙括號 ([[ ]] ) 中。

7. 如果您的連接需要授權，請在指令碼中新增並配置ConnectAuth動作。