API

이미지 문자 메시지

작성일 2026.02.28 | 수정일 2026.03.24

엔드포인트, 요청 본문, 응답 구조 등 자세한 정보는 메시지 발송 공통 문서에서 확인해주세요

이미지가 첨부된 문자 메시지를 발송합니다.
autoTypeDetecttrue일 때 imageId 필드가 존재하면 자동으로 MMS로 발송됩니다.

항목내용
길이 제한2,000 byte (한글 1,000자)
필수 필드to, from, text, imageId
선택 필드subject
이미지 규격JPG, 최대 200KB
대체 발송미지원
autoTypeDetect 조건imageId 존재

수신자 데이터 통신이 필요합니다.
이미지는
스토리지 API를 통해 업로드한 후 반환된 imageId를 사용합니다.

파라미터

필수

nametypeDescription
messages[].toString수신 번호
messages[].fromString발신 번호 (사전 등록 필수)
messages[].textString메시지 본문 (2,000byte 이하)
messages[].imageIdString이미지 파일 ID. 스토리지 업로드 후 반환된 값.

선택

nameTypeDescription
messages[].subjectString메시지 제목

요청 예시

{
  "messages": [
    {
      "to": "01012345678",
      "from": "029302266",
      "text": "사진문자 본문입니다.",
      "imageId": "FILEID000000000000"
    }
  ]
}