iMessage 推广中台

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

发送看板导入号码

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

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

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

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

0号码库总数

0已建批次

0排队待发

0已发送

0点击 · —

0失败 · —

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

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

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

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

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

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

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

回传示例

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

event	含义 · 谁会回传
`sent`	已发出（AppleScript 发送成功）
`delivered`	送达回执（chat.db 的 date_delivered）
`read`	已读回执（对方开启已读回执才有）
`reply`	对方回复了
`click`	点了正文里的追踪短链
`failed`	失败（含 chat.db 的 error 码）

iMessage 推广中台

先把号码导进来

准备发送内容

点发送，然后看结果

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

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