---
updatedAt: 2026-08-27T04:52:17.000Z
agentTools:
  projectIndex: https://sdk.sendon.io/llms.txt
---

# 이미지형 브랜드 메시지 템플릿 수정

기존 이미지형 브랜드 메시지 템플릿의 이미지, 메시지 본문, 버튼, 대체문자 정보를 수정합니다.

<Callout icon="🚧" theme="warn">
  센드온 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#/) 를 참고해주세요.
</Callout>

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "paths": {
    "/v2/messages/kakao/send-profiles/{sendProfileId}/brand-message-templates/{templateCode}/update/image": {
      "post": {
        "operationId": "BrandMessageTemplateController_updateImageBrandMessageTemplate",
        "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": "BM_TEMPLATE_20240516001"
            },
            "description": "수정할 템플릿 코드입니다."
          }
        ],
        "requestBody": {
          "required": true,
          "description": "이미지형 브랜드 메시지 템플릿 수정 본문입니다. 이미지 URL, 버튼, 대체문자 정보를 포함합니다.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ImageBrandMessageTemplateBodyDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "수정 처리 결과입니다. 오류가 발생해도 HTTP 200으로 응답하므로, 실패 여부는 본문의 code와 errorCode를 확인하세요.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BrandMessageTemplateMutationResponseDto"
                }
              }
            }
          }
        },
        "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": {
      "BrandMessageButtonDto": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "버튼의 이름입니다.",
            "example": "자세히 보기"
          },
          "linkType": {
            "type": "string",
            "enum": [
              "WL",
              "AL",
              "DS",
              "BK",
              "MD",
              "BT",
              "BC",
              "AC"
            ],
            "description": "버튼 링크 타입입니다.\n- WL: 웹링크 - 외부 웹페이지로 이동\n- AL: 앱링크 - 모바일 앱으로 이동 (딥링크)\n- DS: 배송조회 - 택배 배송 조회 페이지로 이동\n- BK: 봇키워드 - 봇에게 특정 키워드 전송\n- MD: 메시지전달 - 버튼 텍스트와 메시지 본문을 함께 전송\n- BT: 봇전환 - 상담봇으로 전환\n- BC: 상담톡전환 - 상담사와 1:1 채팅으로 전환\n- AC: 채널추가 - 카카오톡 채널 친구 추가",
            "example": "WL"
          },
          "linkM": {
            "type": "string",
            "description": "모바일 환경에서 이동할 URL입니다.",
            "example": "https://m.example.com"
          },
          "linkP": {
            "type": "string",
            "description": "PC 환경에서 이동할 URL입니다.",
            "example": "https://www.example.com"
          },
          "linkI": {
            "type": "string",
            "description": "iOS 앱에서 사용할 스킴 URL입니다.",
            "example": "myapp://page/123"
          },
          "linkA": {
            "type": "string",
            "description": "Android 앱에서 사용할 스킴 URL입니다.",
            "example": "myapp://page/123"
          }
        },
        "required": [
          "name",
          "linkType"
        ]
      },
      "BrandMessageCouponDto": {
        "type": "object",
        "properties": {
          "title": {
            "type": "string",
            "description": "쿠폰 제목입니다.\n\n변수 사용 시 고정 변수명 사용:\n- #{할인금액}원 할인 쿠폰 (#{할인금액} 범위: 1 ~ 99,999,999)\n- #{할인율}% 할인 쿠폰 (#{할인율} 범위: 1 ~ 100)\n- 배송비 할인 쿠폰\n- #{상품명} 무료 쿠폰 (#{상품명} 최대 7자)\n- #{상품명} UP 쿠폰 (#{상품명} 최대 7자)\n\n고정 값 사용 시 변수 자리에 숫자 입력 (예: \"10% 할인 쿠폰\")",
            "example": "10% 할인 쿠폰"
          },
          "description": {
            "type": "string",
            "description": "쿠폰을 설명하는 문장입니다.",
            "example": "첫 구매 시 10% 할인 혜택"
          },
          "linkM": {
            "type": "string",
            "description": "모바일에서 쿠폰 사용 페이지로 이동할 URL입니다.",
            "example": "https://m.example.com/coupon/ABC123"
          },
          "linkP": {
            "type": "string",
            "description": "PC에서 쿠폰 사용 페이지로 이동할 URL입니다.",
            "example": "https://www.example.com/coupon/ABC123"
          },
          "linkI": {
            "type": "string",
            "description": "iOS 앱에서 쿠폰 사용 페이지로 이동할 딥링크입니다.",
            "example": "myapp://coupon/ABC123"
          },
          "linkA": {
            "type": "string",
            "description": "Android 앱에서 쿠폰 사용 페이지로 이동할 딥링크입니다.",
            "example": "myapp://coupon/ABC123"
          }
        },
        "required": [
          "title"
        ]
      },
      "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"
        ]
      },
      "BrandMessageTemplateMutationData": {
        "type": "object",
        "properties": {
          "templateId": {
            "type": "string",
            "description": "템플릿의 ID입니다.",
            "example": "tpl_bm_123456"
          },
          "templateCode": {
            "type": "string",
            "description": "템플릿의 코드입니다.",
            "example": "BM_TEMPLATE_20240515001"
          }
        },
        "required": [
          "templateId",
          "templateCode"
        ]
      },
      "BrandMessageTemplateMutationResponseDto": {
        "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/BrandMessageTemplateMutationData"
              }
            ]
          }
        },
        "required": [
          "code",
          "message",
          "data"
        ]
      },
      "ImageBrandMessageTemplateBodyDto": {
        "type": "object",
        "properties": {
          "templateName": {
            "type": "string",
            "maxLength": 50,
            "description": "템플릿의 이름입니다. 최대 50자로 관리용으로 활용합니다.",
            "example": "신상품 출시 안내"
          },
          "content": {
            "type": "string",
            "description": "메시지 본문입니다. 최대 400자까지 작성할 수 있습니다.\n\n**변수 사용**: #{변수명} 형식으로 변수 치환 가능합니다.\n이미지와 함께 표시되므로 간결하게 작성 권장합니다.",
            "example": "#{고객명}님을 위한 특별한 신상품!\n지금 확인해보세요."
          },
          "imageUrl": {
            "type": "string",
            "format": "uri",
            "description": "권장 크기가 800x400px이고 최대 용량이 500KB인 이미지 URL입니다.",
            "example": "https://mud-kage.kakao.com/dn/pZcoE/btsgaJEJipH/ym1vH70RVKMT0OwOkUkFT0/img_l.jpg"
          },
          "imageName": {
            "type": "string",
            "description": "접근성을 위한 이미지 대체 텍스트입니다.",
            "example": "신상품 이미지"
          },
          "imageLink": {
            "type": "string",
            "format": "uri",
            "description": "이미지를 클릭했을 때 이동할 URL입니다.",
            "example": "https://m.example.com/product/new"
          },
          "buttons": {
            "maxItems": 5,
            "description": "최대 5개까지 등록할 수 있는 버튼 목록입니다.",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/BrandMessageButtonDto"
            }
          },
          "coupon": {
            "description": "선택적으로 제공할 쿠폰 정보입니다.",
            "allOf": [
              {
                "$ref": "#/components/schemas/BrandMessageCouponDto"
              }
            ]
          },
          "fallback": {
            "description": "선택적으로 사용할 대체문자 설정입니다.",
            "allOf": [
              {
                "$ref": "#/components/schemas/BrandMessageFallbackDto"
              }
            ]
          }
        },
        "required": [
          "templateName",
          "content",
          "imageUrl"
        ]
      }
    }
  }
}
```