연결된 기록
요금과 시간 기록이 명확할 때 설명하기 쉬울 수 있습니다.
n8n 워크플로는 팀이 이미 Workspace369에서 관리하는 클라이언트, 요청, 프로젝트, 송장, 결제, 파일 및 활동에 계속 연결됩니다.
Workspace369 n8n 통합
Workspace369 n8n 통합은 오늘날 n8n Cloud 또는 자체 서버에서 작동합니다. 유료 청구서, 승인된 제안서 또는 신규 리드는 Webhook 노드를 통해 워크플로를 시작하고, HTTP 요청 노드는 Workspace369 API를 통해 클라이언트, 청구서, 작업 및 프로젝트를 생성하거나 읽습니다.
워크플로 실행
invoice.paid
POST your-n8n.example/webhook/… → 200HTTP 요청
GET mcp.workspace369.com/v1/invoices/{id} → 200HTTP 요청
POST mcp.workspace369.com/v1/tasks → 200Workspace369 이벤트 수신, API 호출 발신
운영상의 적합성
이미 진행 중인 작업을 지원합니다
별도의 도구로 취급하는 대신 영업, 예약, 배송, 커뮤니케이션, 청구, 보고 및 회계와 함께 통합을 사용합니다.
팀 가시성
모든 역할에 동일한 그림 제공
소유자, 운영자, 재무, 지원 및 제공 팀이 분리된 시스템의 기록을 짜깁기하지 않고 무슨 일이 일어났는지 이해하도록 돕습니다.
작동 방식
n8n과 Workspace369 연동 방법
- 01
Workspace369가 트리거를 보냅니다.
설정 → 웹훅에서 이벤트를 n8n 웹훅 노드의 프로덕션 URL로 지정합니다. 각 이벤트는 서명된 JSON 형식으로 레코드 ID와 함께 도착합니다.
- 02
n8n이 워크플로를 실행합니다.
노드는 이벤트의 필드를 사용하거나, HTTP 요청 노드가 먼저 Workspace369 API에서 전체 송장, 제안 또는 클라이언트를 가져옵니다.
- 03
HTTP 요청 노드가 API를 호출합니다.
HTTP 요청 노드는 n8n 자격 증명으로 저장된 개인 액세스 토큰을 사용하여 일반 HTTPS를 통해 Workspace369 API를 호출합니다.
트리거
워크플로를 시작할 수 있는 21가지 이벤트
송장
invoice.created, invoice.paid(Paid로 이동됨) 및 invoice.status_changed.
제안서
proposal.sent, proposal.accepted 및 proposal.declined.
계약
contract.sent, contract.recipient_completed, contract.completed, contract.declined, contract.voided 및 contract.expired.
리드
lead.created, lead.converted 및 lead.archived (수신 요청용).
시간
time_entry.created, time_entry.updated, time_entry.deleted, timesheet.submitted, timesheet.approved 및 timesheet.rejected.
작업
Workspace369에서 워크플로가 할 수 있는 작업
고객
검색, 읽기, 생성 및 업데이트: GET 또는 POST /v1/clients, GET 또는 PATCH /v1/clients/{id}.
프로젝트 및 작업
POST /v1/projects 및 POST /v1/tasks로 생성하고, PATCH로 업데이트합니다.
제안서, 송장 및 계약서
POST /v1/proposals, /v1/invoices 또는 /v1/contracts로 초안을 작성하세요. 전송 호출은 토큰 소유자가 "요청 없이 전송"을 활성화하지 않은 경우 앱에서 승인할 때까지 기다립니다.
캘린더 및 요청
POST /v1/calendar/events는 이벤트를 예약하고, PATCH /v1/requests/{id}는 요청 상태를 업데이트합니다.
기타 모든 도구
POST /v1/tools/{name}은(는) payments_record 또는 time_entries_create와 같은 OpenAPI 사양의 모든 도구를 이름으로 실행합니다.
네이티브 노드
개발 중입니다. 그때까지는 웹훅 및 HTTP 요청 노드가 연결 방법입니다.
설정
n8n 설정
- 01
n8n에서 웹훅 노드 추가
웹훅 노드로 워크플로를 시작하고, 메서드를 POST로 설정하고, 프로덕션 URL을 복사합니다. 서명을 확인할 경우 원시 본문 옵션을 켭니다.
- 02
Workspace369에서 웹훅 추가
설정 → 웹훅에서 새 웹훅을 선택하고, n8n 프로덕션 URL을 엔드포인트로 붙여넣고, 이벤트를 선택한 다음 저장하세요. 서명 비밀 키를 복사하세요. 한 번만 표시됩니다. 프로덕션 URL이 활성화되도록 워크플로를 게시하세요.
- 03
개인 액세스 토큰 생성
설정 → AI 연결에서 워크플로에 필요한 범위만 있는 토큰을 생성하고 n8n의 헤더 자격 증명으로 저장하세요. 관리자가 워크스페이스에 AI 연결을 활성화해야 합니다.
- 04
HTTP 요청 노드에서 API 호출
HTTP 요청 노드 추가. 메서드와 https://mcp.workspace369.com/v1/tasks와 같은 URL을 설정하고, Authorization: Bearer 뒤에 토큰을 붙이고 필드가 포함된 JSON 본문을 보냅니다.
운영상의 적합성
팀이 맥락을 볼 수 있을 때만 연결이 유용합니다.
Workspace369는 통합을 고객 기록 가까이에 유지하여 소유자, 운영자, 재무, 지원 및 제공 팀이 별도의 도구에서 동일한 스토리를 다시 구축하지 않도록 합니다.
시스템 연결
팀이 고객, 작업, 송장 및 프로젝트의 이름을 지정하는 방식을 변경하지 않고 외부 워크플로를 Workspace369 레코드 옆으로 가져옵니다.
컨텍스트를 보이게 유지하십시오
팀이 이미 작업하고 있는 관련 상태, 이벤트, 결제, 메시지 또는 기록을 표시합니다.
작업 공간에서 행동하십시오.
클라이언트 후속 조치, 청구, 예약, 자동화, 보고 및 클라이언트 진행을 유지하기 위해 연결된 맥락을 사용하세요.
실제로
팀에서 n8n을 사용하는 이유
자체 서버에서 자체 자동화 실행
자체 호스팅 n8n은 워크플로를 사용자가 제어하는 서버에서 실행하는 반면, Workspace369는 이벤트를 보내고 여기서 API 호출을 받습니다.
다른 시스템에서 Workspace369 레코드 생성
n8n의 양식, 데이터베이스 또는 예약 도구를 사용하여 하나의 HTTP 요청 노드로 Workspace369에서 클라이언트, 프로젝트, 작업 또는 캘린더 이벤트를 생성할 수 있습니다.
모든 이벤트 확인 후 작업 수행
코드 노드를 사용하여 각 이벤트의 HMAC-SHA256 서명을 확인하므로 Workspace369가 실제로 보낸 요청에 대해서만 워크플로가 실행됩니다.
자주 묻는 질문
n8n에 대한 질문
- Workspace369 n8n 통합은 어떻게 작동하나요?
- 는 n8n의 내장 웹훅 및 HTTP 요청 노드를 n8n Cloud 또는 자체 호스팅에서 사용합니다. Workspace369 웹훅은 송장, 제안서, 계약, 리드 및 시간에 대한 21가지 이벤트를 웹훅 노드로 보내고, HTTP 요청 노드는 개인 액세스 토큰을 통해 HTTPS로 Workspace369 빌더 API를 호출합니다. 클라이언트, 프로젝트, 작업 또는 예약에 대한 이벤트는 없으며, 워크플로우는 API를 통해 해당 정보를 읽습니다. 자체 호스팅 n8n은 웹훅 URL이 표준 포트의 공개 https:// 주소인 경우 작동합니다.
- 트리거와 작업의 차이점은 무엇인가요?
- 트리거는 Workspace369에서 발생합니다. 21가지 웹훅 이벤트 중 하나가 워크플로를 시작합니다. 작업은 반대로 작동합니다. HTTP 요청 노드는 API를 통해 클라이언트, 프로젝트, 작업, 송장, 제안서, 계약서 및 캘린더 이벤트를 생성, 업데이트 또는 읽습니다. 제안서, 계약서 또는 송장을 보내면 202를 반환하고 토큰 소유자가 "요청 없이 보내기"를 활성화하지 않는 한 앱에서 사람이 승인할 때까지 기다립니다.
- 어떤 Workspace369 요금제가 필요한가요?
- Specialist($149/월, 좌석 10개) 이상. 웹훅 트리거와 빌더 API 모두 Specialist가 필요합니다. Cadet 및 Voyager에서는 관리자가 AI 연결을 활성화하면 워크플로가 MCP 도구/호출을 통해 동일한 도구를 호출할 수 있지만 웹훅 트리거는 받을 수 없습니다.
- n8n 워크플로에서 AI 사용량을 사용하나요?
- API 또는 MCP를 통해 실행되는 Zapier, Make 또는 n8n의 각 작업은 워크스페이스의 AI 사용량을 약간 사용합니다. 읽기는 쓰기 및 전송보다 적게 사용합니다. 실패한 호출 및 웹훅 트리거는 사용하지 않습니다.
- n8n에서 웹훅 서명을 어떻게 확인하나요?
- 웹훅 노드의 원시 본문 옵션을 켜고 코드 노드를 추가합니다. 원시 본문과 X-Webhook-Timestamp 헤더를 결합한 HMAC-SHA256의 16진수 값을 계산하고, 전체 whsec_ 서명 비밀 키를 사용하여 키를 지정하고, X-Webhook-Signature와 비교합니다. 웹훅 노드는 이를 자동으로 확인하지 않습니다.
- n8n에 Workspace369 노드가 있나요?
- 아직입니다. 네이티브 n8n 노드가 개발 중입니다. 준비될 때까지는 이 페이지에 설명된 대로 내장 웹훅 및 HTTP 요청 노드가 두 가지를 연결합니다.
계속 탐색