문자 메시지 발송

SMS, LMS, MMS 타입의 문자 메시지를 발송합니다. 단문(SMS), 장문(LMS), 그림문자(MMS)를 지원하며, 예약 발송, 대용량 발송, 주소록 기반으로 발송할 수 있습니다. 발송 후 그룹 ID를 반환하여 발송 이력 추적을 지원합니다.

Request body

type'SMS' | 'LMS' | 'MMS' required

발송된 메시지의 타입입니다. SMS(단문), LMS(장문), MMS(그림문자) 중 하나의 값을 가집니다.

fromstring required

메시지를 발송할 발신번호입니다. 센드온에 사전 등록되고 승인된 발신번호만 사용할 수 있으며, 하이픈(-) 없이 숫자만 입력해주세요.

titlestring

LMS나 MMS 메시지의 제목입니다. SMS는 제목이 없으므로 생략 가능하지만, LMS와 MMS는 필수로 입력해야 합니다.

messagestring required

실제 전송될 메시지의 본문 내용입니다. SMS는 90바이트(한글 45자), LMS는 2000바이트(한글 1000자)까지 입력할 수 있습니다.

imagesstring[]

MMS 메시지에 첨부할 이미지 파일의 ID 목록입니다. 사전에 업로드된 이미지의 ID를 입력하며, 최대 3개까지 첨부할 수 있습니다.

isAdboolean

광고성 메시지 발송 여부입니다. 광고성 메시지는 관련 법규에 따라 수신자의 사전 동의가 필요합니다. 해당 값을 true로 설정 시 광고 표기, 080 수신거부번호 자동입력은 추후 지원 예정입니다.

useCreditboolean

보유한 크레딧을 우선적으로 사용할지 여부입니다. true로 설정하면 포인트보다 크레딧을 먼저 차감합니다.

Example request

{
  "from": "01087654321",
  "to": [
    "01012345678",
    "01087654321"
  ],
  "title": "중요한 안내 사항",
  "message": "안녕하세요. 문자 메시지 발송 테스트입니다.",
  "images": [
    "img_001",
    "img_002"
  ],
  "userParameters": {
    "replaces": [
      {
        "src": "#{고객명}",
        "dst": "CONTACTS_MEMBER_NAME"
      }
    ]
  },
  "contacts": [
    {
      "groupId": "123",
      "memberId": [
        "1",
        "2",
        "3"
      ]
    }
  ],
  "reservation": {
    "datetime": "2024-01-01T00:00:00",
    "repeat": {
      "limit": 100,
      "interval": 5,
      "denyNightTime": true
    }
  },
  "isAd": true
}

Response

문자 메시지 발송 요청이 성공적으로 처리되었습니다. 그룹 ID와 발송 상태 정보가 반환됩니다.

codenumber required

HTTP 상태 코드입니다. 200이면 성공, 400대는 클라이언트 오류, 500대는 서버 오류를 나타냅니다.