Zendesk CRM 安裝指南

Contact Center AI 平台 (CCAI 平台) 支援與 Zendesk CRM 整合。本指南將說明整合時所需的步驟。系統支援下列 Zendesk 應用程式:

  • 通話:最新版本:v1.4.0

  • Chat:最新版本:v1.3.0

事前準備

Zendesk 客戶關係管理系統整合的必要條件如下:

  • 以管理員身分登入 CCAI Platform 入口網站。

  • 使用 Professional 或 Enterprise 方案的 Zendesk 帳戶。

  • 下載 Zendesk 應用程式檔案。

  • 請先詳閱操作說明再進行安裝。

安裝

Zendesk 應用程式是私人應用程式,不會列在公開的 Zendesk 應用程式市集中。如要取得並安裝這些應用程式,請與 Zendesk 代表聯絡。

如要安裝 Zendesk 應用程式,請按照這些操作說明或點選 Zendesk 應用程式中的連結。如要在 Zendesk 支援服務中上傳及安裝私人應用程式,請按照下列步驟操作:

  1. 登入 Zendesk,然後按一下側欄中的「管理」圖示 。

  2. 依序選取「應用程式」 >「管理」。

  3. 按一下「上傳應用程式」。

  4. 輸入應用程式的名稱。建議您將通話應用程式命名為「通話」,即「Call」,將即時通訊應用程式命名為「即時通訊」,即「Chat」。

  5. 按一下「選擇檔案」,然後選取私人應用程式的 ZIP 檔案。

    • 通話應用程式的檔案名稱為 zendesk-call-v1.4.zip。

    • 如果是即時通訊應用程式,檔案名稱為 zendesk-chat-v1.3.zip。

  6. 按一下「上傳」。

  7. 在隨即顯示的視窗中,按一下「同意並上傳這個應用程式」。

  8. 輸入帳戶子網域。

  9. 啟用角色或群組限制,並視需要輸入角色或群組。

  10. 出現提示時,按一下「安裝」。

程序完成後,私人應用程式就會顯示在「管理應用程式」頁面的已安裝應用程式清單中。

如要安裝通話和即時通訊應用程式,請重複上述步驟。

安裝 Zendesk 應用程式

安裝 Zendesk 應用程式

  1. 針對應用程式設定,請指定下列欄位值:

    • 子網域:輸入 Zendesk 帳戶的子網域,您應該已經知道這個子網域。(客戶,即 customer.example.com)

    -- 網域名稱:保留預設值「example.com」。

管理應用程式

安裝即時通訊和通話應用程式後,即可透過 Zendesk 管理這些應用程式。

變更應用程式設定

如要變更應用程式設定,請按照這些操作說明進行。你可以變更應用程式的設定,包括標題。

  1. 登入 Zendesk,然後按一下側欄中的「管理」圖示 。

  2. 依序選取「應用程式」 >「管理」。

  3. 在「我的應用程式」頁面中,找出要變更的應用程式。

  4. 按一下應用程式圖示,開啟該應用程式的設定頁面。

  5. 視需要進行變更,然後按一下頁面底部的「儲存設定」。變更已儲存。

更新應用程式

你可能需要定期更新已安裝的應用程式。如要更新應用程式,請按照下列操作說明進行:

如需更新私人應用程式的操作說明,請按一下 Zendesk 的「私人應用程式」頁面中的下列連結。

  1. 登入 Zendesk,然後按一下側欄中的「管理」圖示 。

  2. 依序選取「應用程式」 >「管理」。

  3. 在「我的應用程式」頁面中,找到要更新的應用程式。

  4. 按一下應用程式圖示上的 圖示,開啟應用程式設定選單。

  5. 按一下「更新」,開啟可上傳更新版 ZIP 檔案的畫面。

設定 OAuth 用戶端

Zendesk 應用程式會使用 OAuth2 驗證對 Zendesk 的 API 要求。您應為 Zendesk 應用程式設定 OAuth 用戶端。

下列操作說明將引導您完成 OAuth 設定程序,包括向 Zendesk 註冊應用程式。

應用程式註冊

  1. 在 Zendesk Support 中,按一下「管理」。

  2. 在「頻道」類別中選取「API」。

  3. 在「Channels / API」(管道/API) 頁面中,按一下「OAuth Clients」(OAuth 用戶端) 分頁標籤。

  4. 按一下客戶清單右側的 圖示。

  5. 填寫下列欄位來建立用戶端:

    • 用戶端名稱:輸入應用程式名稱。系統要求使用者授予應用程式存取權時,以及使用者查看可存取 Zendesk 的第三方應用程式清單時,都會顯示這個名稱。

    • 說明:(選用) 這是應用程式的簡短說明,使用者在系統要求授予存取權時會看到這段文字。

    • 公司:(選填) 這是使用者在系統要求授予應用程式存取權時,會看到的公司名稱。這項資訊可協助使用者瞭解要授予存取權的對象。

    • 標誌:(選用) 這是使用者在系統要求授予應用程式存取權時看到的標誌。圖片可以是 JPG、GIF 或 PNG 格式。為獲得最佳效果,請上傳正方形圖片。並調整大小以符合授權頁面。

    • 專屬 ID:這個欄位會自動填入您輸入的應用程式名稱,並經過重新格式化。您可以視需要變更。

    • 重新導向網址:輸入 Zendesk 應使用的網址,將使用者授予應用程式存取權的決定傳送至該網址。網址必須是絕對網址,而非相對網址,且必須為 https (localhost 或 127.0.0.1 除外),並以換行符號分隔。

  6. 按一下 [儲存]。

    頁面重新整理後,下方會顯示新的預先填入密鑰欄位。這是 OAuth2 規格中指定的 client_secret 值。

  7. 將「Secret」值複製到剪貼簿,並儲存在安全的地方。

  8. 設定 OAuth 重新導向網址。

    https://YOUR_SUBDOMAIN.example.com/v1/zendesk/oauth_callback

    請將 YOUR_SUBDOMAIN 替換為 Zendesk 帳戶的實際子網域。

  9. 設定「Unique Identifier」(不重複 ID) 和「Secret」(密鑰) 欄位,新增 OAuth 用戶端時,系統會自動填入這些欄位。您可以視需要編輯「Unique Identifier」(不重複 ID),但無法編輯「Secret」(密碼)。新增用戶端時,密鑰只會完整顯示一次。請務必妥善保管這組 PIN 碼。這些是 OAuth2 規格中的 client_id 和 client_secret 值。

設定 OAuth 應用程式

  1. 登入 CCAI 平台入口網站。

  2. 依序前往「設定」>「開發人員設定」。

  3. 在「CRM」部分選取「Zendesk」。

  4. 將「Zendesk Subdomain」設為 Zendesk 帳戶的子網域。

  5. 將「OAuth Client ID」(OAuth 用戶端 ID) 設為 Zendesk OAuth 用戶端的「Unique Identifier」(專屬 ID)。

  6. 將「OAuth 用戶端密鑰」設為 Zendesk OAuth 用戶端的「密鑰」。

  7. 按一下 [儲存]。

產生 API 權杖

Zendesk API 會使用權杖來確保安全性。如要在 Zendesk 中產生 API 權杖,請按照下列步驟操作:

  1. 在 Zendesk 中,按一下側欄中的「管理」 圖示。

  2. 依序選取「管道」 >「API」。

  3. 按一下「設定」分頁標籤,並確認「權杖存取權」已啟用。

  4. 按一下「Active API Tokens」(有效 API 權杖) 右側的 圖示。

  5. 您也可以選擇在「API Token Description」(API 權杖說明) 下方輸入說明。

  6. 系統會產生並顯示權杖:

    顯示權杖

  7. 複製權杖,並貼到安全的地方。關閉這個視窗後,系統就不會再顯示完整權杖。

  8. 按一下「儲存」,返回 API 頁面。

  9. 系統會顯示權杖的截斷版本:

    權杖顯示遭截斷

設定 API 權杖

如要將 API 權杖指派給 Zendesk CRM 設定,請按照下列步驟操作:

  1. 使用管理員帳戶登入 CCAI Platform 入口網站。

  2. 依序前往「設定」>「開發人員設定」。

  3. 將「API Token」設為從 Zendesk 用戶端複製的「API token」。

建立顧客和支援單欄位

您也可以選擇建立顧客和支援單欄位。步驟如下:

  1. 建立同時具有管理員和服務專員角色的 Zendesk 帳戶。

  2. 在 Zendesk 中,依序前往「設定」>「服務專員和經理團隊」。

  3. 選取「新增管理員」。

  4. 勾選「這位管理員也是服務專員」。

  5. 透過邀請電子郵件啟用帳戶。

  6. 登出目前的管理員帳戶,然後登入新帳戶。

  7. 以管理員身分登入 Zendesk,而非專員。

  8. 在 Zendesk 中,使用具有管理員身分和服務專員角色的憑證,透過小工具登入。

  9. 按一下 [授權]。

  10. 開啟 CCAI Platform 入口網站,然後依序前往「設定」 >「開發人員設定」。

  11. 依序點選「CRM」 >「Customer fields for Contact and Ticket」(聯絡人和支援單的客戶欄位) 部分的「建立」按鈕。

  12. 檢查自訂支援單欄位是否是從 Zendesk 管理 >「管理」 >「使用者欄位和管理」 >「管理」 >「支援單欄位」建立。

    這些欄位應包括:

    • 使用者欄位:

    • ID

    • 票證欄位:

    • 驗證 (核取方塊)

    • 顧客文字意見回饋 (多行文字)

    • 顧客滿意度評分 (數字):1 到 5 分

    • 分享顧客評分 (文字):Twitter 或 Facebook