借助电子邮件 OAuth 配置文件,您可以在 Contact Center AI 平台 (CCAI Platform) 中管理电子邮件账号的 OAuth 设置。您可以为所有 OAuth IMAP 账号创建单独的电子邮件 OAuth 配置文件,并将每个电子邮件账号与应使用的配置文件相关联,而不是为所有 OAuth IMAP 账号使用单个全局 OAuth 配置。
对于 Microsoft 365,电子邮件 OAuth 配置文件支持客户端凭据授权类型。此授权类型在应用级进行身份验证,而不是依赖于个人用户登录。它对于共享邮箱(例如
support@company.com)特别有用,因为访问权限不取决于一位管理员用户的密码、同意会话或就业状态。
本页面介绍了如何使用客户端凭据为 Microsoft 365 设置电子邮件 OAuth 配置文件。
授权代码与客户端凭据
CCAI Platform 支持电子邮件账号的授权代码和客户端凭据 OAuth 授权类型。下表对这些授权类型进行了比较:
| 授权类型 | 适用场景 | 工作原理 |
|---|---|---|
| 授权代码 | 特定于用户的邮箱 | 管理员或邮箱用户通过 Microsoft OAuth 同意流程登录。 |
| 客户端凭据 | 共享或应用管理的 Microsoft 365 邮箱 | CCAI Platform 使用应用注册、客户端密钥和 实例级权限来请求访问权限,而无需用户以交互方式 登录。 |
每个电子邮件 OAuth 配置文件都使用一种授权类型。如果您的组织需要不同的公益金类型、提供方或邮箱配置,请创建单独的电子邮件 OAuth 配置文件,并将每个电子邮件账号与相应的配置文件相关联。
准备工作
请确保您已备好:
一个 Microsoft 365 实例。
Microsoft Entra 管理员访问权限。
一个 CCAI Platform 管理员账号,具有管理电子邮件设置的权限。
已在本地安装 PowerShell。
已安装
ExchangeOnlineManagementPowerShell 模块。目录的 Microsoft 实例 ID。
您还需要知道 CCAI Platform 应访问哪个或哪些邮箱。
创建 Microsoft Entra 应用注册
CCAI Platform 使用 Microsoft Entra 应用注册来请求 OAuth 令牌,以便访问 Microsoft 365 电子邮件。
如需创建 Microsoft Entra 应用注册,请按以下步骤操作:
在 Microsoft Azure 中,依次前往 Microsoft Entra ID > 应用注册 。
选择新注册 。
为应用输入一个清晰的名称,例如“CCAI Platform 电子邮件 OAuth”。
完成注册。
复制应用(客户端)ID 。
复制目录(租户)ID 。
创建电子邮件 OAuth 配置文件时,请使用这些值。
创建客户端密钥
如需创建客户端密钥,请按以下步骤操作:
在应用注册中,前往证书和密钥 。
创建新的客户端密钥。
立即复制密钥值。
添加 Microsoft API 权限
应用需要获得通过 Exchange Online 访问和发送电子邮件的权限。
如需添加 Microsoft API 权限,请按以下步骤操作:
在应用注册中,前往 API 权限 。
选择添加权限 。
选择 Office 365 Exchange Online 。
选择应用权限 。
添加所需权限:
IMAP.AccessAsAppSMTP.SendAsApp
如果您希望 CCAI Platform 在下拉列表中显示可用的 Microsoft 365 邮箱,请添加列出实例用户或邮箱所需的 Microsoft Graph 应用权限。
选择为贵组织授予管理员同意书 。
确认权限显示为已授予,然后再继续。
授予应用对邮箱的访问权限
在应用获得实例级权限后,请授予其对 CCAI Platform 应连接到的特定邮箱的访问权限。
如需授予应用对邮箱的访问权限,请按以下步骤操作:
打开 PowerShell。
连接到 Exchange Online:
Connect-ExchangeOnline -Organization TENANT_ID将
TENANT_ID替换为您的 Microsoft 365 目录(租户)ID。在 Exchange 中注册服务主账号:
New-ServicePrincipal ` -AppId APPLICATION_CLIENT_ID ` -ObjectId OBJECT_ID替换以下内容:
APPLICATION_CLIENT_ID:Microsoft Entra 应用注册中的应用(客户端)IDOBJECT_ID:企业应用 中的对象 ID
授予邮箱访问权限:
Add-MailboxPermission ` -Identity EMAIL_ADDRESS ` -User SERVICE_PRINCIPAL_ID ` -AccessRights FullAccess替换以下内容:
EMAIL_ADDRESS:CCAI Platform 应访问的邮箱的电子邮件地址SERVICE_PRINCIPAL_ID:服务主账号 ID
在 CCAI Platform 中创建电子邮件 OAuth 配置文件
如需为 Microsoft 365 客户端凭据配置创建电子邮件 OAuth 配置文件,请按以下步骤操作:
在 CCAI Platform 门户中,依次点击 设置 > 开发者设置。 如果您没有看到设置 菜单,请点击 Menu。
前往电子邮件账号管理 窗格,然后点击管理电子邮件账号 。系统会显示电子邮件账号管理 页面。
点击电子邮件 OAuth 标签页。
点击添加配置文件 。
在名称 字段中,输入配置文件名称。
在授权类型 列表中,选择客户端凭据 。
在令牌网址 字段中,输入实例的 Microsoft OAuth 令牌端点。
在客户端 ID 字段中,输入 Microsoft Entra 中的应用(客户端)ID。
在客户端密钥 字段中,输入 Microsoft Entra 中的客户端密钥值。
在受众群体 字段中,输入受众群体。
在范围 字段中,输入范围。
在状态 字段中,输入状态。
在访问权限类型 字段中,输入访问权限类型。
点击保存 。
将电子邮件账号与 OAuth 配置文件相关联
如需将电子邮件账号与 OAuth 配置文件相关联,请按以下步骤操作:
在 CCAI Platform 门户中,依次点击 设置 > 开发者设置。 如果您没有看到设置 菜单,请点击 Menu。
前往电子邮件账号管理 窗格,然后点击管理电子邮件账号 。系统会显示电子邮件账号管理 页面。
点击电子邮件账号列表 标签页。
对于要修改的电子邮件账号,请点击 ,然后点击 修改电子邮件 账号。
在电子邮件服务 列表中,选择 OAuth IMAP 。
在 OAuth 配置文件 列表中,选择您在上一个步骤中创建的 OAuth 配置文件。
点击关联 。
在电子邮件 ID 列表中,选择您的邮箱。
点击保存 。
关联操作确认 CCAI Platform 可以使用所选的 OAuth 配置文件进行身份验证。邮箱选择操作会告知 CCAI Platform 电子邮件账号应使用哪个邮箱。
如果 CCAI Platform 无法从 Microsoft 获取邮箱列表,表单会回退到手动输入电子邮件地址。手动输入邮箱地址,然后保存账号。
问题排查
| 问题 | 解决方法 |
|---|---|
| 邮箱列表未加载 | 确认 Microsoft 应用具有所需的 Microsoft Graph 权限和管理员同意书。如果下拉列表不可用,您可以手动输入 邮箱。 |
| 关联失败,并显示身份验证错误 | 确认客户端 ID、客户端密钥、实例 ID 和令牌 网址正确无误。另请确认客户端密钥未过期。 |
| 邮箱无法收发电子邮件 | 确认应用在 Exchange Online 中具有邮箱权限 并且电子邮件账号已与正确的电子邮件 OAuth 配置文件相关联。 |