登录讯蜂个人控制台，在“接收来源 → 邮箱验证码 → 添加邮箱”中填写自己的 Outlook、Hotmail、Live、MSN 或 Microsoft 365 邮箱，优先选择“Outlook（推荐）”，再到弹出的 Microsoft 官方页面登录并核对授权范围；回调校验通过后，邮箱会自动绑定，无需向讯蜂填写邮箱登录密码。
Outlook 推荐模式和兼容模式怎么选？
| 模式 | 连接方式 | 授权范围 | 适用情况 |
|---|---|---|---|
| Outlook（推荐） | Microsoft Graph | User.Read、Mail.Read 及登录和离线访问范围 | 个人 Outlook 与能够使用 Microsoft Graph 的 Microsoft 365 邮箱，通常优先选择 |
| Outlook（兼容模式） | IMAP OAuth / XOAUTH2 | IMAP.AccessAsUser.All 及登录和离线访问范围 | 明确需要 IMAP OAuth，且账号或组织已经允许 IMAP 的邮箱 |
两种模式都使用 Microsoft OAuth，不要求在讯蜂表单中填写邮箱登录密码。当前用户自助绑定会严格使用所选方式：推荐模式不会自动回退 IMAP，兼容模式也不会自动改用 Graph。
Mail.Read 是读取当前登录用户邮箱的委托权限，但并非只允许读取某一封验证码邮件。IMAP.AccessAsUser.All 的范围更广：按 Microsoft 定义，可通过 IMAP 读取、更新、创建和删除邮件，并非只读权限。讯蜂当前兼容模式只读取邮件且不申请发信权限；授权前仍应核对 Microsoft 页面展示的范围，并仅绑定本人或已获明确授权的邮箱。
绑定前需要准备什么？
- 一个正常登录的讯蜂个人账号，且当前套餐已经生效。
- 套餐中仍有可用邮箱额度；已经绑定的同一邮箱不能重复添加。
- 自己拥有或已经取得邮箱所有者明确授权的 Outlook 或 Microsoft 365 邮箱。
- 允许
cc.akuwan.cn打开 Microsoft 授权弹窗的浏览器。 - 如果选择兼容模式，邮箱账号或 Microsoft 365 组织需要允许 IMAP OAuth。
系统会自动识别 outlook.com、hotmail.com、live.com 和 msn.com。Microsoft 365 自定义域名不一定能从后缀判断，遇到这种情况请手动选择 Outlook 模式。账号必须拥有实际邮箱，并满足 Microsoft 应用与组织策略要求。
Outlook 与符合条件的 Microsoft 365 邮箱使用 Microsoft OAuth；网易、QQ、139、新浪及 VIP、阿里个人邮箱使用 IMAP 邮箱绑定流程，其中阿里个人邮箱使用邮箱密码，其余使用客户端授权码。完整范围见平台支持邮箱清单。
在讯蜂控制台绑定 Outlook 的步骤
- 确认账号与额度：确认讯蜂账号和套餐有效、邮箱额度未满，并准备自己拥有或已获明确授权的邮箱。
- 进入接收来源：打开讯蜂个人控制台的接收来源，选择“邮箱验证码”页签，点击“添加邮箱”。
- 填写邮箱资料：输入完整邮箱地址；邮箱备注、关联手机号和用途为选填项，可用于区分业务归属。
- 选择 Outlook 模式：通常选择“Outlook（推荐）”；只有明确需要 IMAP OAuth 时才选择“Outlook（兼容模式）”。
- 确认邮箱归属：勾选邮箱归本人所有，或已获得邮箱所有者明确授权。
- 前往 Microsoft 授权：点击按钮后，在弹出的 Microsoft 官方页面登录与所填邮箱一致的账号并确认对应权限。
- 等待自动回调：不要退出讯蜂或切换账号。Microsoft 返回讯蜂后，系统会自动验证账号、授权范围和邮箱连接。
- 测试连接：绑定成功后返回邮箱列表，使用“测试连接”确认该邮箱仍可正常读取。
授权回调时系统会做什么？
点击授权后，讯蜂通过 OAuth 2.0 授权码流程和 PKCE 发起一次绑定请求。Microsoft 回调时，系统会依次检查授权状态、原讯蜂登录会话、所需权限、Microsoft 账号与所填邮箱的关系，以及 Graph 或 IMAP 连接是否真实可用。
- 在当前单服务部署中，授权状态约 10 分钟内有效，并且只能使用一次；服务重启后需要重新发起。
- 必须保持发起授权时的讯蜂账号和登录会话，不能中途退出或切换用户。
- Graph 模式会把所填地址与 Microsoft 账号返回的
mail或userPrincipalName比对。 - IMAP 模式会对所填写的确切邮箱执行 OAuth 连接验证。
- 验证成功后才创建绑定；失败不会把邮箱加入当前账号。
- 结果通过同源回调窗口返回原页面，成功时邮箱列表会自动刷新。
管理员需要先完成什么？
普通用户能够自助授权的前提，是讯蜂管理员已经在 Microsoft Entra 注册应用，并在讯蜂后台完成全局 OAuth 配置。管理员需要确认应用支持目标账号类型、配置对应委托权限，并把后台显示的“用户自助授权回调地址”原样登记为 Microsoft Entra 应用的 Web 重定向 URI。
应用的 Client ID、Tenant 和必要的客户端凭据应只保存在受控后台，不得写入官网、公开教程、截图、聊天记录或代码仓库。普通用户不需要获取这些配置；如果页面提示 Outlook 尚未配置，应联系平台管理员。
Outlook OAuth 常见错误与处理
| 现象 | 常见原因 | 处理方法 |
|---|---|---|
| 浏览器阻止 Microsoft 授权窗口 | 当前站点弹窗被浏览器拦截 | 允许 cc.akuwan.cn 弹窗后重新点击授权 |
| Outlook 暂时无法授权 | 管理员尚未完成 Microsoft OAuth 全局配置 | 联系平台管理员检查 Client ID、Tenant、权限与回调地址 |
| 授权状态已失效 | 授权超过约 10 分钟、回调被重复打开、服务重启或状态已变化 | 关闭旧弹窗，返回接收来源重新发起 |
| 发起授权的登录会话已变更 | 中途退出讯蜂、切换账号或登录会话失效 | 重新登录原账号并再次授权 |
| Microsoft 授权未完成 | 取消授权、拒绝权限或未返回有效授权码 | 重新发起并核对所选模式对应的权限 |
| 授权范围不完整 | Entra 应用未配置所选模式的权限，或用户/管理员未同意 | 由管理员检查 Graph 的 User.Read、Mail.Read，或 IMAP 的 IMAP.AccessAsUser.All |
| 登录账号与填写邮箱不一致 | 所填地址与 Microsoft 返回的 mail、userPrincipalName 均不一致 | 退出错误账号，使用与所填邮箱对应的账号重试 |
| 无法验证邮箱控制权 | Graph 邮件读取失败，或账号/组织未允许 IMAP OAuth | 先尝试推荐模式；必须使用 IMAP 时请管理员确认邮箱策略 |
| 邮箱已绑定或额度已满 | 邮箱重复添加，或套餐邮箱数量达到上限 | 使用已有绑定、解绑不用的邮箱，或升级套餐 |
| 弹窗关闭后仍未绑定 | 授权窗口被手动关闭，尚未完成回调 | 重新发起并等待页面显示明确的成功或失败结果 |
OAuth 授权的安全边界
- 只绑定本人所有或已经得到邮箱所有者明确授权的邮箱。
- 所有账号登录和同意操作都应在 Microsoft 官方页面完成，不要把邮箱密码发给讯蜂客服或任何实施人员。
- Graph 推荐模式申请委托的用户身份与邮箱读取权限，不申请发信权限；IMAP 兼容模式申请委托的 IMAP 访问权限。
- 不要在截图、工单或公开聊天中暴露授权结果、浏览器地址栏参数、验证码、Token 或管理员应用凭据。
- 邮箱不再使用时，应在讯蜂中解绑；如需撤销 Microsoft 侧授权，还应通过个人账号或组织的应用授权管理执行撤销。
Microsoft 的界面、账号策略和权限要求可能调整。OAuth 授权码流程以Microsoft identity platform 授权码流程为准；Graph 权限以Microsoft Graph 权限参考为准；IMAP OAuth 以Microsoft Exchange Online OAuth 文档为准。
常见问题
其他国内邮箱也使用 Outlook 授权吗？
不使用。网易 163、126、yeah.net、QQ、139、新浪及 VIP 采用 IMAP 客户端授权码绑定，阿里个人邮箱采用 IMAP 邮箱密码绑定。Outlook 的 Microsoft OAuth 流程保持独立。
绑定 Outlook 需要填写邮箱密码吗？
不需要。讯蜂会打开 Microsoft 官方授权页面，用户在 Microsoft 页面登录并批准对应权限，不应把邮箱登录密码填写到讯蜂表单或发送给他人。
Outlook 推荐模式和兼容模式有什么区别？
推荐模式通过 Microsoft Graph 读取邮箱，申请 User.Read 和 Mail.Read 委托权限。兼容模式申请 IMAP.AccessAsUser.All；按 Microsoft 定义，该范围可通过 IMAP 读取、更新、创建和删除邮件，并非只读权限。讯蜂当前兼容模式只读取邮件且不申请发信权限，两种模式不会自动互相回退。
Microsoft 365 自定义域名邮箱怎么选择？
Outlook、Hotmail、Live 和 MSN 公共邮箱通常可自动识别；使用自定义域名的 Microsoft 365 邮箱可能需要手动选择 Outlook（推荐）或 Outlook（兼容模式）。
为什么提示 Microsoft 登录账号与填写邮箱不一致？
Graph 模式会把所填地址与 Microsoft 账号返回的 mail 或 userPrincipalName 比对。请退出错误账号后，使用与所填地址对应的账号重新授权。
为什么授权窗口关闭后邮箱没有绑定？
手动关闭弹窗、浏览器阻止弹窗、授权超过约 10 分钟、服务重启或讯蜂登录会话发生变化，都会导致绑定未完成。允许本站弹窗、保持原登录会话并重新发起即可。
为什么无法继续添加 Outlook 邮箱？
请检查邮箱是否已经绑定、当前套餐是否有效，以及邮箱数量是否达到套餐上限。额度已满时需先解绑不用的邮箱或升级套餐。
官方参考：Microsoft OAuth 2.0 授权码流程、Microsoft Graph 权限参考、Exchange Online IMAP OAuth。相关产品说明见讯蜂验证中心与短信和邮箱验证码统一管理。