API

단문 문자 메시지

작성일 2026.02.27 | 수정일 2026.03.25

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

일반 문자 메시지를 발송합니다.
autoTypeDetect가 true일 때 text 필드가 90byte 이하이면 자동으로 SMS로 발송됩니다.

lightbulb

영문, 숫자, 공백, 줄바꿈은 1byte, 한글은 1자당 2byte로 계산됩니다.

subject 필드를 사용하면 길이 제한과 상관없이 장문(LMS)으로 발송됩니다.

항목	설명
길이 제한	90 byte (한글 45자, 영문 90자)
필수 필드	`to`, `from`, `text`
선택 필드	없음
대체 발송	미지원
autoTypeDetect 조건	`text`가 90byte 이하

필수 파라미터

name	type	Description
messages[].to	String	수신번호
messages[].from	String	발신번호 (사전 등록 필수)
messages[].text	String	메시지 본문 (90byte 이하)

요청 예시

{
  "messages": [
    {
      "to": "01012345678",
      "from": "029302266",
      "text": "안녕하세요. 솔라피입니다."
    }
  ]
}

{
  "messages": [
    {
      "to": "01012345678",
      "from": "029302266",
      "text": "안녕하세요.",
      "type": "SMS",
      "autoTypeDetect": false
    }
  ]
}

{
  "messages": [
    {
      "to": "01012345678",
      "from": "029302266",
      "text": "예약 문자입니다."
    }
  ],
  "scheduledDate": "2026-03-01T09:00:00+09:00"
}