v1

latestOpenAPI 3.0.2서비스 이용약관2026-07-265758331.1 KB
Kakao

알림톡 메시지 발송

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

post/v2/messages/kakao/alim-talk

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
}

Response

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

code200 required

응답 코드

messagestring

응답 메시지

Example response

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