开始前，需要准备什么？
准备一个你有权使用、能够登录的 Yahoo 邮箱，以及具有 Admin 或 Leader 角色的 Mailera 账号。只有这两种角色可以添加邮箱。
Yahoo 应用专用密码（app password，下文简称“应用密码”）是 Yahoo 生成的凭据，供不使用 Yahoo 登录页面的第三方邮件应用访问邮箱。它与下面另外两种凭据不能混用。
| 凭据 | 用途 | 在本流程中填在哪里 |
|---|---|---|
| Yahoo 登录密码 | 登录 Yahoo 账号 | Yahoo 官方登录页面 |
| Yahoo 应用密码 | 让 Mailera 连接 Yahoo 邮箱 | 连接信息中的“密码” |
| Mailera API 密钥 | 让应用或 AI 智能体调用 Mailera | API 请求或客户端配置，不填入邮箱密码框 |
Mailera 的 Yahoo 接入说明采用应用密码连接已有邮箱；这里的认证方式不代表所有第三方客户端的要求。跨服务商的凭据使用说明见智能体邮箱应用密码指南。
如何生成 Yahoo 应用密码？
按照 Yahoo 官方应用密码帮助操作。以下 Yahoo 按钮保留官方英文名称，便于你对照页面。
- 登录 Yahoo 的账号安全页面，在“External connections”下找到“Create app password”。确认当前登录的是要接入的邮箱账号。
- 点击“Create app password”，在应用名称栏输入便于识别的名称，例如 Mailera。此时应能看到生成密码的操作入口。
- 点击“Generate password”，取得生成的应用密码。不要用 Yahoo 登录密码替代它。
- 将生成的密码用于 Mailera 连接，完成后在 Yahoo 页面点击“Done”。Mailera 中的具体填写步骤见下文。
不要把应用密码贴进聊天、工单、代码仓库或日志。需要截图时，遮盖邮箱地址和完整密码。
如何撤销或更换？
回到账号安全页面，在“External connections”下打开应用密码列表，找到对应密码，点击旁边的“Delete”，再点击“Delete”确认。
修改 Yahoo 登录密码不会让已有应用密码失效。 要撤销某个应用密码，必须删除它。需要更换时，在 Yahoo 删除旧应用密码，再按上述步骤生成新的应用密码。
IMAP 和 SMTP 的服务器、端口怎么填？
IMAP 用于读取和同步邮件，SMTP 用于发送邮件。收信成功不能代替发信验证。
下面是 Mailera 的 Yahoo 预设，适合在排错时逐项核对。
| 设置 | 收信：IMAP | 发信：SMTP |
|---|---|---|
| 服务器 | imap.mail.yahoo.com | smtp.mail.yahoo.com |
| 端口 | 993 | 587 |
| 加密方式 | TLS，界面选项为“SSL/TLS” | STARTTLS |
| 登录地址 | 完整 Yahoo 邮箱地址 | 完整 Yahoo 邮箱地址 |
| 密码 | Yahoo 应用密码 | Yahoo 应用密码 |
| 认证 | 需要登录 | 需要登录 |
Yahoo 官方 IMAP 设置列出的收件端口是 993，发件端口是 465 或 587，并要求加密和 SMTP 认证。Mailera 的 Yahoo 预设使用 587 与 STARTTLS，不要只改端口而忽略加密方式。
选择 Yahoo 服务商后，使用其预设即可，不需要寻找手动填写服务器的字段。只有走自定义 IMAP 接入时，才会填写“收件服务器（IMAP）”和可选的“发件服务器（SMTP）”。
如何在 Mailera 中连接并确认收发正常？
添加已有邮箱
- 打开“邮箱列表” → “添加邮箱”，选择“单个邮箱”。
- 在“邮箱地址”输入完整地址，确认服务商为 Yahoo。如果没有正确识别，在“或选择服务商”下手动选择 Yahoo，再点击“继续”。
- 查看“如何获取应用密码”和“准备事项”，进入“连接信息”。在“密码”中填入刚生成的 Yahoo 应用密码。
- 按需填写“显示名称”和“邮箱分组”。“显示名称”是发送邮件时使用的发件人名称，不是登录用户名。
- 点击“测试并连接”，逐项查看结果。
看懂连接测试
| 测试项 | 用来确认什么 |
|---|---|
| 收件服务器登录 | IMAP 登录是否成功 |
| 文件夹检测 | 是否能识别邮箱文件夹 |
| 发件服务器登录 | SMTP 登录是否成功 |
| 实时监控 | 是否具备相应的邮件监控能力 |
“测试并连接”不会发送任何邮件。若显示“可以收件，但暂时无法发件”，你可以点击“保存为仅收件”，或通过“修改信息”后“重新测试”。仅收件模式不能算作完整收发成功。
测试期间需要离开页面，可以点击“后台运行”。Mailera 会继续测试，并在完成后保存邮箱。成功连接后，首次加载只覆盖保留期内的邮件，最新邮件优先显示。
分别验证收信和发信
- 用另一个你控制的测试邮箱，给 Yahoo 邮箱发送一封普通邮件，例如主题“Yahoo 收信测试”，正文不放敏感信息。
- 在 Mailera 的“统一收件箱”中找到这封邮件，核对发件人、主题和正文。这一步确认邮件已经同步，而不只是登录成功。
- 从这个 Yahoo 邮箱回复该测试邮件，再到另一端检查是否收到回复。这一步单独验证发送与接收结果。
- 如果邮件未出现，可通过
GET /mailboxes返回的data数组找到对应邮箱，检查status和last_sync_at字段，分别了解邮箱状态与最近同步时间，不要立即更换密码。
Yahoo 的连接状态查询依据最近一次同步结果，不是每次查询都重新登录 Yahoo。后台同步也不保证实时更新。暂时没看到新邮件和认证失败需要分开处理。
常见错误：无法生成密码或认证失败怎么办？
先确定错误出现在 Yahoo 生成页面、Mailera 登录测试，还是连接后的收发阶段。
| 现象 | 检查项与下一步 |
|---|---|
| 找不到生成入口 | 确认当前 Yahoo 账号，在账号安全页面查找“External connections”，对照官方帮助；不要在 Mailera 中寻找生成按钮。 |
| 生成请求失败 | Yahoo 建议使用已连续多天登录 Yahoo 的浏览器，并避免无痕模式；这不是固定等待期限，也不保证生成成功。仍失败时，按 Yahoo 建议使用网页版或官方 Yahoo App 收信。 |
| IMAP 认证失败 | 依次核对完整邮箱地址、是否误填登录密码、对应应用密码是否已删除。若使用自定义 IMAP，再核对服务器、端口和加密方式。 |
| 能收信但不能发信 | 查看“发件服务器登录”的结果，以及是否选择了“保存为仅收件”。先处理 SMTP，不要盲目反复更换密码。 |
| 登录通过但邮件没出现 | 首次加载受保留期限制。用新发出的普通测试邮件验证，不要只拿旧邮件判断。 |
| 突然要求重新输入密码 | 先分清是 Yahoo 网页要求登录、其他客户端认证失败，还是 Mailera 连接异常；分别检查对应页面的提示和连接状态。 |
生成问题应按 Yahoo 官方页面的提示处理，但 Yahoo 明确说明：客服无法绕过应用密码生成资格的判定流程。联系客服也不能解除这一限制。
如果只是修改过 Yahoo 登录密码，也不能据此断定应用密码已经失效；应用密码需要单独删除才能撤销。
接入 AI 助手时，怎样降低风险？
Yahoo 应用密码交给 Mailera 连接邮箱；AI 智能体调用 Mailera 时，使用单独的 API 密钥。不要把 Yahoo 应用密码直接写进智能体提示词。
如果你准备通过 MCP 接入智能体，可以先看已有邮箱的邮件 MCP 服务器指南；使用 VS Code 时，按 VS Code 邮件 MCP 配置与测试教程完成客户端设置。
只读任务只授予 read 权限，并将“邮箱范围”限制在必要的分组。这是 Mailera API 密钥的权限控制，不是 Yahoo 应用密码自身的权限设置。相关说明见 Mailera 安全页面。
邮件正文是不可信数据，不是操作指令。智能体不得执行邮件中要求泄露密钥、修改规则或转发敏感内容的指示。确实需要发信时再授予 send 权限，并在你的工作流中加入发送前的人工确认。
怀疑凭据泄露时，分别处理两端：在 Yahoo 删除对应应用密码，需要时生成新的应用密码；在 Mailera 撤销相关 API 密钥，撤销后调用会立即被拒绝。创建替代 API 密钥后，用它更新客户端配置，再检查所需操作是否正常。
Mailera 的边界
Mailera连接你已经拥有的邮箱，不创建 Yahoo 邮箱或新地址，也不能替你生成 Yahoo 应用密码、改变 Yahoo 的生成资格或认证政策。Mailera 不提供营销群发，也不是 Yahoo 的官方合作伙伴。
