Kakao

알림톡 메시지 발송

Changed on Nov 3, 2026

카카오 채널 추가 고객에게 사전 승인된 템플릿으로 정보성 메시지를 발송합니다.

post/v2/messages/kakao/alim-talk

Request

Base URL
https://api.sendon.io
URL
https://api.sendon.io/v2/messages/kakao/alim-talk
Auth
HTTP basic

Request body

sendProfileIdstring required

채널 ID. 카카오 채널 관리자센터에서 등록한 채널의 ID입니다.

templateIdstring required

알림톡 템플릿 ID. 사전 검수 승인된 템플릿의 ID입니다.

useCreditboolean

크레딧 우선 사용 여부. true 시 포인트보다 크레딧을 먼저 차감합니다.

Example request

{
  "sendProfileId": "@test1234",
  "templateId": "TEMPLATE1234567890",
  "to": [
    "01011112222",
    {
      "phone": "01011113333",
      "variables": {
        "#{고객명}": "김철수",
        "#{주문번호}": "20240115001"
      }
    }
  ],
  "useCredit": true,
  "reservation": {
    "dateTime": "2024-01-15T14:30:00Z",
    "datetime": "2026-03-07T09:00:00+09:00"
  },
  "fallback": {
    "fallbackType": "CUSTOM",
    "custom": {
      "type": "SMS",
      "senderNumber": "01011112222",
      "isAd": true,
      "message": "안녕하세요. 고객님의 주문이 확정되었습니다."
    }
  }
}

Response

알림톡 발송 요청의 처리 결과입니다. 성공 시 발송 상태 추적을 위한 그룹 ID가 포함됩니다.

codenumber required

HTTP 상태 코드입니다. 200이면 성공, 400대는 클라이언트 오류, 500대는 서버 오류를 나타냅니다.

messagestring required

API 호출 결과에 대한 사람이 읽을 수 있는 메시지입니다. 성공 시 "OK", 실패 시 구체적인 오류 사유가 포함됩니다.

Example response

{
  "code": 200,
  "message": "OK",
  "data": {
    "groupId": "004a6217-f06c-40f6-8f39-bf35b3f76111"
  }
}

Changes

Nov 3, 202671dc377792d9 Revision changes
- breaking
  request body became required
- breaking
  added to the request property allOf list
- breaking
  the request property type changed from object to no type
- breaking
  removed the media type application/json for the response with the status
- breaking
  removed the media type application/json for the response with the status
- breaking
  removed the media type application/json for the response with the status
- breaking
  removed the media type application/json for the response with the status
- breaking
  removed the media type application/json for the response with the status
- breaking
  removed the media type application/json for the response with the status
- breaking
  the response's property type changed from object to no type for status
- breaking
  removed the required property / from the response with the status
- warning
  removed the request property /
- info
  api operation id sendAlimTalk removed and replaced with MessageController_sendAlimTalk
- info
  the endpoint scheme security basic was added to the API
- info
  added to the response property allOf list for the response status
- info
  the response property became required for the status
- info
  the response's property default value 성공 was removed for the status
- info
  removed the 200.00 enum value from the response property for the response status

Operation history