--- updatedAt: 2026-08-27T04:52:17.000Z agentTools: projectIndex: https://sdk.sendon.io/llms.txt --- # 브랜드 메시지 템플릿 상세 조회 특정 브랜드 메시지 템플릿의 상세 정보를 조회합니다. 템플릿 타입, 본문, 버튼, 대체문자 정보를 함께 제공합니다. 센드온 API는 네트워크 에러를 분리하기 위해 HTTP 상태 코드 200으로 응답합니다. 자세한 응답 코드는 [API 응답 코드 가이드](https://sdk.sendon.io/reference/4-api-%EC%9D%91%EB%8B%B5-%EC%BD%94%EB%93%9C-%EA%B0%80%EC%9D%B4%EB%93%9C#/) 를 참고해주세요. # OpenAPI definition ```json { "openapi": "3.0.0", "paths": { "/v2/messages/kakao/send-profiles/{sendProfileId}/brand-message-templates/{templateCode}": { "get": { "operationId": "BrandMessageTemplateController_getBrandMessageTemplate", "summary": "브랜드 메시지 템플릿 상세 조회", "description": "특정 브랜드 메시지 템플릿의 상세 정보를 조회합니다. 템플릿 타입, 본문, 버튼, 대체문자 정보를 함께 제공합니다.", "parameters": [ { "name": "sendProfileId", "required": true, "in": "path", "schema": { "type": "string", "example": "@bizmsg_official" }, "description": "조회할 템플릿이 속한 카카오 채널(발신 프로필) ID입니다." }, { "name": "templateCode", "required": true, "in": "path", "schema": { "type": "string", "example": "tpl_bm_123456" }, "description": "조회할 템플릿 코드입니다." } ], "responses": { "200": { "description": "조회 결과입니다. 오류가 발생해도 HTTP 200으로 응답하므로, 실패 시 본문의 code와 errorCode를 확인하세요.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BrandMessageTemplateDetailResponseDto" } } } } }, "tags": [ "Kakao" ], "security": [ { "basic": [] } ] } } }, "info": { "title": "Sendon API", "description": "Sendon API Generated on 2026-08-27T02:12:51.075Z", "version": "v2", "contact": { "name": "센드온", "url": "https://console.sendon.io/", "email": "" }, "license": { "name": "서비스 이용약관", "url": "https://olive-challenge-eca.notion.site/1a43c16d2709804e9de1dd81e0abf477" } }, "servers": [ { "url": "https://api.sendon.io/", "description": "prd" } ], "components": { "securitySchemes": { "basic": { "type": "http", "scheme": "basic" } }, "schemas": { "BrandMessageFallbackDto": { "type": "object", "properties": { "senderNumber": { "type": "string", "description": "발신자 번호입니다.", "example": "01012345678" }, "type": { "type": "string", "enum": [ "SMS", "LMS", "MMS" ], "description": "대체 발송 타입입니다.\n- SMS: 단문 메시지 (90바이트)\n- LMS: 장문 메시지 (2000바이트)\n- MMS: 멀티미디어 메시지 (이미지 포함)" }, "message": { "type": "string", "nullable": true, "description": "메시지 내용입니다.", "example": "#{고객명}님, 브랜드메시지가 발송되지 못하여 대체문자로 발송됩니다." }, "title": { "type": "string", "nullable": true, "description": "LMS 또는 MMS로 발송할 때 사용하는 메시지 제목입니다.", "example": "대체문자 안내" }, "images": { "nullable": true, "description": "MMS로 전송할 때 사용할 이미지 URL 목록입니다.", "example": [ "https://mud-kage.kakao.com/dn/bgUWpm/btsgfyhWuWn/L9SHkckn2VXHOayfGa9ok1/img_l.jpg" ], "type": "array", "items": { "type": "string" } }, "isAd": { "type": "boolean", "description": "대체문자를 광고로 발송할지 여부입니다.", "example": false }, "groupId": { "type": "string", "nullable": true, "description": "대체 발송이 요청되었을 때 할당되는 그룹 ID입니다.", "example": "004a6217-f06c-40f6-8f39-bf35b3f76111" } }, "required": [ "senderNumber", "type", "message" ] }, "BrandMessageTemplateRejectionReasonDto": { "type": "object", "properties": { "code": { "type": "string", "description": "반려 사유를 나타내는 코드입니다.", "example": "INVALID_CONTENT" }, "message": { "type": "string", "description": "반려 사유를 설명하는 문장입니다.", "example": "메시지 내용에 금지어가 포함되어 있습니다." }, "suggestion": { "type": "string", "description": "수정에 대한 제안 사항입니다.", "example": "금지어를 제거하고 다시 제출해 주세요." } }, "required": [ "code", "message" ] }, "BrandMessageTemplateDto": { "type": "object", "properties": { "templateId": { "type": "string", "description": "템플릿의 고유 ID입니다.", "example": "tpl_bm_123456" }, "templateCode": { "type": "string", "description": "카카오에서 부여하는 템플릿 코드입니다.", "example": "BM_TEMPLATE_20240515001" }, "templateName": { "type": "string", "description": "템플릿의 이름입니다. 관리용으로 사용합니다.", "example": "신규 회원 가입 환영 메시지" }, "messageType": { "type": "string", "enum": [ "BMT", "BMI", "BMW", "BMWL", "BMCF" ], "description": "브랜드메시지 타입입니다.\n- BMT: 텍스트형 (Brand Message Text)\n- BMI: 이미지형 (Brand Message Image)\n- BMW: 와이드형 (Brand Message Wide)\n- BMWL: 와이드 아이템리스트형 (Brand Message Wide List)\n- BMCF: 캐러셀 피드형 (Brand Message Carousel Feed)", "example": "BMT" }, "status": { "type": "string", "enum": [ "PENDING", "APPROVED", "REJECTED" ], "description": "템플릿 상태\n- PENDING: 검수 대기\n- APPROVED: 승인\n- REJECTED: 반려", "example": "PENDING" }, "rejectionReason": { "nullable": true, "description": "템플릿이 반려되었을 때 제공하는 사유입니다.", "allOf": [ { "$ref": "#/components/schemas/BrandMessageTemplateRejectionReasonDto" } ] }, "fallback": { "description": "대체문자 설정 정보를 제공합니다.", "allOf": [ { "$ref": "#/components/schemas/BrandMessageFallbackDto" } ] }, "createdAt": { "type": "string", "format": "date-time", "description": "템플릿이 생성된 시각입니다. ISO 8601 형식입니다.", "example": "2024-05-15T09:30:00Z" }, "updatedAt": { "type": "string", "format": "date-time", "description": "템플릿이 마지막으로 수정된 시각입니다. ISO 8601 형식입니다.", "example": "2024-05-16T10:20:00Z" }, "approvedAt": { "type": "string", "format": "date-time", "description": "템플릿이 승인된 시각입니다. ISO 8601 형식입니다.", "example": "2024-05-16T10:20:00Z" } }, "required": [ "templateId", "templateCode", "templateName", "messageType", "status", "createdAt", "updatedAt" ] }, "BrandMessageTemplateDetailResponseDto": { "type": "object", "properties": { "code": { "type": "number", "description": "HTTP 상태 코드입니다. 200이면 성공, 400대는 클라이언트 오류, 500대는 서버 오류를 나타냅니다.", "example": 200 }, "message": { "type": "string", "description": "API 호출 결과에 대한 사람이 읽을 수 있는 메시지입니다. 성공 시 \"OK\", 실패 시 구체적인 오류 사유가 포함됩니다.", "example": "OK" }, "data": { "description": "브랜드 메시지 템플릿의 상세 정보를 제공합니다.", "allOf": [ { "$ref": "#/components/schemas/BrandMessageTemplateDto" } ] } }, "required": [ "code", "message", "data" ] } } } } ```