트리거 종류
트리거는 워크플로우의 시작점입니다. SSemWorks 는 6가지 트리거를 지원합니다.
| 트리거 | 노드 | 시작 방식 | 활성화 필요 |
|---|---|---|---|
| 수동 | 수동 트리거 | 에디터의 실행 버튼(⌘Enter) | 아니오 |
| 스케줄 | 스케줄 트리거 | interval/cron 주기 발화 | 예 |
| 웹훅 | 웹훅 | 외부 HTTP 호출 | 예 (Test URL 은 저작 중 테스트) |
| 폼 | 폼 트리거 | 웹 폼 렌더 → 제출 | 예 |
| 텔레그램 | 텔레그램 트리거 | 봇으로 수신되는 메시지 | 예 |
| 에러 | 에러 트리거 | 다른 워크플로우 실패 시 | 예 |
스케줄 트리거
- interval(초/분/시/일/주 간격)과 cron 식 을 지원합니다. cron 은
0 9 * * MON-FRI처럼 요일/월 이름 토큰도 사용할 수 있습니다. - 비활성(disabled) 처리한 트리거 노드는 발화하지 않습니다.
- 발화 시각(위상)은 서버 재시작을 넘어 유지됩니다 — 재시작 주기가 스케줄 간격보다 짧아도 장주기 스케줄이 유실되지 않습니다.
웹훅·폼·텔레그램
외부 유입 트리거는 모두 트리거 게이트웨이(works-open) 를 거칩니다. URL·인증·응답 모드·폼 다단계는 웹훅과 폼에서 다룹니다. 텔레그램 트리거는 워크플로우 활성화 시 봇에 웹훅(setWebhook)을 자동 등록합니다.
에러 트리거 (에러 워크플로우)
워크플로우 실패 시 지정한 에러 워크플로우를 자동 실행할 수 있습니다.
- 에러를 받을 워크플로우를 만들고 시작점에 에러 트리거 노드를 둡니다. 활성화합니다.
- 감시 대상 워크플로우의 설정(settings)에서 errorWorkflow 로 위 워크플로우를 지정합니다.
- 대상 워크플로우가 실패하면 에러 워크플로우가 실행되며, 페이로드로 실패 실행 정보(
execution.id/mode/error)와 워크플로우 정보(workflow.id/name)가 전달됩니다.
- 자기 자신을 에러 워크플로우로 지정한 경우와 비활성 에러 워크플로우는 건너뜁니다.
- 에러 워크플로우 자신의 실패는 다시 에러 워크플로우를 발화시키지 않습니다(무한 연쇄 방지).
실행 mode
실행이 어떤 경로로 시작됐는지가 실행 이력의 mode 로 기록됩니다.
| mode | 시작 경로 |
|---|---|
manual | Studio 에디터의 수동 실행 |
webhook | 웹훅/폼 외부 호출 |
trigger | 스케줄 발화 |
integrated | 부모 워크플로우가 실행한 서브워크플로우 |
error | 에러 워크플로우 발화 |
실행 목록과 Insights 집계에서 mode 로 구분됩니다(예: Insights 는 프로덕션 실행만 집계 — manual 제외).