邮件推送

邮件推送是一项只负责发信的邮件服务。你的应用通过 SMTP 或 HTTP API 发送邮件：注册确认、密码重置、收据、告警（交易邮件），或者新闻通讯、促销活动（营销邮件）。Yeap Cloud 会用你域名的 DKIM 为每封邮件签名，完成投递，处理退信和投诉，并把每一步以事件的形式反馈给你。

在控制台中，它位于左侧导航 邮件 分组下的 邮件推送（/tm/streams）。

#核心概念

#套餐

撰写本文时提供以下套餐。当前价格和限额以控制台 新建发信流 对话框中显示的为准。

• 免费版发信量 由信用等级决定：Lv1 每月 100 封，Lv6 最高 3,000 封。每个账号只能有一个免费发信流。付费版不享受这部分等级额度，而是包含上表中的邮件量。
• 付费版每小时上限 等于套餐数值乘以等级系数：Lv1 ×0.5、Lv2 ×0.75、Lv3 ×1、Lv4 ×1.25、Lv5 ×1.5、Lv6 ×2。
• 按年付费 价格为月价的 10 倍（每年 ¥390、¥1,290、¥4,990），相当于免费送两个月。
• 一封邮件 = 一个收件人。 一封发给三个收件人的邮件，在每月邮件量和每小时上限中都按三封计算。
• 超量 按每 1,000 封计费，不足 1,000 封按 1,000 封计。每个付费套餐对未支付的超量费用设有消费上限（¥200、¥1,000、¥5,000）。达到上限后会停止发信，直到你支付超量账单。详见限额、沙箱与合规。
• 免费版从沙箱开始，账号达到 Lv2 后解除；付费套餐不进沙箱。

#信用等级

你的账号有一个 Lv0 到 Lv6 的信用等级，新账号从 Lv1 开始。免费版中，等级决定每月发信量和每小时上限。付费版中，等级决定每小时上限的倍率，营销发信流需要 Lv2 及以上，Lv5 和 Lv6 的自动暂停阈值也会稍宽松一些。Lv0 的账号无法发信。等级每天评估一次，随着账号使用时间增长、成功送达的邮件增多、退信率和投诉率保持在低水平，每次提升一级。达到 Lv2 只需：账号邮箱已验证、有一个已验证的发信域名、账号注册满 7 天。每次自动暂停会使等级降一级，发送病毒则直接降到 Lv0。

邮件推送 页面上的 信用等级 卡片会显示你当前的等级、本月免费额度的使用情况（免费版）以及升到下一级的条件。完整表格见限额、沙箱与合规。

#快速开始

1. 打开 邮件推送，点击 新建发信流。

2. 选择套餐，填写 名称（例如 my-app），并选择 类型：交易邮件 或 营销邮件。营销邮件仅付费版可选，且账号信用等级需达到 Lv2 及以上才能发送。如果套餐提供多个计费周期，在 计费周期 中选择一个。

3. 点击 加入购物车，在结算页完成支付。支付完成后，发信流会出现在列表中。

4. 打开发信流，进入 发信域名 标签页，点击 添加域名。填写你要用来发信的域名，例如 example.com 或 mail.example.com。

5. 在弹出的 DNS 面板中添加记录。如果域名托管在 Yeap Cloud DNS，点击 一键添加；否则请到你的 DNS 服务商处添加。详见发信域名与 DNS。

6. 点击 验证。DKIM 记录生效后，域名会显示 已验证。

7. 进入 API 密钥 标签页，点击 创建密钥，填写名称并复制密钥。密钥只显示一次。

8. 发送一封测试邮件：

   bashCopy

   curl -X POST https://api.tm.yeapcloud.net/v1/send \
     -H "Authorization: Bearer ytm_your_api_key" \
     -H "Content-Type: application/json" \
     -d '{
       "from": "Example <noreply@example.com>",
       "to": "you@example.com",
       "subject": "Hello from Yeap Cloud",
       "text": "It works."
     }'

9. 打开 发送记录 标签页，查看邮件从 排队中 变为 已送达。

#发信流页面

在列表中点击发信流即可打开。根据发信流的不同，会显示以下标签页：

#发信流状态

#下一步

• 发信域名与 DNS：添加并验证用于发信的域名。
• SMTP 与 HTTP API：接入你的应用并发送邮件。
• 事件与 Webhook：跟踪投递情况，并在你的服务器上接收事件。
• 抑制名单与退订：管理哪些人不再收信，以及退订如何生效。
• 限额、沙箱与合规：信用等级、发信限额、超量、自动暂停和发信政策。