문자 메시지 전송하기

문자 메시지 발송은 SMS, LMS, MMS의 3가지 메시지 유형을 지원합니다.

단문 메시지(SMS) : 최대 90자 텍스트
장문 메시지(LMS) : 최대 2,000자 텍스트
멀티미디어 메시지(MMS) : 이미지를 포함한 텍스트 메시지 발송

또한, 메시지 전송 시 필요한 다양한 옵션을 제공합니다.

예약 발송 기능 : 특정 시간에 예약 메시지를 발송
다중 수신자 전송 기능 : 한 번의 API 호출로 여러 명에게 메시지 발송
수신자 맞춤 메시지 : 메시지 내용에 변수를 활용하여 각 수신자에게 맞춤형 메시지 발송

SMS

즉시 문자를 발송하여 사용자와 빠르게 소통할 수 있습니다.
단문 메시지(SMS)는 간단한 알림, 인증 코드 전송, 마케팅 메시지 등 다양한 용도로 활용될 수 있습니다. SDK는 사용자가 최소한의 코드로 메시지를 전송할 수 있도록 직관적으로 설계되었습니다. 다음은 SMS를 전송하는 기본적인 예제입니다.

const sendon = new Sendon({
    id: SENDON_EXAM_ACCOUNT,
    apikey: SENDON_EXAM_API_KEY,
    debug: false,
  })

const result = await sendon.sms.send({
  type: SmsMessageType.SMS,
  from: SENDON_EXAM_SMS_FROM_PHONE,
  to: [SENDON_EXAM_SMS_TO_PHONE],
  message: '단문 메시지(SMS)는 간단한 알림, 인증 코드 전송, 마케팅 메시지 등 다양한 용도로 활용될 수 있습니다',
})

Sendon sendon = Sendon.getInstance(USER_ID, USER_APIKEY, true);

SendSms sendSms = sendon.sms.sendSms(new SmsBuilder()
																.setFrom(SMS_MOBILE_FROM)
                                .setTo(Arrays.asList(SMS_MOBILE_TO))
                                .setMessage("Hello, World!")
                                .setIsAd(false));

주요 필드 설명

필드	설명	필수여부
`type`	메시지 타입	필수
`from`	발신자 번호	필수
`to`	수신자 번호	필수
`message`	전송할 메시지	필수
`title`	메시지 제목	선택
`isAd`	정보성/광고성 옵션 (`false`:정보성 / `true`:광고성)	선택

⚠️ 주의 사항
발송하는 메시지가 정보성 안내라 하더라도, 내용 또는 URL에 영리목적의 내용이 포함된 경우 반드시 광고로 전송해야 합니다. 광고표기법을 준수하지 않으면 관련 기관으로부터 신고될 수 있으며, 광고문자는 반드시 사전 수신 동의를 받은 고객에게만 발송해야 합니다.

자세한 코드 설명은 아래 레시피에서 확인하세요:

🔗 SDK SMS 즉시발송 가이드

LMS

장문 메시지(LMS)는 최대 2,000자까지 전송 가능하며,
상세한 정보 제공, 공지, 프로모션 등 다양한 용도로 활용됩니다. LMS는 이미지 첨부가 없는 긴 메시지를 전송할 때 적합합니다.

LMS 전송 예제

const result = await sendon.sms.send({
  type: SmsMessageType.LMS,
  from: SENDON_EXAM_SMS_FROM_PHONE,
  to: [SENDON_EXAM_SMS_TO_PHONE],
  title: 'LMS 제목',
  message: 'LMS는 2,000자까지 전송이 가능하며, 상세한 정보 제공, 공지, 프로모션 등 다양한 용도로 활용됩니다',
})

Sendon sendon = Sendon.getInstance(USER_ID, USER_APIKEY, true);

SendSms sendSms = sendon.sms.sendLms(new LmsBuilder()
																.setFrom(SMS_MOBILE_FROM)
                                .setTo(Arrays.asList(SMS_MOBILE_TO))
                                .setTitle(TITLE)
                                .setMessage("Hello, World!")
                                .setIsAd(false));

MMS

멀티미디어 메시지(MMS)는 문자와 이미지를 함께 발송할 수 있는 기능입니다.
MMS는 최대 3,000자까지 전송할 수 있으며, **이미지 파일(최대 5MB)**을 첨부할 수 있습니다. 업로드한 이미지는 이동통신사에서 허용하는 품질로 자동 변환됩니다.

MMS 전송 예제

const imageFile = new File(
  [fs.readFileSync(path.resolve(__dirname, '../../resources/sendon_image.png'))],
  'sendon.png',
  {
    type: 'image/png',
  },
)
const uploadedImages = await sendon.sms.uploadImages([imageFile])

const result = await sendon.sms.send({
  type: SmsMessageType.MMS,
  from: SENDON_EXAM_SMS_FROM_PHONE,
  to: [SENDON_EXAM_SMS_TO_PHONE],
  title: 'MMS 제목',
  message: 'MMS는 최대 3,000자까지 전송할 수 있으며, 이미지 파일(최대 5MB)을 첨부할 수 있습니다.',
  images: [uploadedImages.data.images[0].id],
})

List<File> images = Arrays.asList(new File("sendon_image.png"));
UploadImage uploadImage = sendon.sms.uploadImages(images);

SendSms sendSms = sendon.sms.sendMms(new MmsBuilder()
																.setFrom(SMS_MOBILE_FROM)
                                .setTo(Arrays.asList(SMS_MOBILE_TO))
                                .setTitle(TITLE)
                                .setMessage("Hello, World!")
                                .setReservation(reservation)
                                .setIsAd(true)
                                .setImages(Arrays.asList(images.get(0).id)));

이미지 업로드 필드 설명

필드	설명	필수여부
`images`	업로드한 이미지 파일 ID 리스트	선택

자세한 코드 설명은 아래 레시피에서 확인하세요:

🔗 SDK MMS 이미지 업로드 및 발송 가이드

메시지 발송 결과 조회

메시지 발송 요청이 성공적으로 완료되면 고유한 ID를 리턴받게 됩니다.
이 ID를 이용해 전송 결과를 조회할 수 있습니다. 전송 결과를 확인하려면 아래 API 문서를 참고하세요.

🔗 문자 메시지 전송 결과 조회

응답 예제

{
    "code": 200,
    "message": "성공",
    "data": {
        "groupId": "84db8cbb-db70-4e68-8ee7-c37704787e0d"
    }
}