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)는 사용할 수 없습니다.
본문
application/json
- 텍스트형
- 이미지형
- 와이드 이미지형
- 와이드 아이템리스트형
- 캐러셀 피드형
- 프리미엄 동영상형
- 커머스형
- 캐러셀 커머스형
