Kakao
브랜드 메시지 템플릿 목록 조회
브랜드 메시지 템플릿 목록을 조회합니다. 템플릿 타입과 상태로 필터링하고 커서 기반 페이지 구성을 지원합니다.
get/v2/messages/kakao/send-profiles/{sendProfileId}/brand-message-templates
Path parameters
sendProfileIdstring required
Example:@bizmsg_official
목록을 조회할 카카오 채널(발신 프로필) ID입니다.
Query parameters
messageType'BMT' | 'BMI' | 'BMW' | 'BMWL' | 'BMCF'
Example:BMT
조회할 메시지 타입을 지정합니다.
status'PENDING' | 'APPROVED' | 'REJECTED'
Example:APPROVED
조회할 템플릿 상태를 지정합니다.
limitnumber nullable
Example:20
조회할 데이터의 개수를 지정합니다. 기본값은 20입니다.
cursorstring
Example:tpl_bm_123456
다음 페이지를 불러오기 위한 커서입니다.
Response
목록 조회 결과입니다. 오류가 발생해도 HTTP 200으로 응답하므로, 실패 시 본문의 code와 errorCode를 확인하세요.
Example response
{
"code": 200,
"message": "성공",
"data": {
"list": [
{
"templateId": "tpl_bm_123456",
"templateCode": "BM_TEMPLATE_20240515001",
"templateName": "신규 회원 가입 환영 메시지",
"messageType": "BMT",
"status": "APPROVED",
"rejectionReason": null,
"fallback": {
"senderNumber": "01012345678",
"type": "SMS",
"message": "#{고객명}님, 브랜드 메시지를 대신해 문자로 안내드립니다.",
"title": null,
"images": null,
"isAd": false,
"groupId": null
},
"createdAt": "2024-05-15T09:30:00Z",
"updatedAt": "2024-05-16T10:20:00Z",
"approvedAt": "2024-05-16T10:20:00Z"
}
],
"totalCount": 1
}
}