Pactery와 사건 관리 시스템 연동 방법
Last Modified
Pactery와 사건 관리 시스템의 연동은 특정 프로그램을 선택하면 바로 연결되는 기본 기능으로 단정할 수 없습니다. 자동으로 문서를 생성하거나 서명 완료 상태를 사건에 반영하려면 양쪽 시스템의 API·웹훅 지원 범위를 확인해 별도 개발해야 합니다.
개발 전에 사건번호, 의뢰인, 문서 종류, Pactery 문서 ID를 어떤 필드로 연결할지 정해야 합니다. 이 기준이 없으면 연동 후에도 같은 사건의 문서를 찾기 어렵습니다.
기본 연동과 개발 연동 구분
먼저 현재 Pactery 개발자 문서와 계정 권한에서 문서 생성·조회, 서명 요청, 상태 조회, 완료 파일, 웹훅 중 필요한 기능이 제공되는지 확인합니다. 사건 관리 시스템도 외부 API 호출과 문서 링크 저장을 지원해야 합니다.
기본 기능이 확인되지 않은 Zapier나 특정 사건관리 프로그램을 연동 가능하다고 안내해서는 안 됩니다. 개발 없이 함께 쓸 때는 사건 관리 시스템에 Pactery 문서 링크를 남기는 수동 연결부터 시작할 수 있습니다.
사건번호와 문서 ID 매핑
사건번호를 양쪽 시스템의 공통 키로 쓰고 의뢰인 ID, 문서 종류, 서명 상태, 완료일, Pactery 문서 ID를 연결합니다. 문서 제목에 사건번호를 넣는 방식은 검색에는 도움이 되지만 이름 변경에 취약하므로 개발 연동에서는 고유 ID를 함께 저장하는 편이 좋습니다.
수임계약서, 위임장, 합의서가 한 사건에 여러 개 존재할 수 있다는 점도 반영해야 합니다. 문서별 최신 버전과 완료본 위치를 구분하지 않으면 초안 링크가 사건 기록에 남을 수 있습니다.
웹훅 실패와 개인정보 보호 설계
서명 완료 이벤트를 받는다면 중복 수신, 지연, 실패 재시도, 수동 재처리 방법을 정합니다. 웹훅 한 번을 놓쳤다고 사건 상태가 영구히 어긋나지 않도록 주기적인 상태 대조도 검토하세요.
API 키는 담당자 PC나 문서에 적지 말고 서버 비밀값으로 보관하고 최소 권한을 사용합니다. 의뢰인 개인정보와 사건 내용을 어느 시스템에 복제할지, 접근 기록과 삭제 기준은 무엇인지도 연동 범위에 포함해야 합니다.