발신번호 관리

1. CheckSenderNumber - 발신번호 등록여부 확인

카카오톡 발신번호 등록여부를 확인합니다.

• 발신번호 상태가 ‘사용’인 경우에만 응답 객체 Response 의 변수 ‘code’가 1로 반환됩니다.

function response checksendernumber (string corpnum, string sender, string userid) throws popbillexception

요청

Parameters

순번	변수명	타입	길이	필수	설명
1	corpnum	string	10	Y	팝빌회원 사업자번호 ('-' 제외)
2	sender	string	20	Y	확인할 발신번호
3	userid	string	50	N	팝빌회원 아이디

응답

Response

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

예외

PopbillException

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

2. GetSenderNumberMgtURL - 발신번호 등록 팝업 URL

미리보기

대체문자 전송 발신번호를 등록하는 팝업 URL을 반환합니다.

• 권장 사이즈 : width = 1,200px (최소 1,000px) / height = 800px
• 반환되는 URL은 30초 동안만 사용이 가능합니다.
• 반환되는 URL에서만 유효한 세션을 포함하고 있습니다.

function string getSenderNumberMgtURL(string corpnum, string userid) throws popbillexception

요청

Parameters

순번	변수명	타입	길이	필수	설명
1	corpnum	string	10	Y	팝빌회원 사업자번호 ('-' 제외)
2	userid	string	50	N	팝빌회원 아이디

응답

string - 요청에 대한 응답 URL

예외

PopbillException

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

3. GetSenderNumberList - 발신번호 목록 확인

팝빌에 등록한 연동회원의 카카오톡 발신번호 목록을 확인합니다.

subroutine getsendernumberlist(string corpnum, ref sendernumber ref_list[]) throws popbillexception

요청

Parameters

순번	변수명	타입	길이	필수	설명
1	corpnum	string	10	Y	팝빌회원 사업자번호 ('-' 제외)
2	ref_list	ref SenderNumber[ ]	-	Y	서브루틴 반환 결과값
ref SenderNumber[ ] 순번 변수명 타입 길이 필수 설명 1 number string 20 N 발신번호 2 representYN boolean - N 대표번호 지정여부 true 대표번호 false 일반번호 3 state integer 1 N 상태 0 대기 1 사용 2 중지 5 반려

응답

sendernumber[ ] - 요청 파라미터의 ref_list 확인

예외

PopbillException

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