
프로덕션 배포 전에 권한 부여, 문서 준비, 결과 처리, 통제된 출시 테스트에 대한 결정 사항과 함께 팩스 API 연동 범위를 정하세요.
애플리케이션에 팩스를 추가할 때는 실무적인 질문에서 출발합니다. 문서를 팩스 번호로 보내야 할 때, 또는 팩스가 도착했을 때 애플리케이션은 무엇을 해야 할까요? 유용한 프로덕션 계획은 엔드포인트를 선택하기 전에 이 질문에 먼저 답합니다.
이 체크리스트는 개발자가 팩스 워크플로를 범위가 정해진 연동 개요서로 정리하는 데 도움이 됩니다. 최신 문서와 함께 활용하고, 가장 작은 단위의 완전한 워크플로부터 구축하고 검증하세요.
시작점과 결과가 분명한 워크플로를 첫 대상으로 선택하세요. 발신 워크플로는 애플리케이션에서 승인된 문서로 시작할 수 있습니다. 수신 워크플로는 완전히 수신된 팩스를 가져올 수 있게 되었을 때 시작할 수 있습니다.
원본 문서, 발신 또는 수신 번호, 애플리케이션 레코드, 다음 작업을 기록해 두세요. 애플리케이션에 고유한 비즈니스 참조 값을 부여하면, 담당자가 파일 이름에만 의존하지 않고 팩스 활동을 올바른 작업과 연결할 수 있습니다.
공급업체 구매 주문 팩스 워크플로는 애플리케이션에 비즈니스 참조 값과 별도의 확인 단계가 필요한 이유를 보여 줍니다.
완료의 기준을 신중하게 정의하세요. 팩스 전송 성공은 전송 계층의 결과입니다. 수신자가 문서를 검토하거나 요청을 수락하는 것은 별개의 업무 단계입니다. 애플리케이션의 레이블에도 이러한 구분이 유지되어야 합니다.
자격 증명을 선택하기 전에, 누가 팩스 계정을 운영하고 출시 후에도 이를 책임질지 결정하세요. 내부 통합이라면 자사 조직이 될 수 있습니다. 다른 기업을 위한 소프트웨어를 만드는 경우에는 각 고객이 직접 관리하는 계정을 연결할지, 아니면 다른 방식이 필요한지 확인하세요. 이 구성은 확정하기 전에 Fax.Plus와 함께 검토하세요.
통합 계획서에 다음과 같은 담당 업무를 기재하세요:
번호 할당은 별도의 결정이 필요합니다. Fax.Plus는 기존 계정 번호를 기업 사용자에게 할당하고 해당 할당을 취소하는 API 작업을 문서화하고 있습니다. 어떤 사용자에게 액세스가 필요한지, 그리고 누가 변경 권한을 갖는지 계획하세요. 최신 사전 요건과 역할은 번호 할당 가이드를 참고하세요.
정해 둔 워크플로에 맞춰 Fax.Plus API 액세스 및 연동 옵션을 검토하세요. API 액세스에는 Enterprise가 필요하며, 일반 팩스 요금이 적용됩니다. 테스트를 실행하기 전에 예상 발신·수신 사용량, 필요한 번호, 테스트 방식을 팀과 확인하세요.
인증 문서에서는 Personal Access Token과 OAuth 2.0 Authorization Code 인증을 다룹니다. PAT는 Fax.Plus 사용자가 선택한 스코프로 생성합니다. OAuth는 사용자가 로그인하여 애플리케이션을 명시적으로 승인하는 방식입니다. 설정이 가장 빠른 방법을 고르기보다는, 계정을 어떻게 연결하고 유지 관리할지를 기준으로 방식을 선택하세요.
애플리케이션에 필요한 작업을 나열한 다음 관련 권한을 선택하세요. 통합을 실제로 실행할 계정과 역할로 테스트하고, 허용되지 않아야 하는 요청도 포함하세요. 자격 증명 처리는 애플리케이션의 승인된 보안 절차 안에서 진행하세요.
PAT 기반 통합의 경우 토큰의 소유자와 만료, 교체, 폐기를 처리할 담당자를 기록하세요. 토큰은 사용자별로 관리됩니다. 현재 PAT 관리 가이드에 따르면 관리자는 다른 구성원의 PAT를 직접 폐기할 수 있는 셀프 서비스 제어 기능이 없습니다. 이 한계를 오프보딩 절차에 포함하세요.

팩스 발신의 경우, 어떤 애플리케이션 구성 요소가 최종 문서를 준비하고, 페이지 순서를 확인하며, 수신 번호를 제공할지 결정하세요. 구현 순서는 API 빠른 시작을 참고하세요. 새 문서를 업로드하면 발송 요청에 사용할 수 있는 경로가 반환됩니다.
해당 제출 건을 애플리케이션의 비즈니스 참조 값 및 API가 반환하는 추적 식별자와 연결해 두세요. 수락된 발송 요청은 Outbox 항목을 생성하지만, 이것이 전달 결과는 아닙니다. 전송 결과가 확인될 때까지는 적절한 진행 중 상태를 표시하세요.
수신 팩스의 경우, 가져온 문서가 어디로 가야 하는지와 애플리케이션이 관련 레코드를 식별하는 방법을 명시하세요. 대상을 확실하게 정할 수 없을 때를 위한 검토 단계도 포함하세요.
결과 처리 경로를 연동 계획의 일부로 수립하세요. 웹훅 문서에서 사용 가능한 이벤트와 전달 방식을 설명합니다. 발신 이벤트는 성공 또는 실패를 나타낼 수 있으므로, 애플리케이션이 보고된 상태를 해석해야 합니다.
각 결과에 따라 어떤 애플리케이션 상태와 담당자 알림이 이어질지 합의하세요. 예를 들어 전송에 성공하면 발송 작업을 종료하되, 수신자의 응답을 기다리는 별도 작업은 열어 둘 수 있습니다. 실제 업무 프로세스에 맞는 표현을 사용하세요.
테스트 계획에 통제된 중단 상황을 포함하세요. 다른 발송을 시작하기 전에 애플리케이션이 팩스 레코드를 어떻게 조정하고 작업을 재개하는지 확인하세요.
이벤트 검증, 복구, 상태 확인 동작에 대한 세부 사항은 구현 명세서에 정리하세요. 계획 단계에서 정할 사항은 어느 시스템이 작업 상태를 관리하고, 해결되지 않은 결과를 누가 조사하는지입니다.
Fax.Plus는 현재 공개 샌드박스를 제공하지 않습니다. 영업팀이 사용 사례를 검토한 후 자격이 되면 임시 Enterprise 액세스나 기타 테스트 옵션을 마련해 드릴 수 있습니다. API 테스트 안내부터 확인하세요.
파일럿을 실행하기 전에 승인된 계정, 테스트 기간, 사용 가능한 번호, 이용 조건, 그리고 평가가 끝난 후 어떻게 되는지 확인하세요. 유료 서비스로 전환하기 전에 조직의 구매 승인이 필요하다면, 승인권자와 통합을 계속 운영하는 데 필요한 절차를 파악해 두세요.
통제된 문서와 합의된 테스트 수신처를 선택하세요. 문서 준비, 제출, 결과 처리, 그리고 해당되는 경우 수신 문서 가져오기까지 순서대로 점검하세요. 적용되는 파일 및 발송 조건은 최신 문서에서 확인하고, 배포 전에 예상 트래픽 패턴을 논의하세요.
누구든 검증할 수 있는 인수 기준을 기록하세요. 올바른 문서가 합의된 수신처에 도착하고, 결과가 애플리케이션 레코드와 연결되며, 지정된 운영 담당자가 실패한 시도를 해결할 수 있어야 합니다. 테스트를 거친 워크플로를 갖추고 운영 책임자를 지정한 상태로 출시한 다음, 추가 사용 사례가 검증되는 대로 연동 범위를 넓혀 가세요.
시나리오, 예상 결과, 관찰된 결과, 증빙 자료, 후속 조치 담당자를 담은 간단한 테스트 기록을 유지하세요. 실패한 팩스, 확정되지 않은 결과, 자격 증명 또는 권한 변경도 포함하세요. 누군가 테스트를 완료하고 결과를 기록하기 전까지는 해당 테스트를 미실행 상태로 두세요.
워크플로 트리거, 문서 출처, 팩스 번호, 애플리케이션 레코드, 권한 부여 모델, 예상 사용량, 완료 기준을 포함하세요. 예외를 처리할 담당자와 전송 결과 이후에 이어질 업무 단계도 명시하세요.
제출 또는 처리 중임을 나타내는 상태를 사용하세요. 전송 결과가 확인되면 상태를 업데이트하고, 필요한 수신자 응답은 별도의 업무 단계로 추적하세요.
통제된 문서와 합의된 수신처를 사용하여 전체 워크플로를 검증하세요. 담당자가 각 결과를 애플리케이션 레코드에 연결할 수 있는지, 그리고 전송에 실패한 경우 합의된 절차를 따를 수 있는지 확인하세요.
예정된 워크플로와 테스트 요구 사항을 영업팀에 문의하세요. Fax.Plus는 현재 공개 샌드박스를 제공하지 않지만, 자격이 되는 프로젝트에는 임시 Enterprise 액세스나 기타 테스트 방식을 제안할 수 있습니다. 테스트 팩스를 보내기 전에 범위와 조건을 확인하세요.
애플리케이션이 계정에 연결되는 방식과 액세스를 관리하는 방식에 따라 선택하세요. PAT는 사용자가 선택한 스코프로 생성합니다. OAuth는 사용자가 애플리케이션을 승인해야 합니다. 최신 인증 문서를 검토하고, 선택한 방식을 실제로 사용할 계정과 역할로 테스트하세요.
