개인화 푸시 전송불가 유저 웹훅

🔔 최신화 일자: 2025-10-15

팁

• nachocode에서는 만료, 앱 삭제 등의 이유로 사용 불가한 토큰 정보를 nachocode 저장소에서 제거합니다.
  차감 수 관리 및 네트워크 효율을 위해 웹훅을 통한 푸시 알림이 전송 불가한 앱 유저에 대한 관리가 권장됩니다.

노트

• 전송불가 유저 웹훅 등록 후, v2 버전 이상의 개인화 푸시 알림 전송 시 웹훅이 발송됩니다.
  ([POST]/api/push/v2/messages,[POST]/api/push/v2/users)

• 모든 유저에게 정상적으로 푸시가 발송되었을 경우에는 웹훅이 발송되지 않습니다.

전송불가 유저 이벤트 타입 정의

UnavailableUsersEvent

declare interface UnavailableUsersEvent {
  tokenNotFoundUserIds: string[];
  tokenInvalidUserIds: string[];
}

속성명	타입	필수 여부	설명
tokenNotFoundUserIds	string[]	✅	등록된 토큰이 없는 유저ID 목록
tokenInvalidUserIds	string[]	✅	만료, 앱 삭제 등의 이유로 사용 불가한 토큰을 보유한 유저ID 목록

---

요청 본문 예시

{
  "tokenNotFoundUserIds": ["userId1", "userId2", ...], // 토큰을 보유하지 않은 유저가 없을 경우 빈 배열
  "tokenInvalidUserIds": ["userId3", "userId4", ...], // 유효하지 않은 토큰을 보유한 유저가 없을 경우 빈 배열
}