POPBill Developers
API Reference

2. 문자전송

2.1. SendSMS - 단문 전송

  • 최대 90byte의 단문(SMS) 메시지 1건 전송을 팝빌에 접수합니다.
def sendSMS(corpNum, sender, senderName, receiver, receiverName, contents, reserveDT = '', adsYN = false, userID = '', requestNum = '')
발신번호 등록
Parameters
순번변수명타입길이필수설명
corpNum String 10 Y 팝빌회원 사업자번호 ('-' 제외)
sender String 20 Y 발신번호
senderName String 70 N 발신자명
receiver String 20 Y 수신번호
receiverName String 70 N 수신자명
contents String 90 Y 메시지 내용
한글, 한자, 특수문자 2byte / 영문, 숫자, 공백 1byte
reserveDT String 14 N 전송 예약일시
형식 : yyyyMMddHHmmss
기본값 : 즉시전송
adsYN Boolean - N 광고메시지 전송여부
true광고
false일반 : 기본값
userID String 50 N 팝빌회원 아이디
requestNum String 36 N 요청번호
파트너가 접수 단위를 식별하기 위해 할당하는 관리번호
영문 대소문자, 숫자, 특수문자('-','_')만 이용 가능
Return

String - 요청에 대한 접수번호(receiptNum)

Throws

PopbillException

2.2. SendSMS_multi - 단문 전송 (동보/대량전송)

  • 최대 90byte의 단문(SMS) 메시지 다수건 전송을 팝빌에 접수합니다. (최대 1,000건)
  • 모든 수신자에게 동일한 내용을 전송하거나(동보전송), 수신자마다 개별 내용을 전송할 수 있습니다(대량전송).
def sendSMS_multi(corpNum, sender, senderName, contents, messages, reserveDT = '', adsYN = false, userID = '', requestNum = '')
발신번호 등록
Parameters
순번변수명타입길이필수설명
corpNum String 10 Y 팝빌회원 사업자번호 ('-' 제외)
sender String 20 N 발신번호
동보전송 경우 사용
contents String 90 조건부 메시지 내용
동보전송 경우 필수
한글, 한자, 특수문자 2byte / 영문, 숫자, 공백 1byte
messages MessageReceiver[ ] Y 전송정보
최대 : 1,000개
reserveDT String 14 N 전송 예약일시
형식 : yyyyMMddHHmmss
기본값 : 즉시전송
adsYN Boolean - N 광고메시지 전송여부
true광고
false일반 : 기본값
userID String 50 N 팝빌회원 아이디
requestNum String 36 N 요청번호
파트너가 접수 단위를 식별하기 위해 할당하는 관리번호
영문 대소문자, 숫자, 특수문자('-','_')만 이용 가능
Return

String - 요청에 대한 접수번호(receiptNum)

Throws

PopbillException

2.3. SendLMS - 장문 전송

  • 최대 2,000byte의 장문(LMS) 메시지 1건 전송을 팝빌에 접수합니다.
def sendLMS(corpNum, sender, senderName, receiver, receiverName, subject, contents, reserveDT = '', adsYN = false, userID = '', requestNum = '')
발신번호 등록
Parameters
순번변수명타입길이필수설명
corpNum String 10 Y 팝빌회원 사업자번호 ('-' 제외)
sender String 20 Y 발신번호
senderName String 70 N 발신자명
receiver String 20 Y 수신번호
receiverName String 70 N 수신자명
subject String 40 N 메시지 제목
contents String 2000 Y 메시지 내용
한글, 한자, 특수문자 2byte / 영문, 숫자, 공백 1byte
reserveDT String 14 N 전송 예약일시
형식 : yyyyMMddHHmmss
기본값 : 즉시전송
adsYN Boolean - N 광고메시지 전송여부
true광고
false일반 : 기본값
userID String 50 N 팝빌회원 아이디
requestNum String 36 N 요청번호
파트너가 접수 단위를 식별하기 위해 할당하는 관리번호
영문 대소문자, 숫자, 특수문자('-','_')만 이용 가능
Return

String - 요청에 대한 접수번호(receiptNum)

Throws

PopbillException

2.4. SendLMS_multi - 장문 전송 (동보/대량전송)

  • 최대 2,000byte의 장문(LMS) 메시지 다수건 전송을 팝빌에 접수합니다. (최대 1,000건)
  • 모든 수신자에게 동일한 내용을 전송하거나(동보전송), 수신자마다 개별 내용을 전송할 수 있습니다(대량전송).
def sendLMS_multi(corpNum, sender, senderName, subject, contents, messages, reserveDT = '', adsYN = false, userID = '', requestNum = '')
발신번호 등록
Parameters
순번변수명타입길이필수설명
corpNum String 10 Y 팝빌회원 사업자번호 ('-' 제외)
sender String 20 N 발신번호
동보전송 경우 사용
senderName String 70 N 발신자명
동보전송 경우 사용
subject String 40 N 메시지 제목
동보전송 경우 사용
contents String 2000 조건부 메시지 내용
동보전송 경우 필수
한글, 한자, 특수문자 2byte / 영문, 숫자, 공백 1byte
messages MessageReceiver[ ] Y 전송정보
최대 : 1,000개
reserveDT String 14 N 전송 예약일시
형식 : yyyyMMddHHmmss
기본값 : 즉시전송
adsYN Boolean - N 광고메시지 전송여부
true광고
false일반 : 기본값
userID String 50 N 팝빌회원 아이디
requestNum String 36 N 요청번호
파트너가 접수 단위를 식별하기 위해 할당하는 관리번호
영문 대소문자, 숫자, 특수문자('-','_')만 이용 가능
Return

String - 요청에 대한 접수번호(receiptNum)

Throws

PopbillException

2.5. SendMMS - 포토문자 전송

  • 최대 2,000byte의 메시지와 이미지로 구성된 포토문자(MMS) 1건 전송을 팝빌에 접수합니다.

    ※ 이미지 파일 포맷/규격 : 최대 300Kbyte(JPEG, JPG), 가로/세로 1,000px 이하 권장

def sendMMS(corpNum, sender, senderName, receiver, receiverName, subject, contents, filePath, reserveDT = '', adsYN = false, userID = '', requestNum = '')
발신번호 등록
Parameters
순번변수명타입길이필수설명
corpNum String 10 Y 팝빌회원 사업자번호 ('-' 제외)
sender String 20 Y 발신번호
senderName String 70 N 발신자명
receiver String 20 Y 수신번호
receiverName String 70 N 수신자명
subject String 40 N 메시지 제목
contents String 2000 Y 메시지 내용
한글, 한자, 특수문자 2byte / 영문, 숫자, 공백 1byte
filePath String - Y 전송할 이미지 파일 경로
reserveDT String 14 N 전송 예약일시
형식 : yyyyMMddHHmmss
기본값 : 즉시전송
adsYN Boolean - N 광고메시지 전송여부
true광고
false일반 : 기본값
userID String 50 N 팝빌회원 아이디
requestNum String 36 N 요청번호
파트너가 접수 단위를 식별하기 위해 할당하는 관리번호
영문 대소문자, 숫자, 특수문자('-','_')만 이용 가능
Return

String - 요청에 대한 접수번호(receiptNum)

Throws

PopbillException

2.6. SendMMS_multi - 포토문자 전송 (동보/대량전송)

  • 최대 2,000byte의 메시지와 이미지로 구성된 포토문자(MMS) 다수건 전송을 팝빌에 접수합니다. (최대 1,000건)

    ※ 이미지 파일 포맷/규격 : 최대 300Kbyte(JPEG), 가로/세로 1,000px 이하 권장

  • 모든 수신자에게 동일한 내용을 전송하거나(동보전송), 수신자마다 개별 내용을 전송할 수 있습니다(대량전송).
def sendMMS_multi(corpNum, sender, senderName, subject, contents, messages, filePath, reserveDT = '', adsYN = false, userID = '', requestNum = '')
발신번호 등록
Parameters
순번변수명타입길이필수설명
corpNum String 10 Y 팝빌회원 사업자번호 ('-' 제외)
sender String 20 N 발신번호
동보전송 경우 사용
senderName String 70 N 발신자명
동보전송 경우 사용
subject String 40 N 메시지 제목
동보전송 경우 사용
contents String 2000 조건부 메시지 내용
동보전송 경우 필수
한글, 한자, 특수문자 2byte / 영문, 숫자, 공백 1byte
messages MessageReceiver[ ] Y 전송정보
최대 : 1,000개
filePath String - Y 전송할 이미지 파일 경로
reserveDT String 14 N 전송 예약일시
형식 : yyyyMMddHHmmss
기본값 : 즉시전송
adsYN Boolean - N 광고메시지 전송여부
true광고
false일반 : 기본값
userID String 50 N 팝빌회원 아이디
requestNum String 36 N 요청번호
파트너가 접수 단위를 식별하기 위해 할당하는 관리번호
영문 대소문자, 숫자, 특수문자('-','_')만 이용 가능
Return

String - 요청에 대한 접수번호(receiptNum)

Throws

PopbillException

2.7. SendXMS - 단문/장문 자동인식 전송

  • 메시지 길이(90byte)에 따라 단문/장문(SMS/LMS)을 자동으로 인식하여 1건의 메시지를 전송을 팝빌에 접수합니다.
def sendXMS(corpNum, sender, senderName, receiver, receiverName, subject, contents, reserveDT = '', adsYN = false, userID = '', requestNum = '')
발신번호 등록
Parameters
순번변수명타입길이필수설명
corpNum String 10 Y 팝빌회원 사업자번호 ('-' 제외)
sender String 20 Y 발신번호
senderName String 70 N 발신자명
receiver String 20 Y 수신번호
receiverName String 70 N 수신자명
subject String 40 N 메시지 제목
contents String 2000 Y 메시지 내용
한글, 한자, 특수문자 2byte / 영문, 숫자, 공백 1byte
reserveDT String 14 N 전송 예약일시
형식 : yyyyMMddHHmmss
기본값 : 즉시전송
adsYN Boolean - N 광고메시지 전송여부
true광고
false일반 : 기본값
userID String 50 N 팝빌회원 아이디
requestNum String 36 N 요청번호
파트너가 접수 단위를 식별하기 위해 할당하는 관리번호
영문 대소문자, 숫자, 특수문자('-','_')만 이용 가능
Return

String - 요청에 대한 접수번호(receiptNum)

Throws

PopbillException

2.8. SendXMS_multi - 단문/장문 자동인식 전송 (동보/대량전송)

  • 메시지 길이(90byte)에 따라 단문/장문(SMS/LMS)을 자동으로 인식하여 다수건의 메시지 전송을 팝빌에 접수합니다. (최대 1,000건)
  • 모든 수신자에게 동일한 내용을 전송하거나(동보전송), 수신자마다 개별 내용을 전송할 수 있습니다(대량전송).
def sendXMS_multi(corpNum, sender, senderName, subject, contents, messages, reserveDT = '', adsYN = false, userID = '', requestNum = '')
발신번호 등록
Parameters
순번변수명타입길이필수설명
corpNum String 10 Y 팝빌회원 사업자번호 ('-' 제외)
sender String 20 N 발신번호
동보전송 경우 사용
senderName String 70 N 발신자명
동보전송 경우 사용
subject String 40 N 메시지 제목
동보전송 경우 사용
contents String 2000 조건부 메시지 내용
동보전송 경우 필수
한글, 한자, 특수문자 2byte / 영문, 숫자, 공백 1byte
messages MessageReceiver[ ] Y 전송정보
최대 : 1,000개
reserveDT String 14 N 전송 예약일시
형식 : yyyyMMddHHmmss
기본값 : 즉시전송
adsYN Boolean - N 광고메시지 전송여부
true광고
false일반 : 기본값
userID String 50 N 팝빌회원 아이디
requestNum String 36 N 요청번호
파트너가 접수 단위를 식별하기 위해 할당하는 관리번호
영문 대소문자, 숫자, 특수문자('-','_')만 이용 가능
Return

String - 요청에 대한 접수번호(receiptNum)

Throws

PopbillException

2.9. CancelReserve - 예약전송 취소 (접수번호)

  • 팝빌에서 반환받은 접수번호로 예약된 문자를 전송 취소합니다. (예약시간 10분 전까지 가능)
def cancelReserve(corpNum, receiptNum, userID = '')
Parameters
순번변수명타입길이필수설명
corpNum String 10 Y 팝빌회원 사업자번호 ('-' 제외)
receiptNum String 18 Y 예약문자 전송요청시 팝빌로부터 반환 받은 접수번호
userID String 50 N 팝빌회원 아이디
Return

Response

Throws

PopbillException

2.10. CancelReserveRN - 예약전송 취소 (요청번호)

  • 파트너가 할당한 요청번호로 예약된 문자를 전송 취소합니다. (예약시간 10분 전까지 가능)
def cancelReserveRN(corpNum, requestNum, userID = '')
Parameters
순번변수명타입길이필수설명
corpNum String 10 Y 팝빌회원 사업자번호 ('-' 제외)
requestNum String 36 Y 예약문자 전송요청시 파트너가 할당한 요청번호
userID String 50 N 팝빌회원 아이디
Return

Response

Throws

PopbillException