스마트홈 위키

SMS 발송

Properties2
tagssms, 뿌리오, apw, 알림, smc
aliases뿌리오, 문자 발송, SMS, 문자 안 옴, ppurio, 발신번호, 문자 발송 이력, 인증 문자 발송, OTP 문자, 관리자 2차 인증 문자

4 min read

배경

가입·비밀번호 초기화 인증 문자, 방범·비상호출 경보 문자는 모두 뿌리오(ppurio) 구버전 API로 나감. 발송은 APW가 맡고, 내부 WAS(MAW·SCW·LMW·SMC)는 APW의 POST /api/smh/sms를 호출함. 공개노트/개발/모듈/APW 연계 서버

SMC(시스템 관리자 웹) 2차 인증도 같은 경로로 나감. 관리자 로그인·비밀번호 재설정의 6자리 OTP를 SMC가 만들어 제목 LH스마트홈OTP인증, evnCd = "CERT", traceId 접두어 SMW:로 APW에 넘김. 대상 번호는 ARIA 암호문 상태로 넘어가고 수신 쪽에서 복호화함. 관리자가 “인증번호가 안 온다”고 하면 아래 확인 순서를 그대로 쓸 것. 공개노트/개발/모듈/SMC 통합운영시스템

동작

  • 엔드포인트: https://message.ppurio.com/api/send_utf8_text.php (발송), cancel_utf8_text.php (취소). 소스에 하드코딩됨
  • 방식: HttpURLConnection + multipart/form-data, UTF-8
  • 계정 정보는 DB에서 읽음. cmn.tb_cstt_m의 cstt_id='PURRIO_SMS_SENDER_INFO', 값은 뿌리오ID|발신번호 형식. us_yn='Y'인 행만 씀
  • 수신번호 여러 개는 |로 이어 한 번에 보냄
  • 저장된 휴대폰 번호는 ARIA로 암호화돼 있어 복호화 후 번호 정규화를 거침
  • 길이 제한: 단문 80byte(한글 40자), 장문 2,000byte, 포토 2,000byte + JPG 150KB
  • local/dev 프로필에서는 notification.receiver.ids에 적힌 계정 번호로만 나감(오발송 방지)

발송 이력

cmn.tb_sms_sndg_l. 발송 전에 먼저 한 줄 남기고, 뿌리오 응답을 받으면 결과를 갱신함. 뿌리오 오류 응답 문자열이 그대로 여기 남음.

응답 코드 (/api/smh/sms)

코드뜻
2000성공
5013필수 파라미터 누락
5021대상 정보 없음 (번호 비어 있음)
5023발송 실패
5024일부 건 오류

문자가 안 갈 때 보는 순서

  1. 뿌리오 사이트에서 발송 이력 확인. 발송 실패는 대부분 뿌리오 잔액 부족임(2026-09-17 확인). 잔액 부족이면 전무님께 충전 요청
  2. cmn.tb_sms_sndg_l에 이력이 있는지. 없으면 APW까지 요청이 안 온 것
  3. 이력은 있는데 실패면 뿌리오 응답 문자열 확인. 잔액 부족, 발신번호 사전등록 해제가 흔함
  4. tb_cstt_m의 PURRIO_SMS_SENDER_INFO가 us_yn='Y'인지. N이 되면 SMS가 전부 멈춤
  5. 로그 키워드: 뿌리오, sms 발송요청 실패, [SMS발송]대상 정보가 없습니다

알려진 이슈

  • 뿌리오 개발가이드 링크가 홈페이지에서 삭제됨(2024-06 인수인계). 신규 API 전환 검토 필요

관련

공개노트/개발/모듈/APW 연계 서버 공개노트/기능/홈넷 이벤트 알림 기본매뉴얼/입주민/인증 문자가 안 와요 공개노트/개발/push 알림

백링크