메인 콘텐츠로 건너뛰기
POST
/
messages
/
kakao-brand-message
send-kakao-brand-message
curl --request POST \
  --url https://api.notifly.tech/messages/kakao-brand-message \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "projectId": "example_project_1234567890abcdef",
  "templateId": "template-id",
  "brandMessageTarget": "M",
  "recipientList": [
    {
      "recipientNo": "01012345678",
      "templateParameter": {
        "name": "홍길동"
      }
    }
  ]
}
'
{
  "success": true
}
주의 사항
  • HTTP API를 이용한 카카오 브랜드 메시지 발송은 노티플라이 브랜드메시지 신규 프로필이 등록 되어있을 경우에만 가능합니다. ( (Legacy)로 표기되어 있는 경우 발송할 수 없습니다.)
  • 아직 API를 이용한 발송 결과에 대한 통계는 UI로 제공되지 않습니다. 정보가 필요하실 경우 contact@notifly.tech으로 문의해주세요.
브랜드 메시지 광고 메시지 대체 발송 시 주의사항브랜드 메시지 광고 메시지가 실패하여 광고 SMS로 대체 발송되는 경우, 반드시 080 수신 거부 번호가 등록되어 있어야 합니다.
  • 대체 발송 내용은 템플릿에 설정된 대체 발송 정보를 기반으로 발송됩니다.
  • 대체 발송 템플릿에 변수가 포함된 경우, failoverTextMessageTemplateParameter를 통해 변수 값을 전달할 수 있습니다.
  • failoverTextMessageTemplateParameter에는 최종값을 직접 제공해야 합니다. 유저 속성({{ user["name"] }}) 기반 Liquid 렌더링은 지원되지 않습니다.

인증

Authorization
string
header
필수

POST /authenticate로 발급받은 인증 토큰을 Bearer 형식으로 전달합니다.

본문

application/json
projectId
string
필수

노티플라이 설정 페이지에서 확인 가능

templateId
string
필수

등록한 발송 템플릿 ID

brandMessageTarget
enum<string>
필수

발송 타겟(M/N/I)

사용 가능한 옵션:
M,
N,
I
recipientList
object[]
필수

수신자 목록 (최대 1,000명)

senderGroupingKey
string

발신 그룹핑 키 (최대 100자)

응답

성공적인 메시지 발송입니다

success
boolean