為 Gmail 設定 OAuth 電子郵件管道

本頁面說明如何使用 Google Cloud 建立 OAuth 憑證，以設定 Contact Center AI Platform (CCAI Platform) 電子郵件管道。

事前準備

請確認你已具備以下條件：

此外，請確認您已為 Google Cloud 專案啟用計費功能。詳情請參閱「確認專案的帳單狀態」。

建立 OAuth 憑證

您可以使用 Google Cloud 建立 OAuth 憑證，也就是用戶端 ID 和用戶端密鑰。如果尚未設定同意畫面，您必須先執行這個動作，才能建立 OAuth 憑證。如要進一步瞭解 OAuth，請參閱「使用 OAuth 2.0 存取 Google API」。

如要建立 OAuth 憑證並設定同意畫面，請按照下列步驟操作：

  1. 在 Google Cloud 控制台中，前往專案選擇器資訊主頁，然後選取要用來建立 OAuth 憑證的專案。

    專案選取器資訊主頁

  2. 前往「APIs and Services」(API 和服務) 頁面，然後在導覽選單中按一下「Credentials」(憑證)。

    憑證

  3. 如果您尚未為這個專案設定同意畫面，系統會顯示「設定同意畫面」 Google Cloud按鈕。在這種情況下，請按照下列程序設定同意畫面。如果沒有，請跳到步驟 4。

    1. 按一下「設定同意畫面」。系統會顯示「OAuth 同意畫面」頁面。

    2. 視用途選取「內部」或「外部」，然後按一下「建立」。系統會顯示「OAuth 同意畫面」窗格。

    3. 按照畫面上的指示，在「應用程式資訊」頁面輸入資訊，然後按一下「儲存並繼續」。系統會顯示「範圍」窗格。

    4. 按一下「新增或移除範圍」。系統會顯示「更新所選範圍」窗格。

    5. 選取適合用途的一或多個範圍，然後按一下「更新」。

    6. 按一下「儲存並繼續」。系統會顯示「測試使用者」窗格。

    7. 如要新增使用者來測試應用程式的存取權，請按一下「新增使用者」。畫面上會顯示「新增使用者」窗格。

    8. 在空白欄位中新增一或多個 Google 帳戶的電子郵件地址，然後按一下「新增」。

    9. 按一下「儲存並繼續」。系統會顯示「摘要」窗格。

    10. 檢查 OAuth 同意畫面資訊，然後按一下「Back to dashboard」(返回資訊主頁)。

    11. 如要立即發布正式版應用程式，請按一下「發布應用程式」，然後在確認對話方塊中按一下「確認」。您已設定同意畫面。

  4. 在導覽選單中，按一下「憑證」。

  5. 依序點按「建立憑證」和「OAuth 用戶端 ID」。

  6. 在「應用程式類型」欄位中，按一下「網頁應用程式」。

  7. 在「Name」(名稱) 欄位中，輸入用戶端的名稱。

  8. 在「已授權的 JavaScript 來源」區域中，按一下「新增 IRI」。

  9. 在「URI」欄位中輸入 https://TENANT_NAME.ccaiplatform.com，並將 TENANT_NAME 換成您的租戶名稱。

  10. 在「已授權的重新導向 URI」區域，按一下「新增 URI」。

  11. 在「URI」欄位中輸入 https://TENANT_NAME.ccaiplatform.com/v1/email_accounts/oauth_callback，並將 TENANT_NAME 換成您的租戶名稱。

  12. 點按「Create」(建立)。系統會顯示「OAuth 用戶端已建立」對話方塊。

  13. 按一下「下載 JSON」，將內含用戶端 ID 和用戶端密鑰的 JSON 檔案下載到電腦，然後按一下「確定」。

取得用戶端 ID 和用戶端密鑰

建立 OAuth 憑證後，隨時可以取得用戶端 ID 和用戶端密鑰。

如要取得用戶端 ID 和用戶端密鑰，請按照下列步驟操作：

  1. 在 Google Cloud 控制台中，前往「APIs and Services」(API 和服務) 頁面。在導覽選單中，按一下「憑證」。

    憑證

  2. 在「OAuth 2.0 用戶端 ID」區域中，按一下要取得用戶端 ID 和用戶端密鑰的用戶端。用戶端 ID 和用戶端密鑰會顯示在「其他資訊」區域。

為電子郵件管道設定單一登入

使用您在「建立 OAuth 憑證」中建立的用戶端 ID 和用戶端密鑰，設定電子郵件管道的單一登入 (SSO) 設定。

如要設定單一登入，請按照下列步驟操作：

  1. 在 CCAI Platform 入口網站中，依序點選 「選單」>「設定」>「開發人員設定」。

  2. 前往「電子郵件帳戶管理」窗格，然後點選「管理電子郵件帳戶」。

  3. 在「電子郵件帳戶管理」頁面中，按一下「電子郵件 SSO」。

  4. 在「Email SSO」(電子郵件 SSO) 窗格中，按照下列清單設定：

    • 授權網址。輸入 https://accounts.google.com/o/oauth2/v2/auth?prompt=select_account consent。

    • 權杖網址。輸入 https://oauth2.googleapis.com/token。

    • 用戶端 ID。輸入您在「建立 OAuth 憑證」中建立的用戶端 ID。如果沒有儲存用戶端 ID，請參閱「取得用戶端 ID 和用戶端密鑰」。

    • 用戶端密鑰。輸入您在「建立 OAuth 憑證」中建立的用戶端密鑰。如果沒有儲存用戶端密鑰，請參閱「取得用戶端 ID 和用戶端密鑰」。

    • 範圍：輸入 https://mail.google.com/。

    • State (狀態)。請將這個欄位留空。

    • 存取類型。輸入 offline。

    • 授權類型。輸入 Authorization Code。

    • 取消勾選「Include the Grant Type as part of the Authorization URL and Token URL」(在授權網址和權杖網址中加入授權類型) 核取方塊。

    • 選取「Include the Redirect URL as part of the Authorization URL and Token URL」(將重新導向網址納入授權網址和權杖網址) 核取方塊，然後按一下「Save」(儲存)。電子郵件管道已設定 OAuth。