스마트 발송 - send-bulk-message 호출 시 알림 미동의/철회 유저 자동 필터링 여부

개발
1

이 글의 성격은 무엇인가요?

질문 / 문제 해결

내용을 설명해주세요

정기 발송 유형(매일 동일 시각)의 기능성 메시지를 알림 동의문과 함께 운영 중입니다.
파트너 서버에서 send-bulk-message API로 발송할 때, contextList에 담긴 userKey 중

  • 아직 requestNotificationAgreement로 동의하지 않은 유저
  • 또는 동의 후 토스 앱에서 알림 수신을 철회한 유저
    가 포함된 경우, 토스 서버가 발송 단계에서 이들을 자동으로 제외(스킵)하나요?

[배경 / 알고 싶은 핵심]

  • requestNotificationAgreement의 동의 결과(newAgreement/alreadyAgreed/agreementRejected)는
    클라이언트 onEvent로만 전달되고, 파트너 서버로는 자동 전달되지 않는 것으로 이해했습니다.
  • 그렇다면 "현재 이 userKey가 알림 동의 상태인지"를 파트너 서버가 알 방법이 있는지,
    아니면 토스가 발송 시점에 알아서 거르므로 파트너는 신경 안 써도 되는지 확인하고 싶습니다.
  • send-bulk-message 응답의 fail 배열에 "미동의로 인한 실패"가 구분되어 내려오는지도
    궁금합니다. (reachedFailReason 등으로 식별 가능한지)

[개발 환경]

  • 서버: Spring Boot (파트너 서버에서 mTLS로 직접 호출)
  • 발송 API: /api-partner/v1/apps-in-toss/messenger/send-bulk-message
  • 메시지 유형: 기능성 / 정기 발송(매일), 알림 동의문 등록 완료 후 검수 중
2

안녕하세요 :slight_smile:
userKey별 requestNotificationAgreement 호출 결과를 파트너사 서버로 전달하여 저장해주시면 대량 메시지 발송시 처리가 가능하실 것 같아요.
토스 서버에서 발송할때 알림 동의 상태가 아니라면, 자동으로 스킵됩니다.

현재는 미동의로 인한 발송 실패라도 별도로 응답에 내려드리고 있진 않은 점 참고부탁드립니다.