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