이메일 페이로드 참조

이메일을 보낼 때 Notify에서 사용하는 EmailPayload 메시지에 대한 참조입니다.

EmailPayload

subject (map<string, string>): 로캘을 키로 사용하는 제목 줄입니다. 예: {"en": "Hello!", "es": "¡Hola!"}.
body (string): 이메일의 HTML 본문입니다. 로캘별 HTML 본문을 사용하려면 Control Panel에서 구성된 이메일 템플릿과 함께 email_template을 사용하세요.
attachments (배열 Attachment): 파일 첨부입니다.
list_unsubscribe (string): List-Unsubscribe 헤더에 대한 사용자 지정 URL입니다.
from (Address): 앱의 이메일 설정에서 구성된 기본 From을 재정의합니다.
reply_to (Address): 앱의 이메일 설정에서 구성된 기본 Reply-To를 재정의합니다.
email_template (string): 인라인 body 대신 사용할 이메일 템플릿의 코드입니다.
email_sunset_policy (EmailSunsetPolicy): 프로젝트의 선셋 정책이 이 이메일에 적용되는 방식입니다. 생략하면 정책이 적용됩니다.

EmailSunsetPolicy

mode는 프로젝트에 선셋 정책이 켜져 있는 경우에만 적용됩니다. 정책은 기본적으로 켜져 있지 않으며, 켜기 전까지는 두 모드 모두 모든 연락처에게 발송합니다.

{
  "mode": "EMAIL_SUNSET_MODE_OFF"
}

`mode`	이메일을 받는 대상
`EMAIL_SUNSET_MODE_DEFAULT`	활성 연락처만: 비활성 연락처는 건너뜁니다. `email_sunset_policy`를 생략한 것과 같습니다.
`EMAIL_SUNSET_MODE_OFF`	비활성 연락처를 포함한 모든 연락처. 모든 사람에게 도달해야 하는 중요한 마케팅 이메일에 사용합니다.

선셋 정책은 마케팅 이메일에만 적용되므로 email_sunset_policy는 트랜잭션 이메일에 영향을 주지 않습니다.

Attachment

{
  "name": "invoice.pdf",
  "content": "<base64-encoded bytes>"
}

Field	Type	Description
`name`	string	수신자가 보는 파일 이름입니다.
`content`	string	Base64로 인코딩된 파일 내용입니다.

Address

{
  "name":  "Pushwoosh",
  "email": "support@example.com"
}

두 필드 모두 선택 사항입니다. name이 생략되면 수신자는 원시 이메일 주소를 보게 됩니다.

예시: 세그먼트에 이메일 보내기

curl -X POST https://api.pushwoosh.com/messaging/v2/notify \
  -H "Authorization: Token YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "segment": {
      "application": "XXXXX-XXXXX",
      "platforms": ["EMAIL"],
      "code": "newsletter_subscribers",
      "email_payload": {
        "subject": { "en": "Our May updates", "es": "Novedades de mayo" },
        "email_template": "may-digest-2026",
        "from":     { "name": "Pushwoosh Team", "email": "news@example.com" },
        "reply_to": { "email": "replies@example.com" }
      },
      "schedule": { "at": "2026-05-01T09:00:00Z" },
      "message_type": "MESSAGE_TYPE_MARKETING"
    }
  }'

예시: 첨부 파일이 있는 트랜잭셔널 이메일

curl -X POST https://api.pushwoosh.com/messaging/v2/notify \
  -H "Authorization: Token YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "transactional": {
      "application": "XXXXX-XXXXX",
      "platforms": ["EMAIL"],
      "users": { "list": ["customer-42"] },
      "email_payload": {
        "subject": { "en": "Your invoice" },
        "body":    "<p>Please find your invoice attached.</p>",
        "attachments": [
          { "name": "invoice.pdf", "content": "JVBERi0xLjQKJe..." }
        ]
      },
      "schedule": { "at": "2026-05-01T12:00:00Z" },
      "message_type": "MESSAGE_TYPE_TRANSACTIONAL"
    }
  }'