카카오 브랜드 메세지 발송 API

이 페이지에서는 카카오 브랜드 메세지 발송에 대한 Open API 스펙을 명시합니다.

사전 작업

토큰 발급

서버에서 발송API를 요청하기 전, 먼저 프로젝트에 유효한 토큰을 발급받아 주세요.

인증 토큰 발급 방법

채널 설정

발신 프로필 등록 및 템플릿 생성을 모두 완료해야 합니다.
콘솔 경로:
- 발신 프로필 등록: [마켓탭 콘솔 > 채널 관리 > 카카오톡 ]
- 템플릿 등록: [마켓탭 콘솔 > 채널 관리 > 브랜드 메시지 템플릿]

카카오 브랜드 메세지 발송 API

Method: POST

Content-Type: application/json

[
  {
    "sender_profile_id": "a2i3lnl",
    "phone_number": "01000000000",
    "campaign_id": "sender_api_campaign",
    "user_id": "sender_api_user_id",
    "template_id": "abecde", 
    "target_group": "I",
    "brand_message_fields": {}
  }
]

Payload 필드 설명

필드명

설명

필수 여부

sender_profile_id

카카오 발신 프로필 ID

required

campaign_id

메세지 발송 결과를 캠페인 ID 단위로 확인하고 싶을 때 사용하실 수 있습니다.

user_id

메세지 발송 결과를 확인할 유저 ID

required

phone_number

발송 대상 전화 번호 ( ex 01012345678 )

required

target_group

브랜드 메시지 대상자 그룹 ( M,N, I )

required

template_id

브랜드 메세지 템플릿 ID

required

brand_message_fields

브랜드 메세지 템플릿 내 카카오 개인화 속성 자세한 사항은 브랜드 메세지 개인화 필드 를 참고해주세요.

override_image_fields

브랜드 메시지 템플릿에서 사용한 이미지 외에 다른 이미지 첨부시 사용

브랜드 메시지 대상자 그룹 ( M,N, I )

카카오 개인화 (brand_message_fields) 관련

템플릿에서 사용하는 변수명은 콘솔 및 브랜드 메시지 개인화 필드 조회 API를 통해 확인 가능합니다.
- 콘솔 > 템플릿 상세 > 본문 영역 #{} 으로 표시된 개인화 필드를 참고해주세요.
모든 필드명이 템플릿에 정의된 이름과 정확히 일치해야 하며, 누락되거나 타입 불일치 시 400 에러 반환됩니다.

재정의 이미지 (override_image_fields) 관련

브랜드 메시지 템플릿에 정의된 이미지 대신 다른 이미지를 사용하고자 할 때 설정하는 필드입니다.
템플릿에 포함된 이미지의 개수만큼 배열 요소를 정의해야 합니다.
변경하지 않을 이미지는 빈 객체({}) 로 유지합니다.
변경할 이미지는 image_url 필드에 새 이미지 URL을 입력합니다.

주의사항 및 기타 안내

발송 API는 실시간으로 처리되며, 요청당 최대 100개의 전화번호로 발송이 가능합니다.
수신 번호가 유효하지 않거나 템플릿이 승인되지 않은 경우 실패 응답이 반환됩니다.
묶음 발송인 경우 병렬처리가 아닌 순차적 발송으로 단건 발송에 비해 응답 속도가 느릴수 있는점 참고 부탁드립니다.
트래픽 집중 시간대에는 발송이 지연될 수 있습니다.

Open API 스펙

카카오 브랜드 메시지 발송

post

지정한 프로젝트의 템플릿 ID와 개인화 필드 정보를 이용해 카카오 브랜드 메시지를 여러 사용자에게 일괄 발송합니다. 캠페인 ID를 지정하면 발송 내역이 분석 지표와 연결됩니다.

Authorizations

Query parameters

project_idstringRequired

프로젝트 ID

Example: bhlc6fn

Bodyobject[]

브랜드 메시지 발송 요청 목록

campaign_idstring · nullableOptional

캠페인 ID (선택)

Example: kbfqeg5x

sender_profile_idstringRequired

카카오 발신 프로필 ID

Example: sp_9s2lkdfa

user_idstringRequired

사용자 식별자

Example: u123456

phone_numberstringRequired

수신자 전화번호

Example: 01012345678

target_groupstring · enumRequired

메시지 발송 대상 그룹

Example: MPossible values:

template_idstringRequired

발송에 사용할 브랜드 메시지 템플릿 ID

Example: xflm3cp

Responses

200

발송 요청 성공

application/json

codeintegerOptionalExample: 200000

messagestringOptionalExample: Success

400

잘못된 요청 (필수 필드 누락 등)

401

인증 실패 (토큰 누락 또는 만료)

500

내부 서버 오류

post

https://crm.marketap.io/api/v1/sender/kakao-brand-message

POST https://crm.marketap.io/api/v1/sender/kakao-brand-message?project_id=text HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 1560

[
  {
    "campaign_id": "kbfqeg5x",
    "sender_profile_id": "sp_9s2lkdfa",
    "user_id": "u123456",
    "phone_number": "01012345678",
    "target_group": "M",
    "template_id": "xflm3cp",
    "brand_message_fields": {
      "content": {
        "고객": "마켓탭"
      },
      "coupon": {
        "title": {
          "할인금액": "10000"
        },
        "common": {
          "쿠폰설명": "앱 전용 쿠폰",
          "coupon_url": "marketap.io/coupon"
        }
      },
      "buttons": {
        "button1_url": "marketap.io"
      },
      "commerce": {
        "content": {
          "sub_text": "이번 주 특가 세일"
        },
        "product_name": {
          "title": "기획전 상품"
        },
        "price": {
          "regular_price": {
            "정상가": "10000"
          },
          "discount_price": {
            "할인가": "9000"
          },
          "discount_rate": {
            "할인율": "10"
          },
          "discount_fixed": {
            "정액할인가": "1000"
          }
        }
      },
      "carousel_commerce": [
        {
          "content": {
            "header": "추천 상품",
            "subtext": "지금 확인해보세요"
          },
          "buttons": {
            "link": "marketap.io/item"
          },
          "coupon": {
            "title": {
              "할인금액": "10000"
            },
            "common": {
              "쿠폰설명": "앱 전용 쿠폰",
              "coupon_url": "marketap.io/coupon"
            }
          },
          "product_name": {
            "title": "베스트 상품",
            "subtitle": "이번 주 특가"
          },
          "price": {
            "regular_price": {
              "정상가": "10000"
            },
            "discount_price": {
              "할인가": "9000"
            },
            "discount_rate": {
              "할인율": "10"
            },
            "discount_fixed": {
              "정액할인가": "1000"
            }
          }
        }
      ],
      "carousel": [
        {
          "content": {
            "title": "인기 상품",
            "desc": "오늘의 추천"
          },
          "coupon": {
            "title": {
              "할인금액": "10000"
            },
            "common": {
              "쿠폰설명": "앱 전용 쿠폰",
              "coupon_url": "marketap.io/coupon"
            }
          },
          "buttons": {
            "url": "marketap.io"
          }
        }
      ]
    },
    "override_image_fields": [
      {
        "image_url": "https://mud-kage.kakao.com/dn/Ot04D/dJMb9Ogppek/aqZnq8p3IQSiHmKw4HP7f1/img_l.jpg",
        "image_click_url": "https://marketap.io/event"
      },
      {},
      {},
      {}
    ]
  }
]

{
  "data": [
    {
      "message_id": "2e133f35-4c63-4bcc-bebd-3e72dd22e28d",
      "user_id": "user_1234",
      "phone_number": "01000000000",
      "status": 200000,
      "message": "Success"
    }
  ],
  "code": 200000,
  "message": "Success"
}

Previous카카오 알림톡 발송 API Next브랜드 메세지 개인화 필드

Last updated 28 days ago

Was this helpful?

hashtag사전 작업

hashtag토큰 발급

hashtag채널 설정

hashtag카카오 브랜드 메세지 발송 API

hashtagPayload 필드 설명

hashtag브랜드 메시지 대상자 그룹 ( M,N, I )

hashtag카카오 개인화 (brand_message_fields) 관련

hashtag재정의 이미지 (override_image_fields) 관련

hashtag주의사항 및 기타 안내

hashtagOpen API 스펙

hashtag카카오 브랜드 메시지 발송

사전 작업

토큰 발급

채널 설정

카카오 브랜드 메세지 발송 API

Payload 필드 설명

브랜드 메시지 대상자 그룹 ( M,N, I )

카카오 개인화 (brand_message_fields) 관련

재정의 이미지 (override_image_fields) 관련

주의사항 및 기타 안내

Open API 스펙

카카오 브랜드 메시지 발송