단건 알림 운영 접수 상태
운영 단건 알림 발송 연결이 준비되지 않아 신규 접수를 사용할 수 없습니다. 테스트 키의 모의 실행과 기존 접수 조회는 가능합니다.
캠페인 발송과 단건 알림은 준비 상태가 다를 수 있습니다. 503 Errors.Messages.Unavailable이면 발신 주소를 바꿔 반복하지 말고 연결 상태를 확인하세요.
수신자 필드(정보항목)부터 준비하세요
기본 이름·이메일은 name·email로 바로 입력합니다. phone(연락처), memo(메모), 회사명·직함 및 customFields는 주소록의 ‘필드(정보항목)’에서 먼저 등록해야 합니다. 문서에 필드가 있어도 이 계정에 등록되지 않은 값은 테스트·운영 모두 400으로 거절합니다.
API로 준비하려면 GET /address-books/custom-fields로 조회하고 POST /address-books/custom-fields에 {"name":"연락처","code":"{{phone}}","type":"text"} 또는 {"name":"메모","code":"{{memo}}","type":"text"}를 전송하세요. custom_fields:write 권한이 필요하며 테스트 키의 항목은 해당 키에만 등록됩니다.
POST /subscribers는 subscribers 배열로 등록합니다. PATCH는 { "emails": ["reader@example.test"], "status": "unsubscribed" }, DELETE는 { "emails": ["reader@example.test"] }로 요청합니다. 두 메서드는 subscribers 배열을 등록 요청으로 처리하지 않습니다.
샘플 데이터로 바로 시작하세요
새 테스트 키에는 그룹·수신자·캠페인 ID 1, 활성 자동화 ID 1과 작성 중 자동화 ID 2가 준비되어 있습니다. 데이터는 키마다 분리되며 최대 수신자 2,000명·저장 공간 5MiB를 사용할 수 있습니다. 실제 메일과 외부 웹훅은 전송되지 않습니다.
외부 서비스로 결과 받기
공개 HTTPS 주소(443 포트)를 등록하면 발송 결과와 수신자 변경을 아래 7가지 이벤트로 받을 수 있습니다. 생성할 때 제공되는 서명 비밀값은 서버에 저장하세요. 테스트 환경에서는 외부로 전송하지 않습니다.
- send.completed
- 메일 발송 완료
- send.failed
- 메일 발송 실패
- subscriber.created
- 수신자 등록
- subscriber.updated
- 수신자 정보 변경
- subscriber.unsubscribed
- 구독 취소
- subscriber.resubscribed
- 재구독
- subscriber.deleted
- 수신자 삭제
- 서명 확인
- X-EZSENDER-Signature: t=시간,v1=서명
- HMAC-SHA256(secret, t + '.' + 가공 전 요청 본문)을 timingSafeEqual 같은 상수 시간 비교 함수로 확인합니다. 수신 시각과 5분 이내인지도 확인하세요.
- 재시도와 중복 처리
- X-EZSENDER-Event-Id로 중복 이벤트를 구분합니다. 10초 내 선택한 확인 방식으로 성공이 확인되지 않으면 30초부터 간격을 늘려 최대 8회 시도합니다. 전달 기록은 30일 보관합니다.
send.completed와 send.failed의 data.sendJob.subject는 접수 당시 저장한 기본 이메일 제목입니다. 일반 발송은 variantSubjects: null, A/B는 variantSubjects: {a, b}로 버전별 제목도 받습니다. A/B의 기본 제목을 승자 제목으로 해석하지 마세요. 과거 이벤트 본문은 유지되므로 제목이 없다면 발송 작업 조회 API를 사용하세요. 저장 당시 제목을 알 수 없으면 null입니다.
결과 이벤트 예시
{
"id": "2d59cd78-69d6-451b-a359-c061c59bfc43",
"type": "send.completed",
"createdAt": "2026-12-01T00:02:00.000Z",
"data": {
"sendJob": {
"id": "a112ac74-6e95-4b56-99a4-6fe16f2a8140",
"campaignId": 10,
"subject": "12월 이지센더 소식",
"variantSubjects": null,
"status": "completed",
"scheduledAt": "2026-12-01T00:00:00.000Z",
"recipientCount": 120,
"successCount": 120,
"failureCount": 0,
"completedAt": "2026-12-01T00:02:00.000Z"
}
}
}