Skip to main content
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

​
apikey
string
required
제공받은 API key
​
groupId
string
required
그룹 코드

​
Body (JSON)

​
service
number
required
제공받은 SMS 서비스 번호
​
message
string
required
발송할 메시지 (최대 2,000바이트)
​
numbers
string[]
required
수신자 핸드폰 번호 배열
​
groupId
string
required
그룹코드
​
callbackNo
string
required
발신번호. 사전에 등록되어있는 발신번호만 사용 가능합니다.
​
subject
string
메시지 제목
​
mapping
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_00SMS 발송 진행 중 (발송 결과는 별도 요청으로 확인 필요)
MMS_0000LMS 발송 진행 중 (발송 결과는 별도 요청으로 확인 필요)
OK발송 접수 완료
ERROR전송 실패
전체 결과 코드는 에러 코드 페이지의 SMS/LMS 결과코드 섹션을 참고하세요.
status 값은 발송 접수 상태를 나타냅니다. 실제 수신자에게 도달했는지는 별도의 결과 조회 또는 콜백을 통해 확인하세요.