이 글의 성격은 무엇인가요?
질문 / 문제 해결
내용을 설명해주세요
안녕하세요.
스마트 발송 API로 알림을 발송하고 있는데, 응답의 reachedFailReason 값을
해석하는 데 필요한 정보를 문서에서 찾지 못해 문의드립니다.
■ 연동 구성
- 사용자 식별: anonKey (토스 로그인 미사용)
- 발송: POST /api-partner/v1/apps-in-toss/messenger/send-message 단건 반복
- 템플릿: 알림 동의문이 연결된 기능성 캠페인 1종
■ 확인한 내용
2026년 8월 1일 발송에서 구독자 13명 중 8명이 성공하고 5명이 실패했습니다.
실패 사유는 TERMS_DISAGREED_MEMBER 4명, INSUFFICIENT_INFO_MEMBER 1명입니다.
두 코드의 정의를 찾기 위해 아래를 확인했습니다.
- 스마트 발송 문서에는 reachedFailReason이 "메시지 도달에 실패한 경우 실패
사유가 담겨 있어요"라는 설명으로만 있습니다.
스마트 발송 | API & SDK | 앱인토스 개발자센터 - 푸시, 알림 문서의 OpenAPI 스펙에서도 SentContentResponse의
reachedFailReason이 enum 없이 type: string으로만 정의돼 있습니다.
푸시, 알림 | API & SDK | 앱인토스 개발자센터 - 개발자센터 문서 검색에서 두 코드명으로 검색했으나 결과가 없었습니다.
■ 문의 사항
-
reachedFailReason에 담기는 실패 사유 코드의 전체 목록과 각 의미를 확인할
수 있는 자료가 있습니까? -
TERMS_DISAGREED_MEMBER와 INSUFFICIENT_INFO_MEMBER는 각각 어떤 상태를
의미합니까? 특히 INSUFFICIENT_INFO_MEMBER는 어떤 정보가 부족하다는
뜻인지 알고 싶습니다. -
두 상태는 영구적입니까, 아니면 재발송으로 해소될 수 있습니까? 해당
사용자를 발송 대상에서 영구히 제외해도 되는지 판단하려 합니다. -
미니앱 더보기 버튼 → 설정 → 알림 화면에는 '기능형 알림’과 ‘혜택·맞춤형
알림’ 두 개의 토글이 있습니다. TERMS_DISAGREED_MEMBER는 이 중 어느 토글을
끈 상태를 가리킵니까? 또한 이 미니앱별 설정과 토스 앱 전체의 알림 설정 중
어느 쪽이 반영된 값입니까? 저희는 앱 안에서 "'설정 → 알림’의 '기능형 알림’을
확인해보세요"라고 안내하고 있어, 이 안내가 두 코드 모두에 맞는지 확인이
필요합니다. -
발송 전에 수신이 가능한 대상만 추려낼 수 있는 방법이 있습니까? 식별키
검증 API(POST /api-partner/v1/apps-in-toss/users/anon-key/verify)를 구독자
전원에게 호출했으나, 발송에 실패한 5명을 포함해 전원이 유효(success: true)로
응답되어 사전 판별에는 사용할 수 없었습니다.
실패한 요청의 anonKey나 응답 원문이 필요하시면 비공개로 전달드리겠습니다.