e-blast-newsletter

Resend Email

Resend 하나로 트랜잭셔널 메일 + 뉴스레터(브로드캐스트)를 처리한다. Free 티어: $0, 월 3,000통, 일 100통, 도메인 1개 — 소규모 뉴스레터는 무료로 충분하다. (검증: resend.com/pricing, 2026-07-16)

Hard rules

1. 발송은 유저 게이트 — "작성해줘"는 발송 승인이 아니다. 브로드캐스트는 반드시 초안 상태로 만들어 유저 확인 후 send.
2. 브로드캐스트에는 {{{RESEND_UNSUBSCRIBE_URL}}} 필수 — 수신거부 링크 없는 마케팅 메일은 스팸법 위반(CAN-SPAM/개인정보보호법).
3. 본발송 전 셀프 테스트 — 자기 주소로 1통 보내 렌더링/링크/머지태그 확인.
4. 일 100통 제한(Free) — 100명 넘는 리스트는 일 단위 분할 또는 Pro($20/mo, 5만통) 업그레이드를 유저에게 안내.
5. 콜드 아웃리치 금지 — Resend는 permission 기반. 콜드메일은 별도 도메인 + 전용 툴로 (b2b-cold-email).
6. Windows에서 API 호출은 Python urllib + utf-8 (curl+cp1252 이모지 크래시).
7. 제목은 A/B 전제 — 브로드캐스트마다 제목 후보 3개(다른 축: 숫자/질문/ 직설)를 만들어 유저가 고르고, 리스트가 1,000+ 이면 오디언스를 세그먼트로 나눠 실제 A/B 발송 → 오픈율 승자를 다음 호 기본 축으로. 히어로 이미지가 있으면 image-gen 스킬로 변형 2–3개.

Setup (1회)

1. resend.com 가입 → API Keys → env RESEND_API_KEY (re_...) 저장.
2. 도메인 인증: Dashboard → Domains → Add (또는 POST /domains) → 발급된 SPF/DKIM DNS 레코드를 도메인 DNS에 추가 → Verify. from은 인증된 도메인의 주소만 가능 (뉴스레터 <[email protected]>).
3. Base https://api.resend.com, Authorization: Bearer $RESEND_API_KEY.
4. VERIFY: GET /domains 에 status "verified".

A. 트랜잭셔널 (1:1)

POST /emails
{ "from": "Acme <[email protected]>", "to": ["[email protected]"],
  "subject": "...", "html": "..." }

• 대량 개별 발송: POST /emails/batch — 한 번에 최대 100개 객체.
• reply_to, cc, bcc, attachments 지원.

B. 뉴스레터 (Audience + Broadcast)

# 1) 오디언스 생성 (리스트당 1개)
POST /audiences            { "name": "Newsletter" }

# 2) 구독자 추가
POST /audiences/{id}/contacts
{ "email": "[email protected]", "first_name": "Jane", "unsubscribed": false }

# 3) 브로드캐스트 생성 (초안)
POST /broadcasts
{ "audience_id": "aud_...",
  "from": "News <[email protected]>",
  "name": "2026-07 뉴스레터",
  "subject": "이번 달 소식",
  "html": "Hi {{{contact.first_name|there}}}, ...
           <a href='{{{RESEND_UNSUBSCRIBE_URL}}}'>수신거부</a>" }

# 4) 유저 승인 후 발송 (즉시 또는 예약)
POST /broadcasts/{id}/send            # 즉시
POST /broadcasts/{id}/send  { "scheduled_at": "2026-07-20T09:00:00+09:00" }