邮件推广中台

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

发送看板导入号码

第一次用？从第 1 步开始（你还没导入号码）

这套系统就干一件事：把广告发到一批手机号 / 邮箱上，然后看谁点了、谁注册了、谁付钱了。
别被名词吓到，照着下面三步点就行 —— 每一步点完，回来这页数字就会变。

1
先把号码导进来
你手里那些手机号 / 邮箱，复制粘贴进来，系统自动认运营商、归属地、是不是有效号。
去导入号码
2
准备发送内容
系统会按号码库自动生成每个收件人专属的正文（带追踪链接），你只要给一段文案。
看对接说明
3
点发送，然后看结果
在设置里配好邮箱，服务端直接帮你发。
去配置发信

看不懂某个词？往下翻有「名词小抄」，每个词都用大白话解释了一遍。

0号码库总数

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 自动记）

邮件推广中台

先把号码导进来

准备发送内容

点发送，然后看结果

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

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