브랜드 메시지전환 가이드 - NHN Cloud 사용자 가이드

Notification > KakaoTalk Bizmessage > 친구톡 > 브랜드 메시지 전환 가이드

카카오의 친구톡 서비스가 2025년 12월 31일(수) 을 마지막으로 종료됩니다. 이에 따라 NHN Cloud에서도 2025년 12월 31일(수) 부로 친구톡 서비스를 종료합니다.

	내용
서비스 종료일	2025년 12월 31일(수) Notification 정기 점검 이후
영향 범위	친구톡 발송등을 포함한 모든 기능 종료
예외 지원	친구톡 호환 발송 기능만 한시적으로 제공 (발송 API, 발송 조회 API, 발송 결과 조회 콘솔)

고객님의 원활한 브랜드 메시지 전환을 위해 다음 두 가지 방식을 지원합니다.

항목	내용
지원 기간	약 1년간 (2025.12.30 \~ 2026.12.31 예정)
지원 범위	기존 친구톡 일반 발송 API / 조회 API / 콘솔
지원 내용	기존 친구톡 URI 및 JSON 포맷 그대로 사용 가능 응답 포맷 또한 기존 친구톡과 동일
내부 처리 방식	친구톡 전문을 카카오 브랜드 메시지의 친구톡 호환 발송 API로 전송
검증 규칙	기존 친구톡 validation 규칙 유지 다만 발송 시 브랜드 메시지 스펙으로 인하여 실패 가능성 존재

기존 이용하시던 친구톡 API 요청에 헤더로 X-Convert-To-Brand-Message: true 값을 추가해주시면 친구톡 호환 발송 기능을 이용할 수 있습니다.
호환 발송이 잘 이루어졌는지 명시적으로 확인할 방법을 따로 제공하지는 않는 점 참고 부탁드립니다.
친구톡 호환 발송 기능은 API 버전과 무관하게 제공됩니다.

[Header]

{
  "X-Convert-To-Brand-Message": Boolean
}

이름	타입	필수	설명
X-Convert-To-Brand-Message	Boolean	X	친구톡 호환 발송을 위한 요청 헤더 (2025년 12월 30일 부터 `X-Convert-To-Brand-Message: true` 헤더가 없는 값은 요청 단계에서 발송 실패 처리됩니다.)