전송
프로그램 공급사는 문자전송 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)" 수신방법을 제공합니다.
