手冊 · Resend
用 agent 打 Resend Broadcast 草稿 — 你先撳 Send
用 API 建草稿(主旨、HTML、Segment)。你睇完先寄。
2026-10-16
一句承諾
用 Resend Broadcasts API 讓 agent 只建草稿(主旨、HTML、Segment)——之後 你 睇完先喺 Dashboard 撳 Send(或者自己跑 send)。預設 send: false。未睇完就唔好 send: true。Send 你自己撳。
適合/唔適合
| 適合 | 唔適合 |
|---|---|
| 已有/將有驗證 domain + Contacts/Segments(見 Resend 雙語電子報)嘅你 | 買名單冷電郵(要合法同意——你核對) |
| 「bot 打稿+API 建 draft、你控 Send」節奏 | 當呢頁係 PDPO/法律意見,或者承諾 open rate |
想用 {{{contact.*}}} 個人化同 unsubscribe token | 唔係電子報、而係一次性交易電郵 |
Stack
- Broadcasts API:create draft(
send預設 false)→ 之後先 Send(send-with-api) POST /broadcasts/POST /broadcasts/{id}/send(create、send)- Segments(+可選 Topics)+已驗證 domain+API key
- 補篇:Resend 雙語電子報(Dashboard 為主嘅入門)
- Cancel/Duplicate、CLI、MCP 留喺之後先用。呢篇停喺你要覆核嘅草稿。
Bot vs 你
| Bot | 你(human) |
|---|---|
| 打期號稿、HTML、建議 Segment/Topic | 管 Resend 帳、domain、DNS、API key(唔貼 chat/git) |
| create draft only(唔 send) | Dashboard 覆核/test;自己撳 Send 或自己跑 /send |
標 STOP 喺 send: true 之前 | 你睇完先 Send |
| 唔會用你名義 blast | 真訂閱者首次寄出要明確 OK |
步驟
- 前置:驗證 domain、API key 入 env、Segment 入咗有同意嘅 Contact(docs、Contacts)。
- 揀 Send 路徑:A API draft → Dashboard Send(ICP 首選);B API draft → 你自己 call
/send。Dashboard editor 建嘅 Broadcast 唔可以用 API send endpoint(send-with-api)。 - Create 只建草稿:
segment_id、from、subject、html/text;可選name、reply_to、topic_id。省略 `send` 或 `false`(create-broadcast)。 - 個人化:
{{{contact.first_name|there}}};保留{{{RESEND_UNSUBSCRIBE_URL}}}。雙語跟 newsletter 篇 A/B。 - 你覆核草稿、test、對 Segment 人數同連結。
- STOP — 你先 Send: Dashboard Send/schedule,或
POST …/send(可選scheduled_at)。send: true建即寄——bot 通宵唔准用。Send 你自己撳。 - 寄完先用 Dashboard 真實數字覆盤。
失敗模式/注意
- 誤設
send: true→ 真寄出。 - Dashboard 草稿想用 API send → 唔得;要 API create。
- 錯 Segment/漏 Topic → 寄錯人。
- Key 入 git/chat → rotate。
- 同意/退訂/PDPO:唔係法律意見,你核對。
- 內容入 Payment Link → 你睇完先 Send。
Newsletter CTA
你睇完草稿先寄。
你必須核對
同上 EN「Human must verify」清單 1–9。
引用文件
- Compose and send Broadcasts with the API · 2026-10-16
- Create Broadcast API · 2026-10-16
- Send Broadcast API · 2026-10-16
- Sending Broadcasts (introduction) · 2026-10-16
- Contacts / Audiences introduction · 2026-10-16
- Resend docs home · 2026-10-16