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)는 사용할 수 없습니다.
인증
POST /authenticate로 발급받은 인증 토큰을 Bearer 형식으로 전달합니다.
본문
application/json
- 텍스트형
- 이미지형
- 와이드 이미지형
- 와이드 아이템리스트형
- 캐러셀 피드형
- 프리미엄 동영상형
- 커머스형
- 캐러셀 커머스형
노티플라이 설정 페이지에서 확인할 수 있는 프로젝트 ID입니다.
프로젝트에 카카오 비즈메시지 발신자로 등록된 카카오 채널 ID입니다.
발송 타깃입니다. M: 마케팅 수신 동의 회원, N: 마케팅 수신 동의 회원 중 채널 비친구, I: 채널 친구. 자유형은 I+N을 지원하지 않습니다.
사용 가능한 옵션:
M, N, I 수신자 목록입니다. 같은 요청의 모든 수신자에게 동일한 메시지 콘텐츠가 발송됩니다.
Required array length:
1 - 1000 elementsShow child attributes
Show child attributes
메시지 타입
사용 가능한 옵션:
TEXT 사용자에게 전달될 메시지
- 줄바꿈: 최대 99개
- URL 형식 입력 가능
Maximum string length:
1300성인용 메시지 여부입니다.
메시지에 첨부할 내용
Show child attributes
Show child attributes
응답
발송 요청이 큐에 접수되었습니다. 카카오의 최종 발송 성공을 의미하지 않습니다.
true이면 발송 요청이 큐에 접수된 것입니다. 카카오의 최종 발송 성공을 의미하지 않습니다.
사용 가능한 옵션:
true