手冊 · Segments
Resend Contacts 同 Segments — 邊個收到電子報
建 Contacts／Segments，將 segment id 交俾 Broadcast 草稿。Audiences 已過時。
2026-10-16
一句承諾
用 Resend 全域 Contacts + Segments（Audiences API 已 deprecated）讓 agent 建立／管理 Segment 同 Contact——之後把核實過嘅 segment_id 交俾 Broadcast 草稿流程。唔做 spam 名單、唔喺 chat 貼 secret key、唔 Send。
同其他篇點分
Resend 雙語電子報 負責 domain、訂閱文案、Dashboard 寄法。Resend Broadcast 草稿 負責草稿同 Send 閘。呢篇只負責名單。
| 篇 | 負責 |
|---|---|
| Resend 雙語電子報 | Domain、Dashboard 寄法、訂閱文案、雙語 Topic |
| Resend Broadcast 草稿 | Broadcast 草稿 + Send 閘 |
| Cancel 或 duplicate | Cancel／Duplicate |
| 呢篇 | Contacts + Segments CRUD；Audiences → Segments 遷移 |
適合／唔適合
| 適合 | 唔適合 |
|---|---|
| 用 Resend 做 StackQuay newsletter 嘅你 | 買名單／爬蟲名單——STOP；要同意（你核對 PDPO） |
| 「bot 建 Segment＋加已 opt-in Contact、你控同意同 Send」 | 仲死撐只寫 Audiences endpoint、又唔 plan migration |
想喺 Broadcast create 之前有乾淨 segment_id | 當呢頁係法律意見，或者承諾 deliverability |
Stack
- Contacts（全域一電郵一 Contact）+ Segments API（
POST/GET/PATCH/DELETE /segments；GET …/contacts） - Contacts membership：
POST /contacts；POST/DELETE /contacts/:id|email/segments/:segmentId - Topics（提一句）：收件人偏好；同 Segment 一齊用
- Audiences：deprecated，新 code 用 Segments（migration）
Bot vs 你
| Bot | 你（human） |
|---|---|
| 建議 Segment 名；create／list／rename；只加你批過嘅 opt-in email | 管帳同 API key（唔貼 chat／git） |
add／remove Segment membership；交 segment_id 俾 Broadcast 篇 | 核同意來源、Dashboard 人數、PDPO 文案 |
| 唔會 Send／唔會當你 blast | 真寄出跟 human-gate 篇 |
步驟
- 前置：驗證 domain、key 入 env、訂閱同意文案（見 電子報篇）。
- 模型：Audiences → Global Contacts + Segments（2025-11）；Contact 可屬多個 Segment；要入 Segment 先收到 Broadcast；
unsubscribed／Suppression 會擋寄。 - Create Segment：
POST /segments，body 係name（例如playbook-subscribers）→ 存id。可另開playbook-preview。 - List／
PATCH改名／DELETE（刪 Segment 唔刪 Contact）。 - Create Contact：
POST /contacts——只加主動 opt-in（consent KB）。 - Add／Remove：
POST／DELETE /contacts/:id|email/segments/:segmentId；List members：GET /segments/:id/contacts。 - 交俾 Broadcast 草稿（
send: false）。Send 你自己撳。 - 舊 Audiences code → 跟 migration 轉 Segments + Topics。
失敗模式／注意
- Spam／買名單 → STOP；投訴高可被停帳。PDPO：唔係法律意見，你核對。
- Key 入 chat／git → rotate。
- 錯 Segment → 寄錯人；Send 前對數。
- 刪 Segment 唔等於刪人。
- Bot 唔准 Send。
Newsletter CTA
路徑：opt-in，然後 Segment，然後草稿，然後你 Send。
你必須核對
同上 EN「Human must verify」清單 1–9。
引用文件
- Contacts introduction · 2026-10-16
- Managing Segments · 2026-10-16
- Migrating from Audiences to Segments · 2026-10-16
- Create Segment · 2026-10-16
- Create Contact · 2026-10-16
- Add Contact to a Segment · 2026-10-16
- Create Audience (deprecated) · 2026-10-16
- What counts as email consent? · 2026-10-16