트리거 노드¶

트리거(Trigger)는 워크플로우의 시작점입니다. 모든 워크플로우는 하나의 트리거 노드를 가지며, 트리거 조건이 충족되면 워크플로우가 실행됩니다.

수동 실행 (Manual)¶

사용자가 직접 실행 버튼을 클릭하거나 API를 호출하여 워크플로우를 시작합니다.

설정¶

항목	설명
테스트 데이터	JSON 형식의 입력 데이터

{
  "name": "홍길동",
  "request": "서비스 해지 요청"
}

용도¶

개발 중 테스트 실행
일회성 작업 (데이터 마이그레이션, 보고서 생성 등)
외부 시스템에서 API로 호출

스케줄 (Scheduled)¶

Cron 표현식으로 워크플로우를 주기적으로 실행합니다.

설정¶

항목	설명	예시
Cron 표현식	실행 주기 정의	`0 9 * * *`

자주 사용하는 Cron 표현식¶

표현식	의미
`/5 * * *`	5분마다
`0 * * * *`	매시간 정각
`0 9 * * *`	매일 오전 9시
`0 9 * * 1-5`	평일 오전 9시
`0 9 * * 1`	매주 월요일 오전 9시
`0 0 1 * *`	매월 1일 자정

용도¶

정기 보고서 생성 및 발송
주기적 데이터 수집/모니터링
일일 백업/정리 작업

활용 예시¶

매일 오전 9시 매출 보고서 자동 생성:

웹훅 (Webhook)¶

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

설정¶

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

웹훅 URL¶

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

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

호출 방법¶

외부 시스템에서 POST 요청을 보냅니다:

curl -X POST https://api.w5w.ai/webhook/abc123/order \
  -H "Content-Type: application/json" \
  -d '{
    "order_id": "ORD-001",
    "amount": 50000,
    "customer": "홍길동"
  }'

POST Body의 JSON이 트리거의 data_content로 전달됩니다.

용도¶

결제 시스템 알림 수신 (결제 완료, 환불 등)
외부 서비스 이벤트 처리
커스텀 API 엔드포인트 구성

활용 예시¶

주문 접수 자동 처리:

응답 노드

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

앱 이벤트 (App Event)¶

외부 서비스의 이벤트를 감지하여 워크플로우를 실행합니다.

Gmail¶

새 이메일이 수신되면 워크플로우를 실행합니다.

설정	설명
인증 정보	Google OAuth 인증 (자동 연결)
폴링 간격	이벤트 확인 주기 (기본 60초)

출력 데이터:

{
  "text_content": "이메일 본문 내용",
  "data_content": {
    "from": "sender@example.com",
    "subject": "문의드립니다",
    "date": "2026-03-05T10:30:00Z",
    "attachments": [...]
  }
}

활용 예시:

Google Sheets¶

스프레드시트에 변경이 감지되면 워크플로우를 실행합니다.

설정	설명
인증 정보	Google OAuth 인증
스프레드시트 ID	모니터링할 스프레드시트

Google Drive¶

파일이 추가/수정되면 워크플로우를 실행합니다.

설정	설명
인증 정보	Google OAuth 인증
폴더 ID	모니터링할 폴더 (선택, 미지정 시 전체)

Telegram¶

Telegram 봇으로 메시지가 수신되면 워크플로우를 실행합니다.

설정	설명
인증 정보	Telegram Bot Token

출력 데이터:

{
  "text_content": "사용자가 보낸 메시지",
  "data_content": {
    "chat_id": 123456789,
    "from": {
      "first_name": "홍길동",
      "username": "honggildong"
    },
    "message_type": "text"
  }
}

활용 예시:

폴링 vs 웹훅

Gmail, Google Sheets, Google Drive: 폴링 방식. 설정된 간격(기본 60초)으로 변경을 확인합니다.
Telegram: 웹훅 방식. 이벤트 발생 시 즉시 수신합니다.

트리거 출력¶

트리거 노드의 출력은 다음 노드에서 변수로 참조할 수 있습니다:

{{ $('trigger').data_content.필드명 }}
{{ $('trigger').text_content }}

수동 실행웹훅GmailTelegram

사용자가 입력한 테스트 데이터가 그대로 전달됩니다.

{
  "text_content": "",
  "data_content": {
    "name": "홍길동",
    "request": "서비스 해지 요청"
  }
}

POST 요청의 Body가 전달됩니다.

{
  "text_content": "",
  "data_content": {
    "order_id": "ORD-001",
    "amount": 50000
  }
}

수신된 이메일 정보가 전달됩니다.

{
  "text_content": "이메일 본문 내용",
  "data_content": {
    "from": "sender@example.com",
    "subject": "문의드립니다",
    "date": "2026-03-05T10:30:00Z"
  }
}

수신된 메시지 정보가 전달됩니다.

{
  "text_content": "사용자 메시지",
  "data_content": {
    "chat_id": 123456789,
    "from": {"first_name": "홍길동"}
  }
}

다음 단계¶

AI 에이전트 노드 — 트리거 데이터를 AI로 처리
스킬 노드 — 트리거 데이터를 스킬로 직접 처리
변수 시스템 — 트리거 출력을 변수로 참조