const lmsData = {
service: 1234567890,
subject: '배송 안내',
message: `#{name}님, 주문하신 상품이 발송되었습니다.
[배송 정보]
- 주문번호: #{VAR1}
- 상품명: #{VAR2}
- 배송업체: #{VAR3}
- 운송장번호: #{VAR4}
배송 조회는 해당 택배사 홈페이지에서 확인 가능합니다.`,
numbers: ['01012345678'],
groupId: 'YOUR_GROUP_ID',
callbackNo: '16612460',
mapping: [
{
name: '홍길동',
VAR1: 'ORD20240115001',
VAR2: '샘플 상품',
VAR3: 'CJ대한통운',
VAR4: '123456789012',
},
],
};
await axios.post('https://api.alltalk.co.kr/sms/lms', lmsData, {
headers: {
apikey: 'YOUR_API_KEY',
groupId: 'YOUR_GROUP_ID',
},
}).then((res) => {
console.log('전송 결과:', res.data);
});
{
"status": "success",
"code": "200",
"datetime": "2024-01-15 14:35:10",
"value": [
{
"uid": 37668015185,
"date": 1705298110123,
"status": "MMS_0000"
}
],
"count": 1,
"total": 1
}
메시지 발송
LMS 발송
등록된 발신번호를 통해 장문 메시지(LMS)를 전송합니다.
POST
/
sms
/
lms
const lmsData = {
service: 1234567890,
subject: '배송 안내',
message: `#{name}님, 주문하신 상품이 발송되었습니다.
[배송 정보]
- 주문번호: #{VAR1}
- 상품명: #{VAR2}
- 배송업체: #{VAR3}
- 운송장번호: #{VAR4}
배송 조회는 해당 택배사 홈페이지에서 확인 가능합니다.`,
numbers: ['01012345678'],
groupId: 'YOUR_GROUP_ID',
callbackNo: '16612460',
mapping: [
{
name: '홍길동',
VAR1: 'ORD20240115001',
VAR2: '샘플 상품',
VAR3: 'CJ대한통운',
VAR4: '123456789012',
},
],
};
await axios.post('https://api.alltalk.co.kr/sms/lms', lmsData, {
headers: {
apikey: 'YOUR_API_KEY',
groupId: 'YOUR_GROUP_ID',
},
}).then((res) => {
console.log('전송 결과:', res.data);
});
{
"status": "success",
"code": "200",
"datetime": "2024-01-15 14:35:10",
"value": [
{
"uid": 37668015185,
"date": 1705298110123,
"status": "MMS_0000"
}
],
"count": 1,
"total": 1
}
- 메시지 길이 제한: LMS는 최대 2,000바이트 (한글 약 1,000자). 초과 시 자동으로 잘리거나 발송 실패할 수 있습니다.
- 발신번호 사전 등록:
callbackNo에 사용할 발신번호는 반드시 사전에 등록되어 있어야 합니다.
Headers
string
required
제공받은 API key
string
required
그룹 코드
Body (JSON)
number
required
제공받은 SMS 서비스 번호
string
required
발송할 메시지 (최대 2,000바이트)
string[]
required
수신자 핸드폰 번호 배열
string
required
그룹코드
string
required
발신번호. 사전에 등록되어있는 발신번호만 사용 가능합니다.
string
메시지 제목
object[]
가변 변수 매핑 배열.
numbers 와 동일 순서로 매칭됩니다.예제
const lmsData = {
service: 1234567890,
subject: '배송 안내',
message: `#{name}님, 주문하신 상품이 발송되었습니다.
[배송 정보]
- 주문번호: #{VAR1}
- 상품명: #{VAR2}
- 배송업체: #{VAR3}
- 운송장번호: #{VAR4}
배송 조회는 해당 택배사 홈페이지에서 확인 가능합니다.`,
numbers: ['01012345678'],
groupId: 'YOUR_GROUP_ID',
callbackNo: '16612460',
mapping: [
{
name: '홍길동',
VAR1: 'ORD20240115001',
VAR2: '샘플 상품',
VAR3: 'CJ대한통운',
VAR4: '123456789012',
},
],
};
await axios.post('https://api.alltalk.co.kr/sms/lms', lmsData, {
headers: {
apikey: 'YOUR_API_KEY',
groupId: 'YOUR_GROUP_ID',
},
}).then((res) => {
console.log('전송 결과:', res.data);
});
{
"status": "success",
"code": "200",
"datetime": "2024-01-15 14:35:10",
"value": [
{
"uid": 37668015185,
"date": 1705298110123,
"status": "MMS_0000"
}
],
"count": 1,
"total": 1
}
SMS/LMS 공통 응답코드
| 코드 | 설명 |
|---|---|
SMS_00 | SMS 발송 진행 중 (발송 결과는 별도 요청으로 확인 필요) |
MMS_0000 | LMS 발송 진행 중 (발송 결과는 별도 요청으로 확인 필요) |
OK | 발송 접수 완료 |
ERROR | 전송 실패 |
status 값은 발송 접수 상태를 나타냅니다. 실제 수신자에게 도달했는지는
별도의 결과 조회 또는 콜백을 통해 확인하세요.