카카오 브랜드 메시지 자유형 발송

curl --request POST \
  --url https://api.notifly.tech/messages/kakao-brand-message/freestyle \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "projectId": "example_project_1234567890abcdef",
  "channelId": "your-kakao-channel-id",
  "target": "M",
  "chatBubbleType": "IMAGE",
  "message": "새로운 라이브 상품이 등록되었습니다.",
  "attachment": {
    "image": {
      "imgUrl": "https://mud-kage.kakao.com/example/image.jpg",
      "imgLink": "https://example.com/products/123"
    }
  },
  "recipientList": [
    {
      "recipientNo": "01012345678"
    }
  ]
}
'

{
  "success": true
}

{
  "success": false,
  "error": "Sender info is not registered."
}

{
  "success": false,
  "error": "Invalid Authorization Token"
}

{
  "success": false,
  "error": "Payload Too Large. Can accept up to 1000 recipients per request."
}

{
  "success": false,
  "error": "Internal Server Error"
}

POST

messages

kakao-brand-message

freestyle

curl --request POST \
  --url https://api.notifly.tech/messages/kakao-brand-message/freestyle \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "projectId": "example_project_1234567890abcdef",
  "channelId": "your-kakao-channel-id",
  "target": "M",
  "chatBubbleType": "IMAGE",
  "message": "새로운 라이브 상품이 등록되었습니다.",
  "attachment": {
    "image": {
      "imgUrl": "https://mud-kage.kakao.com/example/image.jpg",
      "imgLink": "https://example.com/products/123"
    }
  },
  "recipientList": [
    {
      "recipientNo": "01012345678"
    }
  ]
}
'

{
  "success": true
}

{
  "success": false,
  "error": "Sender info is not registered."
}

{
  "success": false,
  "error": "Invalid Authorization Token"
}

{
  "success": false,
  "error": "Payload Too Large. Can accept up to 1000 recipients per request."
}

{
  "success": false,
  "error": "Internal Server Error"
}

응답과 발송 결과

한 요청에 포함된 모든 수신자에게 동일한 콘텐츠가 발송됩니다.
이미지가 필요한 유형은 먼저 브랜드 메시지 이미지 업로드를 호출하고, 응답의 data.images[].url을 사용해야 합니다.
PREMIUM_VIDEO의 videoUrl에는 카카오 비즈메시지 동영상 업로드 API에서 등록·인코딩이 완료된 발송용 URL을 사용해야 합니다. 일반 동영상 URL이나 KakaoTV 페이지 URL을 직접 사용할 수 없습니다. 현재 노티플라이 공개 동영상 업로드 API는 제공되지 않으므로 사용이 필요한 경우 contact@notifly.tech으로 문의해주세요.
자유형은 M, N, I 타깃을 지원합니다. I+N은 지원하지 않습니다.
HTTP API 발송은 카카오톡 발송 플랫폼이 Notifly인 경우만 지원합니다. Notifly (Legacy)는 사용할 수 없습니다.

인증

Authorization

string

header

필수

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

본문

application/json

projectId

string

필수

노티플라이 설정 페이지에서 확인할 수 있는 프로젝트 ID입니다.

channelId

string

필수

프로젝트에 카카오 비즈메시지 발신자로 등록된 카카오 채널 ID입니다.

target

enum<string>

필수

발송 타깃입니다. M: 마케팅 수신 동의 회원, N: 마케팅 수신 동의 회원 중 채널 비친구, I: 채널 친구. 자유형은 I+N을 지원하지 않습니다.

사용 가능한 옵션:

M,

N,

I

recipientList

object[]

필수

수신자 목록입니다. 같은 요청의 모든 수신자에게 동일한 메시지 콘텐츠가 발송됩니다.

Required array length: 1 - 1000 elements

Show child attributes

chatBubbleType

enum<string>

필수

메시지 타입

사용 가능한 옵션:

TEXT

message

string

필수

사용자에게 전달될 메시지

줄바꿈: 최대 99개
URL 형식 입력 가능

Maximum string length: 1300

adult

boolean

기본값:false

성인용 메시지 여부입니다.

attachment

object

메시지에 첨부할 내용

Show child attributes

응답

발송 요청이 큐에 접수되었습니다. 카카오의 최종 발송 성공을 의미하지 않습니다.

success

enum<boolean>

필수

true이면 발송 요청이 큐에 접수된 것입니다. 카카오의 최종 발송 성공을 의미하지 않습니다.

사용 가능한 옵션:

true

시작하기

인증

이벤트 & 유저

캠페인

메시징

메시징 관리

카탈로그

내보내기 & 분석

카카오 브랜드 메시지 자유형 발송

인증

본문

응답