POPBill Developers
가이드

전송

프로그램 공급사는 문자전송 API를 호출하여 메시지 전송을 팝빌에 접수하고, 통신사 전송라인에 자동 분배하여 팝빌이 처리한 전송내역 및 상태를 확인합니다.

1. 접수

문자메시지 전송을 위해 다음 4가지 유형의 API가 제공됩니다.

  • SendSMS(단문) : 최대 90byte (한글 45자)
  • SendLMS(장문) : 최대 2,000byte (한글 1,000자)
  • SendXMS(SMS→LMS 자동변환) : 입력된 메시지 길이에 따라 SMS 또는 LMS로 자동 변환하여 과금
  • SendMMS(이미지) : 이미지 1장 + 최대 2,000byte (한글 1,000자)

MMS 이미지 규격 : 가로/세로 1,000px 이하, jpg, 최대 300KB

문자전송 API를 호출하여 정상적으로 접수 완료되는 시점에 팝빌은 '접수번호'(receiptNum)를 반환합니다. 접수번호란 문자전송 접수 건을 식별하기 위해 팝빌이 할당하는 고유 식별정보로 예약접수 건을 취소하거나, 전송상태 및 실패사유를 확인하기 위해 사용합니다.

대량전송 프로세스 - (예시) 1,000건 메시지전송

API 단건전송 API 대량전송 API
호출횟수 1,000회 1회
접수번호 1,000개 1개
장점 메시지 개별관리 가능
: 예약취소, 재전송 등
네트워크 통신 오버헤드 개선
접수번호 관리의 효율성
단점 접수번호 관리의 비효율성
네트워크 통신 오버헤드 등
메시지 개별관리 불가능
: 접수건 전체 일괄처리

2. 상태확인

프로그램 공급사가 직접 API 호출하여 팝빌에 접수된 문자 전송내역 및 결과를 확인하는 "API(Polling)"와 팝빌이 업데이트된 상태변경 이벤트를 프로그램 공급사가 등록한 콜백 URL로 실시간 자동 전송하는 "Webhook(Push)" 수신방법을 제공합니다.