이 기능이란 무엇이며 어떤 용도로 사용되나요?
n8n, Make 또는 Zapier를 사용하여 PaperOffice AI를 다른 시스템과 연결합니다. 이 도구들의 표준 구성 요소인 REST API로의 HTTP 요청과 웹훅을 사용합니다. n8n은 MCP 클라이언트를 통해 PaperOffice MCP 서버에도 연결할 수 있습니다. 워크플로우 에이전트의 웹훅 대상은 Professional 플랜부터 이용 가능합니다.
작동 방식
- API 키 페이지에서 키를 생성합니다. HTTP 노드에 Bearer 토큰으로 입력하세요.
- REST API를 호출하여 예를 들어 파일을 업로드하거나 검색합니다. 엔드포인트에 대해서는 API 문서를 참조하세요.
- 결과를 받으려면 Workflow AI → Workflow Agents로 이동하여 저장된 에이전트를 편집하고 웹훅 탭을 선택하세요.
- 웹훅 대상 추가를 클릭합니다. n8n, Make 또는 Zapier의 웹훅 주소를 타겟 URL로 입력하세요.
- 전송 시점에서 작업 성공, 작업 실패 또는 둘 다를 선택하세요.
- 사람의 검토를 위해 흐름이 검토 작업을 생성하고 웹훅을 기다립니다. task.completed 이벤트는 Workflow AI → Human In The Loop Tasks의 결정을 보고합니다.
알아두면 좋은 사항
- 각 성공적인 웹훅 전송에는 요금이 부과됩니다. 재시도, 테스트 이벤트 및 실패한 전송은 무료입니다.
- API 호출에는 요금이 부과됩니다.
- {trigger.pofid}와 같은 플레이스홀더는 경로, 쿼리 및 헤더에 허용되지만 호스트 이름에는 허용되지 않습니다.
- PaperOffice에서의 웹훅은 X-PaperOffice-Signature 헤더에 서명됩니다. 흐름에서 이를 확인하세요.
- Make와 Zapier의 경우 해당 HTTP 및 웹훅 모듈을 사용하세요.
자세히 보기: paperoffice.ai의 통합.