카카오 알림톡 발송 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",
    "alimtalk_fields": [
      {
        "name": "고객",
        "value": "회원"
      },
      {
        "name": "상품명",
        "value": "가방"
      },
      {
        "name": "택배사",
        "value": "test"
      },
      {
        "name": "운송장번호",
        "value": "11010101010"
      },
      {
        "name": "주문번호",
        "value": "11010101010"
      }
    ],
    "template_id": "ekf1h3o"
  }
]

Payload 필드 설명

필드명	설명	필수 여부
sender_profile_id	카카오 발신 프로필 ID	required
campaign_id	메세지 발송 결과를 캠페인 ID 단위로 확인하고 싶을 때 사용하실 수 있습니다.
user_id	메세지 발송 결과를 확인할 유저 ID	required
phone_number	발송 대상 전화 번호 ( ex 01012345678 )	required
template_id	알림톡 템플릿 ID	required
alimtalk_fields	알림톡 템플릿 내 카카오 개인화 속성

• 카카오 개인화 (alimtalk_fileds) 관련

  • 템플릿에서 사용하는 변수명은 콘솔 > 템플릿 상세화면에서 확인 가능합니다.

    • 템플릿 상세 > 본문 영역 #{} 으로 표시된 개인화 필드를 참고해주세요.

  • 모든 필드명이 템플릿에 정의된 이름과 정확히 일치해야 하며, 누락되거나 타입 불일치 시 400 에러 반환됩니다.

  

  

주의사항 및 기타 안내

• 발송 API는 실시간으로 처리되며, 요청당 최대 100개의 전화번호로 발송이 가능합니다.

• 수신 번호가 유효하지 않거나 템플릿이 승인되지 않은 경우 실패 응답이 반환됩니다.

• 묶음 발송인 경우 병렬처리가 아닌 순차적 발송으로 단건 발송에 비해 응답 속도가 느릴수 있는점 참고 부탁드립니다.

• 트래픽 집중 시간대에는 발송이 지연될 수 있습니다.

Open API 스펙

Send a Kakao Alimtalk message

post

Sends a Kakao Alimtalk message using a registered template.

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

project_idstringRequired

프로젝트 ID

Example: o8nn3s3

Bodyobject[]

application/json

phone_numberstringRequiredExample: 01012341234

template_idstringRequired

sender_profile_idstringRequiredExample: sender_profile_id

campaign_idstringOptional

user_idstringRequired

Responses

200

The request has been accepted for processing.

application/json

codeintegerOptionalExample: 200000

messagestringOptionalExample: Success

400

Invalid request parameters.

application/json

401

Unauthorized request.

application/json

500

Internal server error

application/json

post

/api/v1/sender/kakao-alimtalk

HTTPcURLJavaScriptPython

POST /api/v1/sender/kakao-alimtalk?project_id=text HTTP/1.1
Host: crm.marketap.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 639

[
  {
    "sender_profile_id": "xwqs12",
    "phone_number": "01072053615",
    "campaign_id": "sender_campaign_id",
    "user_id": "user_1234",
    "alimtalk_fields": [
      {
        "name": "고객",
        "value": "회원"
      },
      {
        "name": "상품명",
        "value": "가방"
      },
      {
        "name": "결제금액",
        "value": "10000"
      },
      {
        "name": "주문번호",
        "value": "productId"
      }
    ],
    "template_id": "ls0njelk"
  },
  {
    "sender_profile_id": "xwqs12",
    "phone_number": "01072053615",
    "campaign_id": "sender_campaign_id",
    "user_id": "user_1238",
    "alimtalk_fields": [
      {
        "name": "고객",
        "value": "회원"
      },
      {
        "name": "상품명",
        "value": "가방"
      },
      {
        "name": "결제금액",
        "value": "10000"
      },
      {
        "name": "주문번호",
        "value": "productId"
      }
    ],
    "template_id": "ls0njelk"
  }
]

{
  "code": 200000,
  "message": "Success",
  "data": [
    {
      "message_id": "text",
      "user_id": "text",
      "phone_number": "text",
      "status": 1,
      "message": "text"
    }
  ]
}