2. 문자전송
2.1. SendSMS - 단문 전송
- 최대 90byte의 단문(SMS) 메시지 1건 전송을 팝빌에 접수합니다.
def sendSMS(CorpNum, Sender, Receiver, ReceiverName, Contents, reserveDT, adsYN=False, UserID=None, SenderName=None, RequestNum=None):
발신번호 등록
- 발신번호는 사전에 팝빌에 등록된 번호만 사용할 수 있습니다. [참고] 발신번호 사전등록
- [GetSenderNumberMgtURL-발신번호 관리 팝업 URL] 또는 [GetSenderNumberMgtURL-발신번호 목록 확인] 를 호출하여 발신번호 등록 내역을 확인할 수 있습니다.
- 팝빌에 등록되지 않은 발신번호를 입력하는 경우 오류가 반환됩니다.
Parameters
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
CorpNum | str | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
Sender | str | 20 | Y | 발신번호 | |
Receiver | str | 20 | Y | 수신번호 | |
ReceiverName | str | 70 | N | 수신자명 | |
Contents | str | 90 | Y |
메시지 내용
한글, 한자, 특수문자 2byte / 영문, 숫자, 공백 1byte
|
|
reserveDT | str | 14 | N |
전송 예약일시
형식 : yyyyMMddHHmmss
기본값 : 즉시전송
|
|
adsYN | bool | - | N |
광고메시지 전송여부
True광고
False일반 : 기본값
|
|
UserID | str | 50 | N | 팝빌회원 아이디 | |
SenderName | str | 70 | N | 발신자명 | |
RequestNum | str | 36 | N |
요청번호
파트너가 접수 단위를 식별하기 위해 할당하는 관리번호
영문 대소문자, 숫자, 특수문자('-','_')만 이용 가능 |
Return
str - 요청에 대한 접수번호(receiptNum)
Throws
2.2. SendSMS_multi - 단문 전송 (동보/대량전송)
- 최대 90byte의 단문(SMS) 메시지 다수건 전송을 팝빌에 접수합니다. (최대 1,000건)
- 모든 수신자에게 동일한 내용을 전송하거나(동보전송), 수신자마다 개별 내용을 전송할 수 있습니다(대량전송).
def sendSMS_multi(CorpNum, Sender, Contents, Messages, reserveDT, adsYN=False, UserID=None, RequestNum=None):
발신번호 등록
- 발신번호는 사전에 팝빌에 등록된 번호만 사용할 수 있습니다. [참고] 발신번호 사전등록
- [GetSenderNumberMgtURL-발신번호 관리 팝업 URL] 또는 [GetSenderNumberMgtURL-발신번호 목록 확인] 를 호출하여 발신번호 등록 내역을 확인할 수 있습니다.
- 팝빌에 등록되지 않은 발신번호를 입력하는 경우 오류가 반환됩니다.
Parameters
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
CorpNum | str | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
Sender | str | 20 | N |
발신번호
동보전송 경우 사용
|
|
Contents | str | 90 | 조건부 |
메시지 내용
동보전송 경우 필수
한글, 한자, 특수문자 2byte / 영문, 숫자, 공백 1byte |
|
Messages | Message[ ] | Y |
전송정보
최대 : 1,000개
|
||
reserveDT | str | 14 | N |
전송 예약일시
형식 : yyyyMMddHHmmss
기본값 : 즉시전송
|
|
adsYN | bool | - | N |
광고메시지 전송여부
True광고
False일반 : 기본값
|
|
UserID | str | 50 | N | 팝빌회원 아이디 | |
RequestNum | str | 36 | N |
요청번호
파트너가 접수 단위를 식별하기 위해 할당하는 관리번호
영문 대소문자, 숫자, 특수문자('-','_')만 이용 가능 |
Return
str - 요청에 대한 접수번호(receiptNum)
Throws
2.3. SendLMS - 장문 전송
- 최대 2,000byte의 장문(LMS) 메시지 1건 전송을 팝빌에 접수합니다.
def sendLMS(CorpNum, Sender, Receiver, ReceiverName, Subject, Contents, reserveDT, adsYN=False, UserID=None, SenderName=None, RequestNum=None):
발신번호 등록
- 발신번호는 사전에 팝빌에 등록된 번호만 사용할 수 있습니다. [참고] 발신번호 사전등록
- [GetSenderNumberMgtURL-발신번호 관리 팝업 URL] 또는 [GetSenderNumberMgtURL-발신번호 목록 확인] 를 호출하여 발신번호 등록 내역을 확인할 수 있습니다.
- 팝빌에 등록되지 않은 발신번호를 입력하는 경우 오류가 반환됩니다.
Parameters
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
CorpNum | str | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
Sender | str | 20 | Y | 발신번호 | |
Receiver | str | 20 | Y | 수신번호 | |
ReceiverName | str | 70 | N | 수신자명 | |
Subject | str | 40 | N | 메시지 제목 | |
Contents | str | 2000 | Y |
메시지 내용
한글, 한자, 특수문자 2byte / 영문, 숫자, 공백 1byte
|
|
reserveDT | str | 14 | N |
전송 예약일시
형식 : yyyyMMddHHmmss
기본값 : 즉시전송
|
|
adsYN | bool | - | N |
광고메시지 전송여부
True광고
False일반 : 기본값
|
|
UserID | str | 50 | N | 팝빌회원 아이디 | |
SenderName | str | 70 | N | 발신자명 | |
RequestNum | str | 36 | N |
요청번호
파트너가 접수 단위를 식별하기 위해 할당하는 관리번호
영문 대소문자, 숫자, 특수문자('-','_')만 이용 가능 |
Return
str - 요청에 대한 접수번호(receiptNum)
Throws
2.4. SendLMS_multi - 장문 전송 (동보/대량전송)
- 최대 2,000byte의 장문(LMS) 메시지 다수건 전송을 팝빌에 접수합니다. (최대 1,000건)
- 모든 수신자에게 동일한 내용을 전송하거나(동보전송), 수신자마다 개별 내용을 전송할 수 있습니다(대량전송).
def sendLMS_multi(CorpNum, Sender, Subject, Contents, Messages, reserveDT, adsYN=False, UserID=None, RequestNum=None):
발신번호 등록
- 발신번호는 사전에 팝빌에 등록된 번호만 사용할 수 있습니다. [참고] 발신번호 사전등록
- [GetSenderNumberMgtURL-발신번호 관리 팝업 URL] 또는 [GetSenderNumberMgtURL-발신번호 목록 확인] 를 호출하여 발신번호 등록 내역을 확인할 수 있습니다.
- 팝빌에 등록되지 않은 발신번호를 입력하는 경우 오류가 반환됩니다.
Parameters
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
CorpNum | str | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
Sender | str | 20 | N |
발신번호
동보전송 경우 사용
|
|
Subject | str | 40 | N |
메시지 제목
동보전송 경우 사용
|
|
Contents | str | 2000 | 조건부 |
메시지 내용
동보전송 경우 필수
한글, 한자, 특수문자 2byte / 영문, 숫자, 공백 1byte |
|
Messages | Message[ ] | Y |
전송정보
최대 : 1,000개
|
||
reserveDT | str | 14 | N |
전송 예약일시
형식 : yyyyMMddHHmmss
기본값 : 즉시전송
|
|
adsYN | bool | - | N |
광고메시지 전송여부
True광고
False일반 : 기본값
|
|
UserID | str | 50 | N | 팝빌회원 아이디 | |
RequestNum | str | 36 | N |
요청번호
파트너가 접수 단위를 식별하기 위해 할당하는 관리번호
영문 대소문자, 숫자, 특수문자('-','_')만 이용 가능 |
Return
str - 요청에 대한 접수번호(receiptNum)
Throws
2.5. SendMMS - 포토문자 전송
-
최대 2,000byte의 메시지와 이미지로 구성된 포토문자(MMS) 1건 전송을 팝빌에 접수합니다.
※ 이미지 파일 포맷/규격 : 최대 300Kbyte(JPEG, JPG), 가로/세로 1,000px 이하 권장
def sendMMS(CorpNum, Sender, Receiver, ReceiverName, Subject, Contents, filePath, reserveDT, adsYN=False, UserID=None, SenderName=None, RequestNum=None):
발신번호 등록
- 발신번호는 사전에 팝빌에 등록된 번호만 사용할 수 있습니다. [참고] 발신번호 사전등록
- [GetSenderNumberMgtURL-발신번호 관리 팝업 URL] 또는 [GetSenderNumberMgtURL-발신번호 목록 확인] 를 호출하여 발신번호 등록 내역을 확인할 수 있습니다.
- 팝빌에 등록되지 않은 발신번호를 입력하는 경우 오류가 반환됩니다.
Parameters
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
CorpNum | str | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
Sender | str | 20 | Y | 발신번호 | |
Receiver | str | 20 | Y | 수신번호 | |
ReceiverName | str | 70 | N | 수신자명 | |
Subject | str | 40 | N | 메시지 제목 | |
Contents | str | 2000 | Y |
메시지 내용
한글, 한자, 특수문자 2byte / 영문, 숫자, 공백 1byte
|
|
filePath | str | - | Y | 전송할 이미지 파일 경로 | |
reserveDT | str | 14 | N |
전송 예약일시
형식 : yyyyMMddHHmmss
기본값 : 즉시전송
|
|
adsYN | bool | - | N |
광고메시지 전송여부
True광고
False일반 : 기본값
|
|
UserID | str | 50 | N | 팝빌회원 아이디 | |
senderName | str | 70 | N | 발신자명 | |
RequestNum | str | 36 | N |
요청번호
파트너가 접수 단위를 식별하기 위해 할당하는 관리번호
영문 대소문자, 숫자, 특수문자('-','_')만 이용 가능 |
Return
str - 요청에 대한 접수번호(receiptNum)
Throws
2.6. SendMMS_multi - 포토문자 전송 (동보/대량전송)
-
최대 2,000byte의 메시지와 이미지로 구성된 포토문자(MMS) 다수건 전송을 팝빌에 접수합니다. (최대 1,000건)
※ 이미지 파일 포맷/규격 : 최대 300Kbyte(JPEG), 가로/세로 1,000px 이하 권장
- 모든 수신자에게 동일한 내용을 전송하거나(동보전송), 수신자마다 개별 내용을 전송할 수 있습니다(대량전송).
def sendMMS_Multi(CorpNum, Sender, Subject, Contents, Messages, FilePath, reserveDT, adsYN=False, UserID=None, RequestNum=None):
발신번호 등록
- 발신번호는 사전에 팝빌에 등록된 번호만 사용할 수 있습니다. [참고] 발신번호 사전등록
- [GetSenderNumberMgtURL-발신번호 관리 팝업 URL] 또는 [GetSenderNumberMgtURL-발신번호 목록 확인] 를 호출하여 발신번호 등록 내역을 확인할 수 있습니다.
- 팝빌에 등록되지 않은 발신번호를 입력하는 경우 오류가 반환됩니다.
Parameters
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
CorpNum | str | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
Sender | str | 20 | N |
발신번호
동보전송 경우 사용
|
|
Subject | str | 40 | N |
메시지 제목
동보전송 경우 사용
|
|
Contents | str | 2000 | 조건부 |
메시지 내용
동보전송 경우 필수
한글, 한자, 특수문자 2byte / 영문, 숫자, 공백 1byte |
|
Messages | Message[ ] | Y |
전송정보
최대 : 1,000개
|
||
FilePath | str | - | Y | 전송할 이미지 파일 경로 | |
reserveDT | str | 14 | N |
전송 예약일시
형식 : yyyyMMddHHmmss
기본값 : 즉시전송
|
|
adsYN | bool | - | N |
광고메시지 전송여부
True광고
False일반 : 기본값
|
|
UserID | str | 50 | N | 팝빌회원 아이디 | |
RequestNum | str | 36 | N |
요청번호
파트너가 접수 단위를 식별하기 위해 할당하는 관리번호
영문 대소문자, 숫자, 특수문자('-','_')만 이용 가능 |
Return
str - 요청에 대한 접수번호(receiptNum)
Throws
2.7. SendXMS - 단문/장문 자동인식 전송
- 메시지 길이(90byte)에 따라 단문/장문(SMS/LMS)을 자동으로 인식하여 1건의 메시지를 전송을 팝빌에 접수합니다.
def sendXMS(CorpNum, Sender, Receiver, ReceiverName, Subject, Contents, reserveDT, adsYN=False, UserID=None, SenderName=None, RequestNum=None):
발신번호 등록
- 발신번호는 사전에 팝빌에 등록된 번호만 사용할 수 있습니다. [참고] 발신번호 사전등록
- [GetSenderNumberMgtURL-발신번호 관리 팝업 URL] 또는 [GetSenderNumberMgtURL-발신번호 목록 확인] 를 호출하여 발신번호 등록 내역을 확인할 수 있습니다.
- 팝빌에 등록되지 않은 발신번호를 입력하는 경우 오류가 반환됩니다.
Parameters
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
CorpNum | str | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
Sender | str | 20 | Y | 발신번호 | |
Receiver | str | 20 | Y | 수신번호 | |
ReceiverName | str | 70 | N | 수신자명 | |
Subject | str | 40 | N | 메시지 제목 | |
Contents | str | 2000 | Y |
메시지 내용
한글, 한자, 특수문자 2byte / 영문, 숫자, 공백 1byte
|
|
reserveDT | str | 14 | N |
전송 예약일시
형식 : yyyyMMddHHmmss
기본값 : 즉시전송
|
|
adsYN | bool | - | N |
광고메시지 전송여부
True광고
False일반 : 기본값
|
|
UserID | str | 50 | N | 팝빌회원 아이디 | |
SenderName | str | 70 | N | 발신자명 | |
RequestNum | str | 36 | N |
요청번호
파트너가 접수 단위를 식별하기 위해 할당하는 관리번호
영문 대소문자, 숫자, 특수문자('-','_')만 이용 가능 |
Return
str - 요청에 대한 접수번호(receiptNum)
Throws
2.8. SendXMS_multi - 단문/장문 자동인식 전송 (동보/대량전송)
- 메시지 길이(90byte)에 따라 단문/장문(SMS/LMS)을 자동으로 인식하여 다수건의 메시지 전송을 팝빌에 접수합니다. (최대 1,000건)
- 모든 수신자에게 동일한 내용을 전송하거나(동보전송), 수신자마다 개별 내용을 전송할 수 있습니다(대량전송).
def sendXMS_multi(CorpNum, Sender, Subject, Contents, Messages, reserveDT, adsYN=False, UserID=None, RequestNum=None):
발신번호 등록
- 발신번호는 사전에 팝빌에 등록된 번호만 사용할 수 있습니다. [참고] 발신번호 사전등록
- [GetSenderNumberMgtURL-발신번호 관리 팝업 URL] 또는 [GetSenderNumberMgtURL-발신번호 목록 확인] 를 호출하여 발신번호 등록 내역을 확인할 수 있습니다.
- 팝빌에 등록되지 않은 발신번호를 입력하는 경우 오류가 반환됩니다.
Parameters
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
CorpNum | str | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
Sender | str | 20 | N |
발신번호
동보전송 경우 사용
|
|
Subject | str | 40 | N |
메시지 제목
동보전송 경우 사용
|
|
Contents | str | 2000 | 조건부 |
메시지 내용
동보전송 경우 필수
한글, 한자, 특수문자 2byte / 영문, 숫자, 공백 1byte |
|
Messages | Message[ ] | Y |
전송정보
최대 : 1,000개
|
||
reserveDT | str | 14 | N |
전송 예약일시
형식 : yyyyMMddHHmmss
기본값 : 즉시전송
|
|
adsYN | bool | - | N |
광고메시지 전송여부
True광고
False일반 : 기본값
|
|
UserID | str | 50 | N | 팝빌회원 아이디 | |
RequestNum | str | 36 | N |
요청번호
파트너가 접수 단위를 식별하기 위해 할당하는 관리번호
영문 대소문자, 숫자, 특수문자('-','_')만 이용 가능 |
Return
str - 요청에 대한 접수번호(receiptNum)
Throws
2.9. CancelReserve - 예약전송 전체 취소
- 팝빌에서 반환받은 접수번호로 예약된 문자를 전송 취소합니다. (예약시간 10분 전까지 가능)
def cancelReserve(CorpNum, ReceiptNum, UserID=None):
Parameters
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
CorpNum | str | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
ReceiptNum | str | 18 | Y | 예약문자 전송요청시 팝빌로부터 반환 받은 접수번호 | |
UserID | str | 50 | N | 팝빌회원 아이디 |
Return
Throws
2.10. CancelReservebyRCV - 예약전송 부분 취소
- 팝빌에서 반환받은 접수번호로 접수 건을 식별하여 수신번호에 예약된 문자를 전송 취소합니다. (예약시간 10분 전까지 가능)
def cancelReservebyRCV(CorpNum, ReceiptNum, ReceiveNum, UserID=None):
Parameters
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
CorpNum | str | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
ReceiptNum | str | 18 | Y | 예약문자 전송요청시 팝빌로부터 반환 받은 접수번호 | |
ReceiveNum | str | 20 | Y | 예약문자 전송요청시 팝빌로 요청한 수신번호 | |
UserID | str | 50 | N | 팝빌회원 아이디 |
Return
Throws
2.11. CancelReserveRN - 예약전송 전체 취소 (요청번호)
- 파트너가 할당한 요청번호로 예약된 문자를 전송 취소합니다. (예약시간 10분 전까지 가능)
def cancelReserveRN(CorpNum, RequestNum, UserID=None):
Parameters
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
CorpNum | str | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
RequestNum | str | 36 | Y | 예약문자 전송요청시 파트너가 할당한 요청번호 | |
UserID | str | 50 | N | 팝빌회원 아이디 |
Return
Throws
2.12. CancelReserveRNbyRCV - 예약전송 부분 취소 (요청번호)
- 파트너가 할당한 요청번호로 접수 건을 식별하여 수신번호에 예약된 문자를 전송 취소합니다. (예약시간 10분 전까지 가능)
def cancelReserveRNbyRCV(CorpNum, RequestNum, ReceiveNum, UserID=None):
Parameters
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
CorpNum | str | 10 | Y | 팝빌회원 사업자번호 ('-' 제외) | |
RequestNum | str | 36 | Y | 예약문자 전송요청시 파트너가 할당한 요청번호 | |
ReceiveNum | str | 20 | Y | 예약문자 전송요청시 팝빌로 요청한 수신번호 | |
UserID | str | 50 | N | 팝빌회원 아이디 |