---
title: "브랜드 메시지 발송"
method: POST
path: "/v2/messages/kakao/brand-message"
tags: ["Kakao"]
---

# 브랜드 메시지 발송

`POST /v2/messages/kakao/brand-message`

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

## Request body

- object — 브랜드 메시지 발송 요청 본문입니다. 템플릿 코드, 수신자 목록, 타겟팅 옵션, 예약 발송 설정, 대체문자 정보를 포함합니다.
  - `sendProfileId` string, required — 채널 ID. 카카오 채널 관리자센터에서 등록한 채널의 ID입니다.
  - `templateCode` string, required — 브랜드메시지 템플릿 코드. 미리 생성된 템플릿의 코드를 사용합니다.
  - `targeting` 'I' | 'N' | 'M' — 타겟팅 옵션 - I: 수신자 중 채널을 친구로 등록한 수신자에게만 메시지 발송 - N: 수신자 중 채널을 친구로 등록하지 않은 수신자에게만 메시지 발송 - M: 모든 수신자에게 메시지 발송 (메시지 발송 예약 후 타겟팅 가능) N, M 옵션은 비친구 광고채널 전용입니다.
  - `to` union[], required — 수신자 정보 목록. 최대 1,000명까지 동시 발송할 수 있습니다. - 변수 없는 경우: 휴대폰 번호 문자열 배열 ["01011112222", "01011113333"] - 변수 있는 경우: 객체 배열 [{phone: "01011112222", variables: {"#{고객명}": "홍길동"}}]
    - union
      - string — 메시지를 받을 수신자의 휴대폰 번호입니다. 하이픈(-) 없이 숫자만 입력해주세요.
      - object
        - `phone` string, required — 수신자 휴대폰 번호 (하이픈 없이 숫자만 입력)
        - `variables` object — 템플릿 변수 치환값 템플릿에 정의된 #{변수명} 형태의 변수에 대응하는 실제 값을 지정합니다. 변수명은 템플릿에 정의된 이름과 정확히 일치해야 합니다.
  - `reservation` object — 예약 발송 설정. 미입력시 즉시 발송됩니다.
    - `dateTime` string, date-time, nullable, required — 예약 발송 일시. 현재 시간 기준 10분 후부터 60일 이내로 설정할 수 있습니다.
  - `fallback` object — 대체문자 설정. 브랜드메시지 발송 실패 시 대체문자를 발송합니다. 사용 방법: 1. 대체문자 미사용 { fallbackType: 'NONE' } 2. 직접 대체문자 설정하기 { fallbackType: 'CUSTOM', custom: { type: 'SMS' | 'LMS' | 'MMS', senderNumber: '발신번호', isAd: true | false, message: '대체문자 내용', title: '제목 (LMS/MMS에서 선택)', images: ['이미지URL'] // MMS에서 필수 } }
    - `fallbackType` 'NONE' | 'TEMPLATE' | 'CUSTOM' — 대체문자 사용 옵션 - NONE: 대체문자 사용하지 않음 (기본값) - TEMPLATE: 템플릿에 설정된 대체문자 사용 (알림톡만 가능) - CUSTOM: 직접 설정한 대체문자 사용
    - `custom` object
      - `type` 'SMS' | 'LMS' | 'MMS', required — 대체문자 유형 - SMS: 80바이트 이내 텍스트 (제목/이미지 없음) - LMS: 2000바이트 이내 텍스트 (제목 선택) - MMS: 2000바이트 이내 텍스트+이미지 (제목 선택, 이미지 필수)
      - `senderNumber` string, required — 대체문자 발송에 사용할 발신번호입니다. 센드온에 사전 등록되고 승인된 발신번호만 사용할 수 있습니다.
      - `isAd` boolean — 광고성 메시지 여부입니다. 광고성 메시지는 관련 법규에 따라 수신자의 사전 동의가 필요합니다.
      - `message` string, required — 대체문자 내용. 알림톡 수신 실패 시 발송될 메시지입니다. SMS는 80바이트, LMS/MMS는 2000바이트 제한.
      - `title` string — 메시지 제목. LMS/MMS 타입에서만 사용할 수 있습니다. 40바이트 제한.
      - `images` string[] — 이미지 URL 배열. MMS 타입에서만 사용할 수 있습니다. 최대 3개까지 첨부할 수 있습니다.
  - `useCredit` boolean — 크레딧 우선 사용 여부. true 시 포인트보다 크레딧을 먼저 차감합니다.

## Response `200`

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

- object — 브랜드 메시지 발송 요청 처리 결과입니다. 성공 시 그룹 ID가 포함되며, 실패 시 code와 errorCode에 상세 사유가 제공됩니다.
  - `code` 200, required — 응답 코드
  - `message` string — 응답 메시지
  - `data` object, required — 발송 요청 성공 시 반환되는 데이터
    - `groupId` string, required — 메시지 발송 요청이 성공적으로 처리되어 생성된 그룹의 ID입니다. 이 UUID 형식의 ID로 발송 상태를 추적하고 결과를 조회할 수 있습니다.

---

[API](https://skmtc.net/sendon/apis/sendon-api.md) · [All operations](https://skmtc.net/sendon/apis/sendon-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sendon/sendon-api/versions/525dedc81a05/schema)