SMS, LMS, MMS 타입의 문자 메시지를 발송합니다. 단문(SMS), 장문(LMS), 그림문자(MMS)를 지원하며, 예약 발송, 대용량 발송, 주소록 기반으로 발송할 수 있습니다. 발송 후 그룹 ID를 반환하여 발송 이력 추적을 지원합니다.
센드온 API는 네트워크 에러를 분리하기 위해 HTTP 상태 코드 200으로 응답합니다.
자세한 응답 코드는 API 응답 코드 가이드 를 참고해주세요.
문자 메시지 발송은 SMS, LMS, MMS의 3가지 메시지 유형을 지원합니다.
- 단문 메시지(SMS) : 최대 90바이트 텍스트
- 장문 메시지(LMS) : 최대 2,000바이트 텍스트
- 그림 문자(MMS) : 이미지를 포함한 텍스트 메시지 발송
또한, 메시지 전송 시 필요한 다양한 옵션을 제공합니다.
- 예약 발송 기능 : 특정 시간에 예약 메시지를 발송
- 다중 수신자 전송 기능 : 한 번의 API 호출로 여러 명에게 메시지 발송. 최대 50만명의 수신자에게 발송
- 수신자 맞춤 메시지 : 메시지 내용에 변수를 활용하여 각 수신자에게 맞춤형 메시지 발송
SMS
즉시 문자를 발송하여 사용자와 빠르게 소통할 수 있습니다.
단문 메시지(SMS)는 간단한 알림, 인증 코드 전송, 마케팅 메시지 등 다양한 용도로 활용될 수 있습니다.
SDK는 사용자가 최소한의 코드로 메시지를 전송할 수 있도록 직관적으로 설계되었습니다.
주요 필드 설명
| 필드 | 설명 | 필수여부 |
|---|---|---|
type | 메시지 타입 | 필수 |
from | 발신자 번호 | 필수 |
to | 수신자 번호 (250KB 길이 제한) | 필수 |
message | 전송할 메시지 | 필수 |
isAd | 정보성/광고성 옵션 (false:정보성 / true:광고성) | 선택 |
useCredit | 크레딧 우선사용 여부 | 선택 |
⚠️ 주의 사항
발송하는 메시지가 정보성 안내라 하더라도, 내용 또는 URL에 영리목적의 내용이 포함된 경우 반드시 광고로 전송해야 합니다. 광고표기법을 준수하지 않으면 관련 기관으로부터 신고될 수 있으며, 광고문자는 반드시 사전 수신 동의를 받은 고객에게만 발송해야 합니다.
LMS
장문 메시지(LMS)는 최대 2,000바이트까지 전송 가능하며,
상세한 정보 제공, 공지, 프로모션 등 다양한 용도로 활용됩니다.
LMS는 이미지 첨부가 없는 긴 메시지를 전송할 때 적합합니다.
주요 필드 설명
| 필드 | 설 | 필수여부 |
|---|---|---|
title | 메시지 제목 | 선택 |
MMS
그림문자(MMS)는 문자와 이미지를 함께 발송할 수 있는 기능입니다.
MMS는 최대 3,000바이트까지 전송할 수 있으며, 이미지 파일(최대 5MB)을 첨부할 수 있습니다.
업로드한 이미지는 이동통신사에서 허용하는 품질로 자동 변환됩니다.
이미지 파일 업로드는 MMS 이미지 업로드 API를 사용합니다.
이미지 업로드 필드 설명
| 필드 | 설명 | 필수여부 |
|---|---|---|
images | 업로드한 이미지 파일 ID 리스트 | 선택 |
대용량 발송
CSV 파일을 사용하여 대용량 발송을 할 수 있습니다.
CSV 업로드 URL 발급 API를 사용하여 bucket, key 값을 받아 to 필드에 객체 형태로 입력합니다.
예약 발송
메시지 전송 예약 기능을 제공하여 특정 시간에 메시지를 발송할 수 있도록 지원합니다.
예약 전송은 고객에게 필요한 정보를 적시에 제공할 수 있는 유용한 도구로, 특히 마케팅 캠페인, 예약 알림, 시간대별 공지 등에 효과적으로 활용됩니다.
❗️ 주의 사항
- 예약 시간은 현재 시간으로부터 최소 30분 이후로 설정해야 합니다.
- 예약 시간은 반드시 ISO 8601 형식을 따라야 합니다.
- 발송이 이미 진행된 메시지는 취소할 수 없습니다.
- 예약된 발송 시각 10분 전까지만 취소 가능합니다.
- 10만건 이상인 경우 15분 전까지 취소 가능
메시지 발송 결과 조회
메시지 발송 요청이 성공적으로 완료되면 고유한 ID를 리턴받게 됩니다.
이 ID를 이용해 전송 결과를 조회할 수 있습니다.
전송 결과를 확인하려면 문자 메시지 발송 상세 조회 API를 사용합니다.