웹훅 노드
한눈에 보기
웹훅 노드는 외부 시스템이 보내는 HTTP 요청을 수신하여 데이터를 처리합니다. 고유한 웹훅 URL이 자동 생성되며, 수신된 JSON 페이로드를 워크플로우 변수에 매핑하여 후속 처리에 활용합니다.
소개
API 호출 노드가 "VEXPLOR → 외부"라면, 웹훅 노드는 "외부 → VEXPLOR" 방향입니다. 외부 시스템에서 이벤트가 발생하면 VEXPLOR의 웹훅 URL로 데이터를 푸시합니다.
활용 예시:
- ERP → VEXPLOR: 구매 발주 승인 시 자재 입고 준비 프로세스 시작
- IoT 플랫폼 → VEXPLOR: 센서 데이터 수집 및 이상 감지
- 외부 검사기관 → VEXPLOR: 검사 결과 수신
- 물류사 → VEXPLOR: 배송 상태 업데이트
이렇게 보입니다
설정 화면
웹훅 노드 설정
웹훅 URL
https://api.vexplor.io/webhook/abc123-def456-ghi789
인증
API Key
X-Webhook-Key
wh_••••••••••••
페이로드 매핑
아래 참조
URL 생성 결과
웹훅 노드를 생성하면 고유한 URL이 자동으로 할당됩니다. 이 URL을 외부 시스템에 등록합니다.
페이로드 매핑
수신된 JSON의 필드를 워크플로우 변수에 매핑합니다:
페이로드 매핑
수신 JSON 예시
{
"order_id": "PO-2026-001",
"status": "approved",
"items": [
{ "item_code": "MAT-001", "qty": 100 }
]
}
매핑 설정
| JSON 경로 | 워크플로우 변수 | |
|---|---|---|
| $.order_id | → | {발주번호} |
| $.status | → | {발주상태} |
| $.items[0].item_code | → | {품목코드} |
| $.items[0].qty | → | {수량} |
설정 방법
- 캔버스에서 웹훅 노드를 배치합니다.
- 더블 클릭하면 웹훅 URL이 자동 생 성됩니다.
- 인증 방식을 설정합니다 (API Key 권장).
- 페이로드 매핑을 설정합니다.
- 생성된 URL을 외부 시스템에 등록합니다.
웹훅 테스트
설정 화면의 "테스트 전송" 기능으로 샘플 JSON을 보내 매핑이 정확한지 확인할 수 있습니다. curl 명령어 예시도 제공됩니다.
보안 주의
웹훅 URL은 인터넷에 노출되므로 반드시 **인증(API Key 또는 Bearer Token)**을 설정하세요. 인증 없이 운영하면 악의적인 요청으로 워크플로우가 비정상 실행될 수 있습니다.
실무 예시: ERP 발주 승인 연동
시나리오: ERP에서 구매 발주가 승인되면 웹훅으로 VEXPLOR에 알려 입고 준비 워크플로우 실행
- VEXPLOR에서 웹훅 노드 생성 → URL 복사
- ERP 시스템에 웹훅 URL 등록 (발주 승인 이벤트)
- ERP에서 발주 승인 시 JSON 페이로드 전송
- VEXPLOR 웹훅이 수신하여 워크플로우 시작
웹훅 수신 (ERP 발주 승인)
▼
발주 정보 저장 (자동 작업)
▼
입고 예정 등록 (자동 작업)
▼
입고 담당자 알림 (인앱 알림)
▼
◎ 종료
다음 단계
- API 호출 노드 — VEXPLOR에서 외부 시스템 호출
- 시작 이벤트 - 웹훅 트리거 — 웹훅으로 워크플로우 시작