v1

latestOpenAPI 3.0.2서비스 이용약관2026-07-265758331.1 KB

Kakao

브랜드 메시지 발송

사전에 등록된 브랜드 메시지 템플릿을 이용해 고객에게 광고성 메시지를 발송합니다. 오류가 발생해도 HTTP 200으로 응답하므로, 본문의 code와 errorCode로 성공 여부를 확인해야 합니다.

post/v2/messages/kakao/brand-message

Request body

sendProfileIdstring required

채널 ID. 카카오 채널 관리자센터에서 등록한 채널의 ID입니다.

templateCodestring required

브랜드메시지 템플릿 코드. 미리 생성된 템플릿의 코드를 사용합니다.

targeting'I' | 'N' | 'M'

타겟팅 옵션

I: 수신자 중 채널을 친구로 등록한 수신자에게만 메시지 발송
N: 수신자 중 채널을 친구로 등록하지 않은 수신자에게만 메시지 발송
M: 모든 수신자에게 메시지 발송 (메시지 발송 예약 후 타겟팅 가능)

N, M 옵션은 비친구 광고채널 전용입니다.

useCreditboolean

크레딧 우선 사용 여부. true 시 포인트보다 크레딧을 먼저 차감합니다.

Example request

{
  "sendProfileId": "@test1234",
  "templateCode": "BM_TEMPLATE_001",
  "to": [
    "01011112222",
    {
      "phone": "01011113333",
      "variables": {
        "#{고객명}": "김철수",
        "#{주문번호}": "20240115001"
      }
    }
  ],
  "useCredit": true
}

Response

브랜드 메시지 발송 요청 처리 결과입니다. 성공 시 그룹 ID가 포함되며, 실패 시 code와 errorCode에 상세 사유가 제공됩니다.

code200 required

응답 코드

messagestring

응답 메시지

Example response

{
  "code": 200,
  "message": "성공",
  "data": {
    "groupId": "004a6217-f06c-40f6-8f39-bf35b3f76111"
  }
}