了解邮件产品
了解发信身份、请求受理、投递事件与运维责任。
邮件产品 提供邮件发送能力。企业接入通常从发信域名和身份验证开始，再选择 API、SMTP 或控制台活动发送，并通过发送记录与事件通知确认最终结果。
受理与送达是两个阶段
API 成功响应只表示平台接受请求。邮件可能在后续模板、路由、抑制或收件方处理阶段失败；请以发送记录和事件为准。
开始前的准备
- 在控制台创建并验证发信域名及发件邮箱。
- 准备 API Key、授权出口 IP 和服务端密钥管理方式。
- 明确营销或事务邮件用途，以及退订和抑制要求。
发送链路
| 阶段 | 你需要确认的事项 |
|---|---|
| 身份 | 发件域名、DNS 记录、发件邮箱和 API Key 均已就绪。 |
| 受理 | API 返回版本对应的成功状态；为重试保留同一幂等键和请求体。 |
| 处理 | 模板、路由、配额、抑制名单与通道可能影响后续结果。 |
| 结果 | 查询完整 Message ID 的发送记录；Webhook 用于及时接收事件。 |
运维与故障恢复
对每个业务任务保存幂等键、请求标识和 Message ID。对超时或 5xx 先核对原任务，不要换键盲目重发。Webhook 当前每个事件只投递一次，没有自动重试或补发；接收端应先持久化、按 eventId 去重，并定期与发送记录对账。客户控制台暂不提供 Webhook 投递日志或重放入口。
常见问题
API 受理成功后为何仍可能失败？
受理仅开始后续处理；模板、发件域名、抑制、通道及收件方都可能产生失败或退信。
应从哪里开始？
先阅读“开始使用”的快速接入；具体能力在本指南中按任务查找，接口字段和在线调试则进入 API 参考。
相关资源
最后更新于