View a markdown version of this page

Zendesk 套件整合 - Amazon Quick
先決條件驗證您的 Zendesk 帳戶設定 Zendesk 帳戶在 Amazon Quick 中設定整合可用動作疑難排解

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

Zendesk 套件整合

使用自然語言直接從 Amazon Quick 管理您的 Zendesk 支援票證。使用 Zendesk Suite 動作連接器，您可以建立、更新、搜尋和列出支援票證，而無需離開 Amazon Quick。

Zendesk Suite 可在 Amazon Quick 中做為內建連接器使用。若要設定此整合，請完成下列兩個步驟。首先，準備具有所需存取權的 Zendesk 帳戶。然後，在 Amazon Quick 中建立連接器，並使用 Zendesk 登入資料進行驗證。

此連接器支援 OAuth 使用者身分驗證和 API 金鑰服務身分驗證。如需有關 Amazon Quick 支援的身分驗證方法的資訊，請參閱 身分驗證方法。

先決條件

設定整合之前，請確認您擁有下列資源和存取權。

  • 具有管理員角色的作用中 Zendesk 帳戶。

  • 存取 Zendesk 執行個體中票證和支援資料的許可。

  • 符合 中所述需求的訂閱在主控台中設定整合。

驗證您的 Zendesk 帳戶

設定 Amazon Quick 之前，請確認您的 Zendesk 帳戶符合下列要求。

設定 Zendesk 帳戶

Amazon Quick 中的自訂 OAuth 應用程式身分驗證方法需要在 Zendesk 中設定的 OAuth 用戶端。API 金鑰身分驗證方法需要 API 字符。

設定 OAuth 用戶端

  1. 在您的 Zendesk 執行個體中，導覽至管理中心，然後是應用程式和整合，然後是 API 下的 OAuth 用戶端。

  2. 選擇新增 OAuth 用戶端。

  3. 使用下列欄位填寫表單：

    • 名稱 – 輸入應用程式的名稱。

    • 描述 – 輸入簡短描述。

    • 識別符 – 輸入 OAuth 用戶端的唯一識別符。

    • 重新導向 URLs – 輸入 https://region.quicksight.aws.amazon.com/sn/oauthcallback。將區域取代為您的 AWS 區域，例如 us-east-1。

  4. 選擇儲存。Zendesk 會產生用戶端秘密。

    重要

    立即記錄用戶端秘密。離開此頁面後，您無法擷取它。

  5. 擷取秘密後，再次選擇儲存以建立 OAuth 用戶端。

當您使用自訂 OAuth 應用程式身分驗證方法在 Amazon Quick 中設定動作連接器時，識別符和秘密做為用戶端 ID 和用戶端秘密。

如需詳細資訊，請參閱 Zendesk 網站上的搭配您的應用程式使用 OAuth 身分驗證。

設定 API 字符

  1. 導覽至管理中心，然後是應用程式和整合，然後是 API 字符。

  2. 選擇新增 API 字符。

  3. 在描述中，輸入 API 字符的簡短描述。

  4. 選擇儲存。Zendesk 會產生 API 字符。

    重要

    立即記錄 API 字符。離開此頁面後，您無法擷取它。

如果您在 Amazon Quick 中選擇 API 金鑰驗證方法，請使用此 API 字符做為 API 金鑰值。

如需詳細資訊，請參閱 Zendesk 網站上的管理 Zendesk API 的 API 字符存取。

在 Amazon Quick 中設定整合

驗證 Zendesk 帳戶存取權後，請在 Amazon Quick 中建立連接器。

  1. 在 Amazon Quick 主控台中，選擇連接器。

  2. 選擇為您的團隊建立索引標籤。

  3. 從可用的選項中選擇 Zendesk 套件。

  4. 在 Zendesk Suite 對話方塊中，輸入下列欄位：

    • 名稱 – Zendesk 連接器的描述性名稱。

    • 描述 （選用） – 選擇 + 新增描述，以新增如何使用此連接器的備註。

    • 連線類型 – 選擇公有網路。

  5. 選擇您的身分驗證方法並設定連接器設定：

    • 自訂 OAuth 應用程式 – 為您的 Zendesk 執行個體輸入下列欄位：

      • 基本 URL

      • 用戶端 ID

      • 用戶端秘密

      • 字符 URL

      • 授權 URL

      • 重新導向 URL

    • API 金鑰 – 輸入下列欄位：

      • 基本 URL

      • API 金鑰 (Zendesk API 字符）

      • 與您的 Zendesk 帳戶相關聯的電子郵件

  6. 選擇下一步。

  7. 檢閱 Zendesk Suite 的動作，然後選擇下一步。

  8. 指定誰可以存取連接器：

    • 若要與團隊共用，請輸入團隊名稱或群組電子郵件。

    • 若要保持私有，請將 欄位保留空白。

    • 若要與所有使用者共用，請切換組織中的每個人。

  9. 選擇發布。

連接器會出現在可用面板中，狀態為已連線。

可用動作

設定連接器之後，您可以使用下列票證管理動作。

Zendesk Suite 可用的動作
Action 說明
建立票證 建立新的票證
列出搜尋結果 搜尋票證
列出票證 檢視所有票證
顯示票證 檢視票證詳細資訊
更新票證 編輯票證詳細資訊
注意

您可以使用的動作取決於 Zendesk 帳戶中設定的許可。

疑難排解

若要編輯、共用或刪除連接器，請參閱 管理現有的整合。

驗證問題

  • 登入失敗 – 確認您的 Zendesk 帳戶處於作用中狀態，而且您可以登入 Zendesk 網站上的 Zendesk 登入頁面。如果您的組織使用單一登入 (SSO)，請確認您的身分提供者已正確設定。

  • 存取遭拒 – 確認您的 Zendesk 使用者具有管理員角色，具有存取票證和支援資料的許可。對於 API 金鑰連線，請確認 API 字符有效且相關聯的電子郵件地址正確。