API 가이드

브랜드 메시지 발송

post
https://api.sendon.io/v2/messages/kakao/brand-message

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

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

Body

string
required

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

string
required

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

string
enum
Defaults to I

타겟팅 옵션

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

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

Allowed:
to
array
required
length between 1 and 1000

수신자 정보 목록. 최대 1,000명까지 동시 발송할 수 있습니다.

  • 변수 없는 경우: 휴대폰 번호 문자열 배열 ["01011112222", "01011113333"]
  • 변수 있는 경우: 객체 배열 [{phone: "01011112222", variables: {"#{고객명}": "홍길동"}}]
to*
reservation
object

예약 발송 설정. 미입력시 즉시 발송됩니다.

fallback
object

대체문자 설정. 브랜드메시지 발송 실패 시 대체문자를 발송합니다.

사용 방법:

  1. 대체문자 미사용 { fallbackType: 'NONE' }

  2. 직접 대체문자 설정하기 { fallbackType: 'CUSTOM', custom: { type: 'SMS' | 'LMS' | 'MMS', senderNumber: '발신번호', isAd: true | false, message: '대체문자 내용', title: '제목 (LMS/MMS에서 선택)', images: ['이미지URL'] // MMS에서 필수 } }

boolean
Defaults to true

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

Response

Updated 7 months ago

Language
Credentials
Basic
base64
:
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 7 months ago