为 Gmail 配置 OAuth 电子邮件渠道

本页介绍了如何使用 Google Cloud 创建 OAuth 凭据，以配置 Contact Center AI 平台 (CCAI Platform) 电子邮件渠道。

准备工作

请确保您已备好以下各项：

• Google Cloud 账号。如需了解详情，请参阅 Google Cloud 使用入门。

• Google Cloud 项目。如需了解详情，请参阅创建和管理项目。

此外，请确保您的 Google Cloud 项目已启用结算功能。如需了解详情，请参阅验证项目的结算状态。

创建 OAuth 凭据

您可以使用 Google Cloud 创建 OAuth 凭据（客户端 ID 和客户端密钥）。如果您尚未配置同意屏幕，则需要先配置同意屏幕，然后才能创建 OAuth 凭据。如需详细了解 OAuth，请参阅使用 OAuth 2.0 访问 Google API。

如需创建 OAuth 凭据并配置同意屏幕，请执行以下操作：

1. 在 Google Cloud 控制台中，前往项目选择器信息中心，然后选择要用于创建 OAuth 凭据的项目。

   项目选择器信息中心

2. 前往 API 和服务页面，然后在导航菜单中点击凭据。

   凭据

3. 如果您尚未为此 Google Cloud项目配置同意屏幕，系统会显示配置同意屏幕按钮。在这种情况下，请按照以下步骤配置权限请求页面。否则，请跳到第 4 步。

   1. 点击配置同意屏幕。系统会显示 OAuth 权限请求页面。

   2. 根据您的使用情形，选择内部或外部，然后点击创建。系统会显示 OAuth 权限请求页面窗格。

   3. 根据屏幕上的说明，在应用信息页面上输入信息，然后点击保存并继续。系统会显示范围窗格。

   4. 点击添加或移除范围。系统会显示更新所选范围窗格。

   5. 选择适合您的使用情形的范围，然后点击更新。

   6. 点击保存并继续。系统会显示测试用户窗格。

   7. 如果您想添加用户来测试应用的访问权限，请点击添加用户。系统会显示添加用户窗格。

   8. 在空白字段中，添加一个或多个 Google 账号的电子邮件地址，然后点击添加。

   9. 点击保存并继续。系统会显示摘要窗格。

   10. 检查 OAuth 权限请求页面信息，然后点击返回到信息中心。

   11. 如果您想立即将应用发布到正式版，请点击发布应用，然后在确认对话框中点击确认。您的同意屏幕已配置完毕。

4. 在导航菜单中，点击凭据。

5. 点击创建凭据，然后点击 OAuth 客户端 ID。

6. 在应用类型字段中，点击网络应用。

7. 在名称字段中，为客户端输入名称。

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. 点击创建。系统会显示 OAuth 客户端已创建对话框。

13. 点击下载 JSON，将包含您的客户端 ID 和客户端密钥的 JSON 文件下载到您的计算机，然后点击确定。

    重要提示： 请将此 JSON 文件保存在安全的位置，因为其中包含您的 OAuth 凭据。

获取您的客户端 ID 和客户端密钥

创建 OAuth 凭据后，您可以随时获取客户端 ID 和客户端密钥。

如需获取客户端 ID 和客户端密钥，请执行以下操作：

1. 在 Google Cloud 控制台中，前往 API 和服务页面。在导航菜单中，点击凭据。

   凭据

2. 在 OAuth 2.0 客户端 ID 区域中，点击您要获取客户端 ID 和客户端密钥的客户端。您的客户端 ID 和客户端密钥会显示在其他信息区域中。

为电子邮件渠道配置 SSO 设置

使用您在创建 OAuth 凭据中创建的客户端 ID 和客户端密钥，为电子邮件渠道配置单点登录 (SSO) 设置。

如需配置单点登录设置，请执行以下操作：

1. 在 CCAI 平台门户中，依次点击 Menu（菜单）和 Settings（设置）> Developer settings（开发者设置）。

2. 前往电子邮件账号管理窗格，然后点击管理电子邮件账号。

3. 在电子邮件账号管理页面上，点击电子邮件单点登录。

4. 在电子邮件 SSO 窗格中，按以下列表所示配置设置：

   • 授权网址。输入 https://accounts.google.com/o/oauth2/v2/auth?prompt=select_account consent。

     重要提示： 请在 consent 前添加空格。

   • 令牌网址。输入 https://oauth2.googleapis.com/token。

   • 客户端 ID。输入您在创建 OAuth 凭据中创建的客户端 ID。如果您未保存客户端 ID，请参阅获取客户端 ID 和客户端密钥。

   • 客户端密钥。输入您在创建 OAuth 凭据中创建的客户端密钥。如果您未保存客户端密钥，请参阅获取您的客户端 ID 和客户端密钥。

   • 范围。输入 https://mail.google.com/。

   • 状态。将此字段留空。

   • 访问权限类型。输入 offline。

   • 授权类型。输入 Authorization Code。

   • 清除在授权网址和令牌网址中包含授权类型复选框。

   • 选中将重定向网址作为授权网址和令牌网址的一部分包含在内复选框，然后点击保存。您的电子邮件渠道已配置为使用 OAuth。