웹훅 트리거¶

외부 시스템이 HTTP POST 요청을 보내면 워크플로우가 실행됩니다.

설정¶

항목	설명
경로(Path)	웹훅 URL의 고유 경로

웹훅 URL¶

워크플로우를 활성화하면 고유한 웹훅 URL이 생성됩니다:

https://api.w5w.ai/webhook/{workflow_id}/{path}

호출 방법¶

외부 시스템에서 Content-Type: application/json과 함께 POST 요청을 보냅니다:

curl -X POST https://api.w5w.ai/webhook/abc123/order \
  -H "Content-Type: application/json" \
  -d '{
    "order_id": "ORD-001",
    "amount": 50000,
    "customer": "홍길동",
    "items": [
      {"name": "상품A", "qty": 2},
      {"name": "상품B", "qty": 1}
    ]
  }'

출력¶

POST Body의 JSON이 data_content로 전달됩니다:

{
  "text_content": "",
  "data_content": {
    "order_id": "ORD-001",
    "amount": 50000,
    "customer": "홍길동",
    "items": [
      {"name": "상품A", "qty": 2},
      {"name": "상품B", "qty": 1}
    ]
  }
}

참조¶

{{ $('trigger').data_content.order_id }}        → "ORD-001"
{{ $('trigger').data_content.amount }}           → 50000
{{ $('trigger').data_content.items[0].name }}    → "상품A"

응답 노드와 함께 사용¶

웹훅 트리거와 응답(Response) 노드를 함께 사용하면 HTTP 응답을 커스텀할 수 있습니다.

응답 노드가 없으면 기본 응답(200 OK)이 반환됩니다.

활용 예시¶

결제 완료 알림 처리¶

결제 시스템(토스페이먼츠 등)에서 결제 완료 시 웹훅을 호출하여 자동 처리합니다.

외부 서비스 연동 API¶

웹훅을 커스텀 API 엔드포인트처럼 활용하여 외부 서비스와 연동합니다.

주의 사항¶

활성화 필수

웹훅 트리거는 워크플로우가 활성화 상태일 때만 요청을 수신합니다.

요청 형식

현재 application/json 형식의 POST 요청만 지원합니다.