브랜드 메시지 기본형/자유형 관련 문의

문의|Support
1

안녕하세요. 브랜드메시지 관련 문의드립니다.

  1. M / N 타겟팅을 열려면 무엇이 필요한가요?

비즈고 콘솔(브랜드 메시지 발송)에서 수신자 타겟팅을 보니 M과 N은 회색으로 비활성이고 I만 선택 가능합니다. API로 M, N을 보내도 아래 오류가 돌아옵니다.

reportCode 61028 “해당 타겟팅 옵션 사용할 수 없음 (Not register unsubscribe content)”

무료수신거부 정보(unSubscribeContent) 등록만 하면 열리나요? 아니면 "발송 대상 확장 신청"도 필요한가요? 신청 방법과 소요 기간을 알려주세요.
unsubscribePhoneNumber는 080 번호만 되나요? 저희가 직접 개설해야 하는지, 공용으로 쓸 수 있는 번호가 있는지 궁금합니다.

  1. "카카오톡 수신동의"는 어떻게 확인·수집되나요?

콘솔 안내를 보니 M/N/I 모두 "브랜드 마수동 유저(카카오톡 수신동의)"가 전제인 것으로 이해했습니다.

이 수신동의는 카카오 채널을 추가할 때 자동으로 잡히는 것인가요, 아니면 별도로 받아야 하는 것인가요?
저희(고객사)가 자체적으로 받은 마케팅 수신동의와는 별개인가요?
특정 번호가 수신동의 상태인지 조회할 수 있는 방법이 있나요? (발송 전에 실제 도달 가능한 인원을 가늠하고 싶습니다)

  1. 자유형(free)에서도 M, N을 쓸 수 있나요?

문서 "브랜드 메시지 상품 구조"에는 자유형이 "타겟팅을 지정할 수 없으며 채널 친구 대상에게만 발송 가능"으로 적혀 있습니다. 그런데 실제로는 타겟팅 값이 거부되지 않고 61028(무료수신거부 미등록)이 옵니다.

조건을 갖추면 자유형에서도 M, N이 가능한 것인지, 아니면 기본형(basic)에서만 가능한 것인지 알고 싶습니다.

  1. 기본형과 자유형의 차이를 정리해주실 수 있을까요?

발송 대상 / 사용 가능한 버튼 / 첨부 / 동보 발송 / 요금 등 기준으로 정리해주시면 감사하겠습니다.

  1. 채널 추가(AC) 버튼이 자유형에서도 되나요?

문서 버튼 표에는 AC가 "알림톡, 브랜드메시지 기본형"으로만 되어 있는데, 자유형에 넣어 보내니 접수·발송 모두 성공(10000)했습니다. 다만 수신 폰에는 버튼이 보이지 않았습니다. (수신자가 이미 채널 친구라 숨겨진 건지, 자유형이라 무시된 건지 모르겠습니다)

지원되지 않는 것이라면, 오류 없이 성공 처리되는 게 맞는지도 궁금합니다.

  1. 이미지 사전 등록 — 저희가 확인한 내용부터 말씀드립니다

저희 자체 저장소(S3) 이미지 URL을 그대로 넣어 발송했더니 아래 오류가 돌아왔습니다.

reportCode 63024 “메시지에 포함된 이미지를 전송할 수 없음 (MessageInvalidImageException)”

POST /api/comm/v1/file/BRANDMESSAGE/default 와 /wide 로 먼저 올리니 둘 다 A000 Success로 imgUrl이 발급됐고, 그 주소로 보내니 정상 수신됐습니다. 사전 등록이 필수인 것으로 이해했습니다.

(1) 발급된 imgUrl에 유효기간이 있나요?

공통 “이미지 업로드” 문서의 응답 표에는 imgUrl·fileKey·media·expired가 함께 적혀 있는데, 브랜드메시지 업로드 실제 응답에는 imgUrl만 오고 expired는 오지 않습니다.

  • expired는 MMS fileKey 전용인가요?
  • 유효기간이 있다면 얼마이고, 응답에 값이 없는 상태에서 만료 여부는 어떻게 알 수 있나요?
  • 유효기간이 지난 뒤 그 imgUrl로 발송하면 오류가 오나요, 아니면 성공 처리되고 이미지만 안 보이나요?

(2) 같은 이미지를 여러 번 재사용해도 되나요?

아니면 발송할 때마다 새로 업로드하는 것이 권장되나요?
저희는 지금 발송 직전에 올려서 쓰고, 같은 이미지는 짧은 시간 동안만 재사용하고 있습니다.

(3) 업로드 경로와 msgType의 짝을 확인하고 싶습니다

업로드 경로는 /file/BRANDMESSAGE/default(이미지)와 /file/BRANDMESSAGE/wide(와이드 이미지)로 나뉘고, 발송 msgType은 FI(이미지)·FW(와이드 이미지)로 나뉩니다.

  • FI는 default, FW는 wide에 올린 imgUrl을 써야 하는 것이 맞나요?
  • 짝을 어긋나게 쓰면(예: wide에 올린 주소를 FI로 발송) 어떻게 되나요?
  • 참고로 자유형(free) + FW로 보냈더니 정상 수신됐습니다(reportCode 10000). 자유형에서 와이드 이미지가 공식 지원되는 것이 맞나요?

감사합니다.

3

안녕하세요, 비즈고를 이용해 주셔서 감사합니다.
해당 내용을 정확히 확인하느라 답변을 늦게 회신드려 죄송합니다.

문의 주신 내용 순서대로 답변드립니다.

1. M / N 타겟팅을 열려면 무엇이 필요한가요?

무료수신거부 정보 등록만으로는 열리지 않고, 아래 3단계가 모두 완료되어야 합니다.

순서 항목 설명
① 브랜드메시지 사용 전환 신청 080 수신거부 번호 등록의 선행 조건입니다
② 080 무료수신거부 번호 등록 전환 완료 후 등록 가능
③ 발송 대상 확장 신청 (채널친구 외 → 전체) 카카오 심사 후 승인 시 M/N 활성화

콘솔에서 M·N이 비활성(회색)으로 보이는 것과 API에서 61028이 반환되는 것 모두
③ 발송 대상 확장이 승인되지 않은 상태이기 때문입니다. 승인이 완료되면 별도 설정 없이 콘솔·API 모두에서 M/N을 사용하실 수 있습니다.

신청 경로

image
image1113×734 34.3 KB

콘솔 > 팀스페이스 > 메시지 > 카카 > 채널관리 > 채널 상세
 ├ 브랜드메시지 080 수신거부 번호 등록 / 수정
 └ 브랜드메시지 M, N 타겟 확장 신청  (신청 가능 조건 확인 + 증적자료 업로드)

unsubscribePhoneNumber 관련

  • 080 무료수신거부 번호만 사용 가능하며, unsubscribePhoneNumber(수신거부 번호)와 unsubscribeAuthNumber(인증번호)를 세트로 등록/전달하셔야 합니다.
  • 여러 고객사가 공용으로 쓸 수 있는 번호는 없고, 고객사 명의로 개설된 번호가 필요합니다. 비즈고에서 080 수신거부 서비스 신청이 가능합니다.

2. "카카오톡 수신동의"는 어떻게 확인·수집되나요?

M/N/I의 전제가 되는 수신동의는 카카오가 수집·보관하는 값이 아니라, 고객사가 자체적으로 받으신 광고성 정보 수신동의를 의미합니다.

  • 채널 추가와는 별개입니다. 채널 추가(친구) 여부는 카카오가 관리하는 값으로, 타겟팅 I(친구) / N(비친구)를 가르는 기준일 뿐입니다.
  • 고객사가 자체적으로 받으신 마케팅 수신동의와 별개가 아니라, 바로 그것입니다. 발송 대상 확장 심사 시 제출하시는 증적 자료가 이 동의 자료이며, 이후 발송 대상 관리도 고객사 DB 기준으로 하시게 됩니다.
  • 동의 양식은 "광고성 정보 수신동의"가 명확히 표시되고, 수신자가 직접 체크하는 방식(사전 체크 상태 불가)이어야 합니다.

특정 번호의 수신동의 상태 조회 해당 값의 원본이 고객사 DB이므로, 번호별 수신동의 상태를 조회하는 API는 제공하지 않습니다. 실제 도달 결과는 발송 후 리포트의 userType 값으로 친구/비친구 분포를 확인하실 수 있습니다.

3. 자유형(free)에서도 M, N을 쓸 수 있나요?

네, 가능합니다. 2025년 8월 4일 카카오 패치로 자유형에서도 M/N 타겟팅 발송이 지원되며, 비즈고 API도 동일하게 지원하고 있습니다.

4. 기본형과 자유형의 차이

기본형 VS 자유형은 아래의 이미지와 같은 차이가 존재합니다.

image
image2260×1080 106 KB

5. 채널 추가(AC) 버튼이 자유형에서도 되나요?

네, 자유형에서 사용 가능합니다.

수신 폰에서 버튼이 보이지 않으신 건은, :warning: 수신자가 이미 해당 채널의 친구인 경우 채널추가 버튼이 노출되지 않는 카카오 동작으로 보입니다. 접수·발송은 정상 처리(10000)되고 버튼 노출 여부만 수신자 상태에 따라 달라지는 것이라 오류 처리 대상은 아닙니다.

정확한 노출 조건은 카카오 측에 재확인 후 별도 회신드리겠습니다. 그 사이 채널 친구가 아닌 번호로 자유형 + 채널추가 버튼 테스트를 진행해 보시면 노출 여부를 바로 확인하실 수 있습니다.

6. 이미지 업로드 — 등록 절차

이해하신 절차가 맞습니다. 브랜드메시지 이미지는 파일 업로드 API로 먼저 등록 → 응답으로 받은 imgUrl로 발송하시면 됩니다.

msgType은 메시지 유형에 따라 아래 값을 사용해 주세요. (잘못된 값은 A220으로 반환됩니다)

msgType 용도
default 기본 이미지
wide 와이드 이미지
wideItemList / wideItemList/first 와이드 아이템리스트 / 첫 번째 이미지
carouselFeed 캐러셀 피드
carouselCommerce 캐러셀 커머스

7. imgUrl의 유효기간

:warning: 응답의 expired 값이 해당 imgUrl의 만료 일시입니다.

json

"expired": "2027-04-27T00:00:00+09:00"

브랜드메시지 이미지는 카카오 정책 기준으로 장기간 유효하며, 실제 만료 시점은 업로드 응답의 expired 값을 기준으로 관리해 주시면 됩니다. 이미지 조회 API로도 등록된 이미지의 expired를 확인하실 수 있습니다.

8. 유효기간이 지난 imgUrl로 발송하면

:warning: 만료된 이미지 URL은 카카오 측에서 유효하지 않은 리소스로 처리되어 발송 실패로 반환됩니다. 이미지만 빠진 채 성공 처리되지는 않습니다.

만료가 임박한 이미지는 재업로드하여 새로 발급받은 imgUrl로 교체해 주세요.

9. 같은 이미지의 재사용

재사용하셔도 됩니다. 만료 전까지는 동일한 imgUrl을 여러 발송에 반복해서 사용하실 수 있고, 오히려 이 방식을 권장드립니다.

  • 반복 사용하는 배너·고정 이미지 → 한 번 등록해 두고 imgUrl 재사용
  • 발송 건마다 달라지는 이미지 → 발송 시점에 업로드

발송할 때마다 매번 업로드하실 필요는 없습니다. 다만 원본 파일은 만료 시 재업로드하실 수 있도록 고객사 측에 보관해 두시길 권장드립니다.

추가로 궁금하신 점 있으시면 편하게 남겨 주세요. 감사합니다.