문자 메시지 발송

post

https://api.sendon.io/v2/messages/sms

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

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

문자 메시지 발송을 위한 요청 데이터입니다. 메시지 유형, 발신번호, 수신자 정보, 메시지 내용 등을 포함합니다.

type

string

enum

required

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

Allowed:

from

string

required

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

array

required

메시지를 받을 수신자 정보입니다. 전화번호 문자열 배열, 수신자 객체 배열, 또는 CSV 파일 정보를 사용할 수 있습니다.

to*

title

string

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

message

string

required

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

images

array of strings

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

images

userParameters

object

메시지 개인화를 위한 사용자 정의 매개변수입니다. 수신자별로 다른 내용을 치환할 때 사용하며, 주소록의 필드를 메시지에 삽입할 수 있습니다.

contacts

array of objects

주소록에서 선택한 연락처 그룹 또는 특정 멤버들입니다. to 필드와 함께 사용할 수 없으며, 둘 중 하나만 선택해야 합니다.

contacts

reservation

object

예약 발송 설정입니다. 특정 시간에 발송하거나 주기적으로 반복 발송을 설정할 수 있습니다.

isAd

boolean

Defaults to true

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

useCredit

boolean

Defaults to false

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

Response

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