跳到正文

邮箱连接指引

连接 Microsoft 365 邮箱

这一步我们一起做:共享屏幕,由您操作(全程使用贵公司自己的管理员账号登录),我们在旁边说明每一步点哪里。

约 40 分钟需要管理员账号一次性配置
已完成 0 / 5 步

它只写草稿,永远不会替您发送。这不是把发送功能关掉了,而是产品里根本没有这个功能,因此不存在误发的可能。草稿会一直留在草稿箱里,由您过目、修改,再自己点发送。

有一点需要先说明,以免误以为是本产品的流程繁琐。几年前起,Microsoft 就取消了 Microsoft 365 邮箱的“密码登录”。任何软件要接入 M365 邮箱,都必须先在贵公司的账号后台注册成一个应用并获得授权。这是 Microsoft 的统一要求,所有同类软件都一样。

Gmail 十分钟即可完成,这里需要四十分钟,原因就在于此。但它只需配置一次。

开始之前,请先确认三件事

一、必须是“工作或学校账号”

@outlook.com@hotmail.com@live.com 结尾的个人账号不支持,Microsoft 没有为个人账号开放这条通道。必须是企业购买的 Microsoft 365,地址通常形如 姓名@公司域名.com

二、确认谁持有“管理员”账号

只有拥有全局管理员权限的账号才能完成配置。用该账号打开 admin.microsoft.com

如果公司内部没人知道管理员是谁,通常是以下两种情况:

如果这项配置由 IT 部门或服务商完成,请改发面向管理员的版本:内容是同一件事,但按权限申请的方式写明了配置步骤、出网地址与吊销方式。

请提前一两天把这件事问清楚。整个流程中唯一可能拖上几天的就是这一环,而且卡在内部找人,与技术无关。

三、约一次 40 分钟的共享屏幕

请准备好:管理员账号的登录方式(含收验证码的手机)、一台 Windows 电脑(有一步要用 Windows 自带的 PowerShell),以及要连接的那个邮箱地址。

我们会一起做的五步

每一步都写清了屏幕上会出现什么、需要记下什么。无需提前预习,通话时照着做即可。

01

注册一个应用约 5 分钟

  1. 打开 entra.microsoft.com,用管理员账号登录
  2. 左边菜单:应用程序 → 应用注册Applications → App registrations
  3. 点顶部新注册New registration
  4. 名称BestTeam
  5. 受支持的账户类型:保持默认的第一项
  6. 重定向 URI留空,什么都不要填
  7. 注册

注册完成后会直接跳到该应用的概述页,其中有两串值需要记下:应用程序(客户端) ID目录(租户) ID。格式均为 xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx,请复制到记事本里。

完成标志记事本里有两串 ID,格式均为短横线连接的五段字符。
02

给它权限,并且同意约 5 分钟

  1. 在这个应用的左边菜单里点 API 权限API permissions
  2. 添加权限Add a permission
  3. 切到 我的组织使用的 APIAPIs my organization uses)这个标签页
  4. 搜索 Office 365 Exchange Online,点搜到的那一条
  5. 应用程序权限Application permissions
  6. 展开 IMAP,勾选 IMAP.AccessAsApp
  7. 添加权限
  8. 回到权限列表,点为“公司名”授予管理员同意,确认
这是最容易遗漏的一步。没有那个绿色对勾,后续步骤都不会生效;而报错看上去像是“密码错了”,很容易查错方向。
完成标志IMAP.AccessAsApp 那一行的状态变成绿色对勾(“已为…授予”)。
03

创建一把密码约 3 分钟

  1. 左边菜单点证书和密码Certificates & secrets
  2. 客户端密码下点新客户端密码
  3. 说明BestTeam有效期选最长的那个(24 个月)
  4. 添加

列表中会出现一行,其中两列很容易混淆:

(Value)
要的是这一列:一长串包含字母、数字和符号的字符
密码 ID (Secret ID)
不是这一列。它的形状与前面那些 ID 相似,填错会一直提示“密码错误”
那串“值”只显示一次,页面刷新后无法再查看,请立即复制到记事本里。同时把“过期时间”那一列的日期也记下来,后面有一节专门说明。
完成标志记事本里有一长串密码,以及一个到期日期。
04

把邮箱开放给它约 15 分钟 · PowerShell

前三步都在网页上操作,这一步需要在 Windows 的 PowerShell 里执行几条命令。您只需复制粘贴。

还需要再取一串值。回到 entra.microsoft.com:左边菜单 应用程序 → 企业应用程序Enterprise applications)→ 搜索 BestTeam → 点进去 → 记下对象 ID

⚠️ 这里最容易出错。第 1 步那个“应用注册”页面上也有一个“对象 ID”,那一个是错的。必须取企业应用程序里的这一个。两个页面非常相似,请看清左边菜单。
把记下来的值填在这里 · 下面的命令会自动替换

请不要在这里填第 3 步那串密码。本页面用不到它,密码只填进 BestTeam。这几项仅保存在您本机的浏览器中,不会传给任何人。

打开 PowerShell:点击开始菜单,输入 PowerShell,在结果上点右键,选以管理员身份运行。然后逐条粘贴,一条执行完再执行下一条。

1安装 Exchange 管理工具(只有第一次需要,约 2–3 分钟)
Install-Module -Name ExchangeOnlineManagement -Scope CurrentUser -Force
2登录(会弹出浏览器窗口,用管理员账号登录)
Connect-ExchangeOnline -UserPrincipalName admin@公司域名.com
3让 Exchange 认识这个应用
New-ServicePrincipal -AppId <应用程序ID> -ServiceId <对象ID> -DisplayName "BestTeam"
4把这一个邮箱开放给它
Add-MailboxPermission -Identity <邮箱地址> -User <对象ID> -AccessRights FullAccess
第 3 条如果提示“已存在”(already exists),属于正常:有些租户会自动创建,跳过它直接执行第 4 条。
第 1 条如果提示执行策略不允许,先执行 Set-ExecutionPolicy -Scope Process -ExecutionPolicy RemoteSigned,再重试。
完成标志第 3、4 条各输出一行结果,没有红色报错文字
05

限定它只能访问这一个邮箱约 5 分钟 · 强烈建议

到上一步为止,这个应用理论上能访问贵公司所有邮箱。这一步给它加一道锁,让它只能访问指定的那一个。在同一个 PowerShell 窗口里继续:

5加锁:只允许访问这一个邮箱
New-ApplicationAccessPolicy -AppId <应用程序ID> -PolicyScopeGroupId <邮箱地址> -AccessRight RestrictAccess -Description "BestTeam: this mailbox only"
6验证是否生效
Test-ApplicationAccessPolicy -Identity <邮箱地址> -AppId <应用程序ID>
7完成,断开连接
Disconnect-ExchangeOnline

第 6 条的结果中应出现 AccessCheckResult : Granted。若要验证其它邮箱确实进不去,把第 6 条里的地址换成公司另一个邮箱再执行一次,应出现 Denied

这道锁不会立即生效,Microsoft 那边最长可能需要一小时才同步完成。因此紧接着测试连接如果失败,请先不要改动其它设置,稍等片刻再试。
完成标志第 6 条对目标邮箱返回 Granted

最后:在 BestTeam 里填进去

在组建团队的过程中,走到“连接邮箱”这一步:

邮箱类型
Microsoft 365 / Outlook(Exchange Online)。选定后,服务器和端口等字段会自动隐藏,无需填写,M365 的取值是固定的。
邮箱地址
要连接的那个邮箱
目录(租户)ID
第 1 步记的那串
应用程序(客户端)ID
第 1 步记的那串
客户端密码
第 3 步那串
密码到期日
第 3 步记的那个日期
“密码到期日”虽然是选填,但请务必填写。填写后,系统会在到期前一个月提醒;不填的话,到期当天邮箱会突然停止工作,而报错与“密码填错”看上去完全一样。

然后点测试连接,出现“连接正常。”之后,点连接邮箱

连接失败时

报错信息会直接指出是哪一步没有完成,以下四种情况的处理方式各不相同。

报错中提到说明回到哪一步
应用程序(客户端) ID / 客户端密码密码有误。最常见的是把“密码 ID”当成“”填了第 3 步,重新生成一把
目录(租户) ID租户 ID 填写有误第 1 步,回概述页重新复制
IMAP.AccessAsApp
Add-MailboxPermission
密码正确,但邮箱尚未开放给它第 2 步(绿色对勾)和第 4 步
找不到这个邮箱地址地址拼写有误,或该邮箱不在此租户内核对邮箱地址

第三种最常见:密码正确但邮箱尚未开放,看上去像是连不上,实际是漏了第 2 步的管理员同意或第 4 步。尝试两次仍不成功,请停下来邮件联系 admin@bestteam.online,把报错原样截图发过来。

它能做什么,不能做什么

能做

  • 读取这一个邮箱的邮件,包括附件里的文字
  • 草稿箱里创建回复草稿

不能做

  • 不能发送邮件,产品里没有这个功能
  • 接触不到公司其他邮箱,这正是第 5 步那道锁的作用
  • 不能登录贵公司的 Microsoft 365,不能修改设置或查看文件
  • 无法识别图片里的文字,拍照的发票、扫描件对它而言是空白的

密码在我们服务器上以加密形式保存,解密用的钥匙不放在数据库里。

约两年后需要更换一次密码

第 3 步创建的那把密码有有效期(最长 24 个月)。到期当天,邮箱会突然停止自动处理,而报错与“密码填错”看上去完全一样。

做法:到期前回到第 3 步创建一把新的(旧的可以先保留),把新的“值”填进 BestTeam 的“连接邮箱”,点重新连接。第 1、2、4、5 步都不需要重做。

只要填了“密码到期日”,系统会在到期前一个月提醒,无需自己记。

随时可以撤销

撤销不影响贵公司正常收发邮件,也不会删除任何已生成的草稿。

遇到问题请直接邮件联系 admin@bestteam.online,把屏幕上的报错原样截图发过来即可。不必自己判断原因,那句提示对我们来说信息量很大。