邮件推广中台

号码 → 建批次 → 发送 → 看结果，一条流水线

发送看板导入号码

一切正常，随时可以开下一批

当前没有排队的消息。想再发一批：导入新号码 → 建批次 → 发送，重复这个循环就行。

1
再来一批号码
导新的号码进来，重复号码会自动合并，不会重复打扰同一人。
导入号码
2
筛选精准人群
按运营商、省份、设备、号码年限、有没有邮箱来挑人，别把广告发给不相关的人。
进号码库
3
看效果
送达率、打开率、点击率一目了然，还能导出 CSV 交报表。
打开看板

1,001号码库总数

0已建批次

0排队待发

0已发送

0点击 · —

0失败 · —

数字含义：号码库是你能发给谁；批次是发过的每一次活动；排队待发是已经准备好、还没发出去的；点击是有人真的点开了你的链接。

系统状态（看不懂就只看颜色：绿色正常 / 红色要处理）

数据库	正常　所有数据都存在这里，红了说明服务器出问题，找技术。
接口钥匙（API Key）	已配置　页面之间跳转要带它，丢了就打不开看板。
发信邮箱	已配置　已经能对外发邮件了。
当前通道	邮件 Email 　两个通道数据是分开算的，别弄混。

名词小抄（遇到不懂的词，回来查这里）

号码库: 你手上所有能发的人。系统会自动标出运营商、归属地、是不是有效号、有没有邮箱。
批次（Campaign）: 一次活动的记录。比如「11 月 5 日老客户召回」，发出去的所有消息都算这一批。
任务（Message）: 一条要发出去的消息，对应一个收件人。100 个号码 + 一段文案 = 100 条任务。
排队待发: 任务已经生成好、内容也备好了，就等发送端来取走发出去。
送达: 对方的手机 / 邮箱确认收到了（不是所有人都一定会显示送达）。
打开: 邮件里的追踪像素被加载了，说明对方真的点开看了。iMessage 没有这个概念。
点击: 对方点了你正文里的链接，这是最有价值的行为，说明他感兴趣。
退订: 对方明确说不要再发了。系统会记住，之后自动跳过这个人。
回传: 发送端把「发了 / 送达了 / 失败了」这些结果报给系统，看板才能显示。
黑名单等级: 这个人被投诉 / 退订过几次。等级越高越不要发，发了容易进垃圾箱。

技术对接细节（非技术人员可以跳过，不影响使用）

步骤	具体怎么做
1 · 取收件人	POST `build.php`：传 `items` 列表，或传 `filter`（operator / province / device / source / limit）从号码库自动取号，返回成品正文 + token
2 · 发送	把 `build.php` 返回的 html 直接发；也可让服务端自己发：POST `dispatch.php`
3 · 回传	发送端把状态 POST 到 `upload.php`（匹配 token / guid / addr 任一即可）
4 · 查看	打开看板，或查数据库 `tr_message` / `tr_event`

回传示例

curl -X POST 'https://email.ytai66.cc/upload.php' \
  -H 'Content-Type: application/json' \
  -H 'X-Api-Key: <你的API Key>' \
  -d '{
    "channel": "email",
    "items": [
      { "token": "<build 返回的 token>",
        "event": "open",
        "at": "2026-11-05 10:00:00" }
    ]
  }'

event	含义 · 谁会回传
`sent`	SMTP 已接收
`delivered`	对方服务器已接收
`open`	打开像素（open.php 自动记）
`click`	点击链接（click.php 自动记）
`bounce`	退信
`unsub`	退订（unsub.php 自动记）

邮件推广中台

再来一批号码

筛选精准人群

看效果

系统状态（看不懂就只看颜色：绿色正常 / 红色要处理）

名词小抄（遇到不懂的词，回来查这里）