Node.js 문자 발송 API 예제

문자 요청 예제 단문(SMS) 발송

예시 값을 실제 발신번호·수신번호·인증키로 바꿔 고객님 서버에서 실행하세요.

sendm.js

const BASE_URL = 'https://api.sendm.co.kr';

const HEADERS = {
  'user-id': process.env.SENDM_USER_ID,   // 센드엠 아이디
  'api-key': process.env.SENDM_API_KEY,   // API 신청 후 발급받은 키
};

/**
 * 문자 발송
 * @param {string} callerNo   등록·승인된 발신번호
 * @param {string} receiveNos 수신번호. 여러 건은 '#' 로 구분
 * @param {string} message    본문
 */
async function sendSms(callerNo, receiveNos, message, options = {}) {
  const body = {
    callerNo,
    receiveNos,
    message,
    smsType: options.smsType || 'SMS',   // 'SMS' 단문 / 'LMS' 장문
    adYn:    options.adYn    || 'N',     // 'N' 일반 / 'Y' 광고 / 'E' 선거
  };
  if (options.title)     body.title     = options.title;      // 장문 제목
  if (options.reserveYn) body.reserveYn = options.reserveYn;  // 'Y' 예약
  if (options.sendDate)  body.sendDate  = options.sendDate;   // YYYYMMDDHHMM

  const res = await fetch(BASE_URL + '/v1/sms/send', {
    method: 'POST',
    headers: Object.assign({ 'Content-Type': 'application/json' }, HEADERS),
    body: JSON.stringify(body),
    signal: AbortSignal.timeout(30000),
  });

  return res.json();
}

module.exports = { sendSms, BASE_URL, HEADERS };

호출과 결과 판정

const { sendSms } = require('./sendm');

const result = await sendSms(
  '02-0000-0000',                    // 발신번호
  '010-0000-0001#010-0000-0002',     // 수신번호 (# 구분)
  '주문이 접수되었습니다.'
);

// code 는 숫자가 아니라 문자열 '0' 이다
if (result.code === '0') {
  console.log('발송 접수 완료. msgId =', result.data.msgId);
} else {
  console.error('발송 실패 [' + result.code + '] ' + result.message);
}

장문(LMS) 예약 발송 reserveYn: 'Y'

function toSendDate(date) {
  const p = (n) => String(n).padStart(2, '0');
  return date.getFullYear()
       + p(date.getMonth() + 1)
       + p(date.getDate())
       + p(date.getHours())
       + p(date.getMinutes());          // YYYYMMDDHHMM (24시간제)
}

const twoHoursLater = new Date(Date.now() + 2 * 60 * 60 * 1000);

await sendSms('02-0000-0000', '010-0000-0001', '주문하신 상품이 출고되었습니다.', {
  smsType:   'LMS',
  title:     '배송 안내',
  reserveYn: 'Y',
  sendDate:  toSendDate(twoHoursLater),
});

알림톡 발송

수신자 배열을 JSON.stringify 로 문자열로 바꾼 뒤 FormData 의 kakaoList 항목에 넣습니다. 배열을 그대로 append 하면 [object Object] 형태의 문자열로 바뀌어 전송됩니다.

const kakaoList = [
  {
    receive: '010-0000-0001',
    message: '홍길동님, 주문번호 A1234 상품이 출고되었습니다.',
    reYn:    'Y',              // 알림톡 실패 시 문자로 대체
    reType:  'LMS',
    reTitle: '배송 안내',
    reMsg:   '홍길동님, 주문번호 A1234 상품이 출고되었습니다.',
  },
];

const form = new FormData();
form.append('callerNo',  '02-0000-0000');
form.append('senderKey', 'YOUR_SENDER_KEY');
form.append('tmplCd',    'YOUR_TEMPLATE_CODE');
form.append('kakaoList', JSON.stringify(kakaoList));

const res = await fetch(BASE_URL + '/v2/kakao/sendAt', {
  method: 'POST',
  headers: HEADERS,
  body: form,
  signal: AbortSignal.timeout(30000),
});

console.log(await res.json());

알림톡 message 에는 승인받은 템플릿 문구를 그대로 넣어야 합니다. 템플릿 승인 과정은 카카오 알림톡 시작하기에서 설명합니다.

다음 단계

• API 신청승인 후 인증키 발급
• API 연동 방법엔드포인트·파라미터 전체
• 발송 실패 원인과 결과코드resultCd 해석
• Java 예제HttpURLConnection으로 호출
• Python 예제requests로 호출

최종 업데이트 : 2026년 10월 21일 · 「센드엠 API 연동정의서 v3.1」 기준