팝빌 팩스 커넥트

팩스 커넥트 서비스는 팩스 전송결과를 지정된 콜백 URL을 통해 수신할 수 있는 웹훅 수신(Webhook Incoming) 서비스 입니다. 팩스 서비스의 경우 전송을 요청한 시점부터 수신 단말기기가 전송성공으로 시그널을 보낼때까지의 지연이 발생합니다. 비동기 방식으로 팩스 전송결과를 확인해야 하는 불편함을 팩스 커넥트 기능을 적용하여 개선할 수 있습니다.

커넥트 서비스 프로세스

ㆍ 팝빌 커넥트 메시지는 고객사 커넥트 수신 URL로 HTTP POST Request 형태로 전송됩니다.

ㆍ 파트너사 웹 어플리케이션을 통해 HTTP POST Request Body를 JSON decode 커넥트 이벤트 메시지를 확인합니다.

ㆍ HTTP 통신오류(Read timeout, Gateway timeout, SSL 오류 등)로 인해 커넥트 실패시 5분 간격으로 총 2회 재시도됩니다.

ㆍ 기술지원센터에서는 커넥트 실패 건에 대해 모니터링하여 고객사 서버의 장애 감지시 유선으로 안내해 드립니다.

ㆍ 다수의 연동회원사 커넥트 콜백 URL을 동일하게 설정하는 경우 기술지원센터(1600-9854)로 문의하여 주시기 바랍니다.

커넥트 프로세스 흐름도

커넥트 수신 샘플 가이드

커넥트 수신서버 웹 어플리케이션 예제코드는 Java - SpringMVC 전자세금계산서 커넥트 가이드를 참조하시기 바랍니다.

팝빌 팩스 커넥트 설정

1) 1) [팝빌 사이트 로그인] > [문자·팩스] 메뉴 선택 > 왼쪽 메뉴탭 하단의 [환경설정 - 커넥트 관리] 선택

2) 커넥트 유형 'Rest' 선택

3) 콜백 URL 입력 후 저장

▶ 콜백 URL은 80 또는 443 포트를 사용할 수 있으며 별도의 포트를 사용해야 하는 경우 기술지원센터로 문의하여 주시기 바랍니다.

팝빌 팩스 커넥트 이벤트 예시

아래의 영상은 Request Body를 콘솔에 출력하는 예제입니다. 이벤트 메시지 Body는 JSON 형식으로 구성되어 있습니다. 전송 결과코드(result) 항목을 통해 결과정보를 확인할 수 있습니다.

팝빌 팩스 커넥트 이벤트 메시지 구성

1) 이벤트 메시지 Body 구성
항목명 설명 타입 길이 비고
state 전송상태 코드 String 1 0 - 접수 1 - 변환중 2 - 팩스 전송중 3 - 처리완료 (전송결과 코드-result) 참조 4 - 예약건 취소
result 전송결과 코드 String 3 100 - 전송성공 503 - 통화중 300 - 발신번호 형식 오류 504 - 잘못된 수신번호 301 - 발신번호 사전 미등록 505 - 응답 없음 402 - 변환실패 506 - 수화기 들었음 405 - 비지원문서 507 - 수신거부 408 - 파일명오류 (특수문자) 508 - 콜 혼잡 413 - 지원장수초과 509 - 차단요청번호 414 - 팩스 변환실패 511 - 중복번호 415 - 팩스 변환 시간초과 512 - 시간초과 416 - 팩스파일 처리중 오류 516 - 팩스 기기 아님 498 - 기타오류로 인한 변환실패 517 - 보이스 감지 499 - 변환후 과금 실패 518 - 발신번호오류 502 - 부분완료 800 - 080 수신거부 대상 802 - 통합 수신거부 대상
sendNum 발신번호 String 20
sendDT 전송시간 String 14
corpNum 팝빌회원 사업자번호 String 10
eventType 이벤트 유형 String 30 RESULT, MANUAL(재실행)
receiveNum 수신번호 String 20
receiptNum 접수번호 String 18
sendPageCnt 전체 페이지수 Number
successPageCnt 성공 페이지수 Number
failPageCnt 실패 페이지수 Number
refundPageCnt 환불 페이지수 Number
cancelPageCnt 취소 페이지수 Number
chargePageCnt 과금 페이지수 Number
eventDT 이벤트 실행일시 String 14
serialNum 일련번호 Number
receiptDT 접수일시 String 14

커넥트 응답 메시지 구성

커넥트 이벤트 실행에 대해 수신 성공 처리를 위해서는 응답 메시지 Body 를 아래와 같이 두가지 응답 타입 중 한가지를 반환하도록 처리하면 됩니다.

유형 String 타입 JSON 타입
Body 메시지 "OK" { "result":"OK" }

커넥트 이벤트 실행내역 확인 및 재실행

정상적 커넥트 이벤트를 처리하지 못한 경우 실행내역에서 이벤트를 재실행할 수 있습니다.

1) [팝빌 사이트 로그인] > [문자·팩스] 메뉴 선택 > [팩스 - 전송 내역] 메뉴 선택

2) 재실행 할 메시지 확인 후 재실행

기술지원센터

팝빌 기술지원은 유선, 메일, 원격지원 등 다양한 채널을 통해 제공됩니다.

T. 1600-9854 E. code@linkhub.co.kr

연동문의