문자전송

1. SendSMS - 단문 전송

최대 90byte의 단문(SMS) 메시지 전송을 팝빌에 접수합니다.

• 모든 수신자에게 동일한 내용을 전송하거나(동보전송), 수신자마다 개별 내용을 전송할 수 있습니다(대량전송).
• 팝빌 서비스의 안정적인 제공을 위하여 동시호출이 제한될 수 있습니다.
  동시에 1,000건 이상 요청하는 경우 동보전송 또는 대량전송으로 이용하시는 것을 권장합니다.

function SendSMS($CorpNum, $Sender = null, $Content = null, $Messages = array(), $ReserveDT = null, $adsYN = false, $UserID = null, $SenderName = null, $RequestNum = null)

발신번호는 사전에 팝빌에 등록된 번호만 사용할 수 있습니다. [참고] 발신번호 사전등록
[GetSenderNumberMgtURL-발신번호 등록 팝업 URL] 또는 [GetSenderNumberList-발신번호 목록 확인] 를 호출하여 발신번호 등록 내역을 확인할 수 있습니다.
팝빌에 등록되지 않은 발신번호를 입력하는 경우 오류가 반환됩니다.

요청

Parameters

순번	변수명	타입	길이	필수	설명
1	CorpNum	String	10	Y	팝빌회원 사업자번호 ('-' 제외)
2	Sender	String	20	N	발신번호 → 단건전송, 동보전송 경우 사용
3	Content	String	90	조건부	메시지 내용 (단위 : byte) → 단건전송, 동보전송 경우 필수 2byte : 한글, 한자, 특수문자 / 1byte : 영문, 숫자, 공백
4	Messages	Message[ ]	-	Y	문자 정보 → 최대 : 1,000개
Message[ ] 순번 변수명 타입 길이 필수 설명 1 rcv String 20 Y 수신번호 2 rcvnm String 70 N 수신자명 3 snd String 20 N 발신번호 → 대량전송 경우 사용 4 sndnm String 70 N 발신자명 → 대량전송 경우 사용 5 msg String - 조건부 메시지 내용 (단위 : byte) → 대량전송 경우 필수 단문 : 90byte 이하 / 장문 : 2,000byte 이하 2byte : 한글, 한자, 특수문자 / 1byte : 영문, 숫자, 공백 6 sjt String 64 N 메시지 제목 (단위 : byte) → 대량전송 경우 사용 메시지 길이가 90byte 초과한 경우에만 적용 2byte : 한글, 한자, 특수문자 / 1byte : 영문, 숫자, 공백 7 interOPRefKey String 20 N 파트너 지정키 → 문자 대량/동보전송시 파트너가 개별건마다 입력할 수 있는 값
5	ReserveDT	String	14	N	전송 예약일시 → 형식 : yyyyMMddHHmmss ※ 기본값 : 즉시전송
6	adsYN	Boolean	-	N	광고메시지 전송 여부 true 광고 false 일반 : 기본값 → [참고] 광고메시지 전송방법 안내
7	UserID	String	50	N	팝빌회원 아이디
8	senderName	String	70	N	발신자명 → 단건전송, 동보전송 경우 사용
9	requestNum	String	36	N	요청번호 → 파트너가 접수 단위를 식별하기 위해 할당하는 관리번호 영문 대소문자, 숫자, 특수문자('-','_')만 이용 가능

응답

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

예외

PopbillException

순번	변수명	타입	길이	설명
1	code	Integer	-	API 처리 실패에 대한 오류코드 → 음의 정수 8자리 숫자값 [참고] 오류코드
2	message	String	-	API 처리 실패에 대한 오류메시지

2. SendLMS - 장문 전송

최대 2,000byte의 장문(LMS) 메시지 다수건 전송을 팝빌에 접수합니다. (최소 1건, 최대 1,000건)

• 모든 수신자에게 동일한 내용을 전송하거나(동보전송), 수신자마다 개별 내용을 전송할 수 있습니다(대량전송).
• 팝빌 서비스의 안정적인 제공을 위하여 동시호출이 제한될 수 있습니다.
  동시에 1,000건 이상 요청하는 경우 동보전송 또는 대량전송으로 이용하시는 것을 권장합니다.

function SendLMS($CorpNum, $Sender = null, $Subject = null, $Content = null, $Messages = array(), $ReserveDT = null, $adsYN = false, $UserID = null, $SenderName = null, $RequestNum = null)

발신번호는 사전에 팝빌에 등록된 번호만 사용할 수 있습니다. [참고] 발신번호 사전등록
[GetSenderNumberMgtURL-발신번호 등록 팝업 URL] 또는 [GetSenderNumberList-발신번호 목록 확인] 를 호출하여 발신번호 등록 내역을 확인할 수 있습니다.
팝빌에 등록되지 않은 발신번호를 입력하는 경우 오류가 반환됩니다.

요청

Parameters

순번	변수명	타입	길이	필수	설명
1	CorpNum	String	10	Y	팝빌회원 사업자번호 ('-' 제외)
2	Sender	String	20	N	발신번호 → 단건전송, 동보전송 경우 사용
3	Subject	String	64	N	메시지 제목 (단위 : byte) → 단건전송, 동보전송 경우 사용 2byte : 한글, 한자, 특수문자 / 1byte : 영문, 숫자, 공백
4	Content	String	2000	조건부	메시지 내용 (단위 : byte) → 단건전송, 동보전송 경우 필수 2byte : 한글, 한자, 특수문자 / 1byte : 영문, 숫자, 공백
5	Messages	Message[ ]	-	Y	문자 정보 → 최대 : 1,000개
Message[ ] 순번 변수명 타입 길이 필수 설명 1 rcv String 20 Y 수신번호 2 rcvnm String 70 N 수신자명 3 snd String 20 N 발신번호 → 대량전송 경우 사용 4 sndnm String 70 N 발신자명 → 대량전송 경우 사용 5 msg String - 조건부 메시지 내용 (단위 : byte) → 대량전송 경우 필수 단문 : 90byte 이하 / 장문 : 2,000byte 이하 2byte : 한글, 한자, 특수문자 / 1byte : 영문, 숫자, 공백 6 sjt String 64 N 메시지 제목 (단위 : byte) → 대량전송 경우 사용 메시지 길이가 90byte 초과한 경우에만 적용 2byte : 한글, 한자, 특수문자 / 1byte : 영문, 숫자, 공백 7 interOPRefKey String 20 N 파트너 지정키 → 문자 대량/동보전송시 파트너가 개별건마다 입력할 수 있는 값
6	ReserveDT	String	14	N	전송 예약일시 → 형식 : yyyyMMddHHmmss ※ 기본값 : 즉시전송
7	adsYN	Boolean	-	N	광고메시지 전송 여부 true 광고 false 일반 : 기본값 → [참고] 광고메시지 전송방법 안내
8	UserID	String	50	N	팝빌회원 아이디
9	senderName	String	70	N	발신자명 → 단건전송, 동보전송 경우 사용
10	requestNum	String	36	N	요청번호 → 파트너가 접수 단위를 식별하기 위해 할당하는 관리번호 영문 대소문자, 숫자, 특수문자('-','_')만 이용 가능

응답

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

예외

PopbillException

순번	변수명	타입	길이	설명
1	code	Integer	-	API 처리 실패에 대한 오류코드 → 음의 정수 8자리 숫자값 [참고] 오류코드
2	message	String	-	API 처리 실패에 대한 오류메시지

3. SendMMS - 포토문자 전송

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

• 모든 수신자에게 동일한 내용을 전송하거나(동보전송), 수신자마다 개별 내용을 전송할 수 있습니다(대량전송).
  ※ 이미지 파일 포맷/규격 : 최대 300Kbyte(JPEG, JPG), 가로/세로 1,000px 이하 권장
• 팝빌 서비스의 안정적인 제공을 위하여 동시호출이 제한될 수 있습니다.
  동시에 1,000건 이상 요청하는 경우 동보전송 또는 대량전송으로 이용하시는 것을 권장합니다.

function SendMMS($CorpNum, $Sender = null, $Subject = null, $Content = null, $Messages = array(), $FilePaths = array(), $ReserveDT = null, $adsYN = false, $UserID = null, $SenderName = null, $RequestNum = null)

발신번호는 사전에 팝빌에 등록된 번호만 사용할 수 있습니다. [참고] 발신번호 사전등록
[GetSenderNumberMgtURL-발신번호 등록 팝업 URL] 또는 [GetSenderNumberList-발신번호 목록 확인] 를 호출하여 발신번호 등록 내역을 확인할 수 있습니다.
팝빌에 등록되지 않은 발신번호를 입력하는 경우 오류가 반환됩니다.

요청

Parameters

순번	변수명	타입	길이	필수	설명
1	CorpNum	String	10	Y	팝빌회원 사업자번호 ('-' 제외)
2	Sender	String	20	N	발신번호 → 단건전송, 동보전송 경우 사용
3	Subject	String	64	N	메시지 제목 (단위 : byte) → 단건전송, 동보전송 경우 입력 2byte : 한글, 한자, 특수문자 / 1byte : 영문, 숫자, 공백
4	Content	String	2000	조건부	메시지 내용 (단위 : byte) → 단건전송, 동보전송 경우 필수 2byte : 한글, 한자, 특수문자 / 1byte : 영문, 숫자, 공백
5	Messages	Message[ ]	-	Y	문자 정보 → 최대 : 1,000개
Message[ ] 순번 변수명 타입 길이 필수 설명 1 rcv String 20 Y 수신번호 2 rcvnm String 70 N 수신자명 3 snd String 20 N 발신번호 → 대량전송 경우 사용 4 sndnm String 70 N 발신자명 → 대량전송 경우 사용 5 msg String - 조건부 메시지 내용 (단위 : byte) → 대량전송 경우 필수 단문 : 90byte 이하 / 장문 : 2,000byte 이하 2byte : 한글, 한자, 특수문자 / 1byte : 영문, 숫자, 공백 6 sjt String 64 N 메시지 제목 (단위 : byte) → 대량전송 경우 사용 메시지 길이가 90byte 초과한 경우에만 적용 2byte : 한글, 한자, 특수문자 / 1byte : 영문, 숫자, 공백 7 interOPRefKey String 20 N 파트너 지정키 → 문자 대량/동보전송시 파트너가 개별건마다 입력할 수 있는 값
6	FilePaths	Array	1	Y	전송할 이미지 파일 경로 → 파일형식 : JPG 파일크기: 최대 300KB 사이즈 : 가로/세로 1,000px 이하
7	ReserveDT	String	14	N	전송 예약일시 → 형식 : yyyyMMddHHmmss ※ 기본값 : 즉시전송
8	adsYN	Boolean	-	N	광고메시지 전송 여부 true 광고 false 일반 : 기본값 → [참고] 광고메시지 전송방법 안내
9	UserID	String	50	N	팝빌회원 아이디
10	senderName	String	70	N	발신자명 → 단건전송, 동보전송 경우 사용
11	requestNum	String	36	N	요청번호 → 파트너가 접수 단위를 식별하기 위해 할당하는 관리번호 영문 대소문자, 숫자, 특수문자('-','_')만 이용 가능

응답

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

예외

PopbillException

순번	변수명	타입	길이	설명
1	code	Integer	-	API 처리 실패에 대한 오류코드 → 음의 정수 8자리 숫자값 [참고] 오류코드
2	message	String	-	API 처리 실패에 대한 오류메시지

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

메시지 길이(90byte)에 따라 단문/장문(SMS/LMS)을 자동으로 인식하여 1건의 메시지 전송을 팝빌에 접수합니다. (최대 1,000건)

• 모든 수신자에게 동일한 내용을 전송하거나(동보전송), 수신자마다 개별 내용을 전송할 수 있습니다(대량전송).
• 팝빌 서비스의 안정적인 제공을 위하여 동시호출이 제한될 수 있습니다.
  동시에 1,000건 이상 요청하는 경우 동보전송 또는 대량전송으로 이용하시는 것을 권장합니다.

function SendXMS($CorpNum, $Sender = null, $Subject = null, $Content = null, $Messages = array(), $ReserveDT = null, $adsYN = false, $UserID = null, $SenderName = null, $RequestNum = null)

발신번호는 사전에 팝빌에 등록된 번호만 사용할 수 있습니다. [참고] 발신번호 사전등록
[GetSenderNumberMgtURL-발신번호 등록 팝업 URL] 또는 [GetSenderNumberList-발신번호 목록 확인] 를 호출하여 발신번호 등록 내역을 확인할 수 있습니다.
팝빌에 등록되지 않은 발신번호를 입력하는 경우 오류가 반환됩니다.

요청

Parameters

순번	변수명	타입	길이	필수	설명
1	CorpNum	String	10	Y	팝빌회원 사업자번호 ('-' 제외)
2	Sender	String	20	N	발신번호 → 단건전송, 동보전송 경우 사용
3	Subject	String	64	N	메시지 제목 (단위 : byte) → 단건전송, 동보전송 경우 입력 2byte : 한글, 한자, 특수문자 / 1byte : 영문, 숫자, 공백
4	Content	String	2000	조건부	메시지 내용 (단위 : byte) → 단건전송, 동보전송 경우 필수 2byte : 한글, 한자, 특수문자 / 1byte : 영문, 숫자, 공백
5	Messages	Message[ ]	-	Y	문자 정보 → 최대 : 1,000개
Message[ ] 순번 변수명 타입 길이 필수 설명 1 rcv String 20 Y 수신번호 2 rcvnm String 70 N 수신자명 3 snd String 20 N 발신번호 → 대량전송 경우 사용 4 sndnm String 70 N 발신자명 → 대량전송 경우 사용 5 msg String - 조건부 메시지 내용 (단위 : byte) → 대량전송 경우 필수 단문 : 90byte 이하 / 장문 : 2,000byte 이하 2byte : 한글, 한자, 특수문자 / 1byte : 영문, 숫자, 공백 6 sjt String 64 N 메시지 제목 (단위 : byte) → 대량전송 경우 사용 메시지 길이가 90byte 초과한 경우에만 적용 2byte : 한글, 한자, 특수문자 / 1byte : 영문, 숫자, 공백 7 interOPRefKey String 20 N 파트너 지정키 → 문자 대량/동보전송시 파트너가 개별건마다 입력할 수 있는 값
6	ReserveDT	String	14	N	전송 예약일시 → 형식 : yyyyMMddHHmmss ※ 기본값 : 즉시전송
7	adsYN	Boolean	-	N	광고메시지 전송 여부 true 광고 false 일반 : 기본값 → [참고] 광고메시지 전송방법 안내
8	UserID	String	50	N	팝빌회원 아이디
9	senderName	String	70	N	발신자명 → 단건전송, 동보전송 경우 사용
10	requestNum	String	36	N	요청번호 → 파트너가 접수 단위를 식별하기 위해 할당하는 관리번호 영문 대소문자, 숫자, 특수문자('-','_')만 이용 가능

응답

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

예외

PopbillException

순번	변수명	타입	길이	설명
1	code	Integer	-	API 처리 실패에 대한 오류코드 → 음의 정수 8자리 숫자값 [참고] 오류코드
2	message	String	-	API 처리 실패에 대한 오류메시지

5. CancelReserve - 예약전송 전체 취소

팝빌에서 반환받은 접수번호로 예약된 문자를 전송 취소합니다. (예약시간 10분 전까지 가능)

function CancelReserve($CorpNum, $ReceiptNum, $UserID = null)

요청

Parameters

순번	변수명	타입	길이	필수	설명
1	CorpNum	String	10	Y	팝빌회원 사업자번호 ('-' 제외)
2	ReceiptNum	String	18	Y	팝빌에서 할당한 접수번호 → 문자 예약전송 요청의 반환값
3	UserID	String	50	N	팝빌회원 아이디

응답

Response

순번	변수명	타입	길이	설명
1	code	Integer	-	API 처리에 대한 응답코드 1 성공
2	message	String	-	API 처리에 대한 응답메시지

예외

PopbillException

순번	변수명	타입	길이	설명
1	code	Integer	-	API 처리 실패에 대한 오류코드 → 음의 정수 8자리 숫자값 [참고] 오류코드
2	message	String	-	API 처리 실패에 대한 오류메시지

6. CancelReservebyRCV - 예약전송 부분 취소

팝빌에서 반환받은 접수번호로 접수 건을 식별하여 수신번호에 예약된 문자를 전송 취소합니다. (예약시간 10분 전까지 가능)

function CancelReservebyRCV($CorpNum, $ReceiptNum, $ReceiveNum, $UserID = null)

요청

Parameters

순번	변수명	타입	길이	필수	설명
1	CorpNum	String	10	Y	팝빌회원 사업자번호 ('-' 제외)
2	ReceiptNum	String	18	Y	팝빌에서 할당한 접수번호 → 문자 예약전송 요청의 반환값
3	ReceiveNum	String	20	Y	예약전송 수신번호
4	UserID	String	50	N	팝빌회원 아이디

응답

Response

순번	변수명	타입	길이	설명
1	code	Integer	-	API 처리에 대한 응답코드 1 성공
2	message	String	-	API 처리에 대한 응답메시지

예외

PopbillException

순번	변수명	타입	길이	설명
1	code	Integer	-	API 처리 실패에 대한 오류코드 → 음의 정수 8자리 숫자값 [참고] 오류코드
2	message	String	-	API 처리 실패에 대한 오류메시지

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

파트너가 할당한 요청번호로 예약된 문자를 전송 취소합니다. (예약시간 10분 전까지 가능)

function CancelReserveRN($CorpNum, $RequestNum, $UserID = null)

요청

Parameters

순번	변수명	타입	길이	필수	설명
1	CorpNum	String	10	Y	팝빌회원 사업자번호 ('-' 제외)
2	RequestNum	String	36	Y	파트너가 할당한 요청번호
3	UserID	String	50	N	팝빌회원 아이디

응답

Response

순번	변수명	타입	길이	설명
1	code	Integer	-	API 처리에 대한 응답코드 1 성공
2	message	String	-	API 처리에 대한 응답메시지

예외

PopbillException

순번	변수명	타입	길이	설명
1	code	Integer	-	API 처리 실패에 대한 오류코드 → 음의 정수 8자리 숫자값 [참고] 오류코드
2	message	String	-	API 처리 실패에 대한 오류메시지

8. CancelReserveRNbyRCV - 예약전송 부분 취소 (요청번호)

파트너가 할당한 요청번호로 접수 건을 식별하여 수신번호에 예약된 문자를 전송 취소합니다. (예약시간 10분 전까지 가능)

function CancelReserveRNbyRCV($CorpNum, $RequestNum, $ReceiveNum, $UserID = null)

요청

Parameters

순번	변수명	타입	길이	필수	설명
1	CorpNum	String	10	Y	팝빌회원 사업자번호 ('-' 제외)
2	RequestNum	String	36	Y	파트너가 할당한 요청번호
3	ReceiveNum	String	20	Y	예약전송 수신번호
4	UserID	String	50	N	팝빌회원 아이디

응답

Response

순번	변수명	타입	길이	설명
1	code	Integer	-	API 처리에 대한 응답코드 1 성공
2	message	String	-	API 처리에 대한 응답메시지

예외

PopbillException

순번	변수명	타입	길이	설명
1	code	Integer	-	API 처리 실패에 대한 오류코드 → 음의 정수 8자리 숫자값 [참고] 오류코드
2	message	String	-	API 처리 실패에 대한 오류메시지