Skip to main content
Trigger 가 Flow 시작 방식. 세 종류: api (SDK/CLI 에서 호출), webhook (외부 HTTP POST), schedule (크론 기반).

명령

triggers create

플래그:
  • --kind (필수) — api / webhook / schedule.
  • --name <n> — 표시 이름.
  • --config <json> — 특정 종류용 인라인 설정.
  • --x <n>, --y <n> — 캔버스 위치.
명령이 생성된 Trigger 의 ID 인쇄 (그리고 webhook/api 에는 초기 시크릿 — 지금 복사; 한 번만 표시).

triggers update

Update 플래그가 큼 — 아래 그룹핑.

Update 플래그 — 그룹핑

정체성
  • --set-name <n>
  • --set-kind api|webhook|schedule
  • --set-x <n>, --set-y <n>, --set-width <n>
Schedule 설정 (kind = schedule)
  • --set-schedule-mode preset|cron
  • --set-cron <expr> — mode = cron 용, 예: "0 9 * * *".
  • --set-period daily|weekly|monthly|yearly — mode = preset 용.
  • --set-time HH:MM — preset 용.
  • --set-day-of-week 1..7 — weekly 용.
  • --set-day-of-month 1..31 — monthly 용.
  • --set-month-of-year 1..12 — yearly 용.
  • --set-interval <n> — 간격 카운트.
  • --set-timezone <IANA> — 예: America/Los_Angeles.
  • --set-schedule-input <text> — 스케줄 실행당 주입되는 페이로드.
  • --set-schedule-thread-id <id> — 채팅 Agent 용, 게시할 스레드.
  • --set-schedule-user-id <id> — 사용자 귀속.
  • --set-schedule-tts true|false — text-to-speech 입력으로 다룸.
Webhook 설정 (kind = webhook)
  • --set-webhook-slug <s> — 경로 접미사 (URL 이 .../trigger/webhook/<slug> 됨).
  • --set-webhook-input-path <json-path> — 본문에서 입력 추출.
  • --set-webhook-image-path <json-path> — 이미지 데이터 추출.
  • --set-webhook-audio-path <json-path> — 오디오 데이터 추출.
  • --set-webhook-auth-kind <k>none / secret / header.
  • --set-webhook-auth-header <name>header auth 의 헤더 이름.
API 설정 (kind = api)
  • --set-api-slug <s> — 경로 접미사.
  • --set-api-auth-kind <k>none / secret / header.
  • --set-api-auth-header <name>.
벌크
  • --patch <json> — 임의 병합.
설정 패치가 기존 설정에 deep-merge.

triggers edit

$EDITOR 에 전체 JSON. 저장으로 적용.

triggers delete

triggers secret rotate

새 서명 시크릿 발급. 평문 한 번 인쇄 — 호출자에 복사. 이전 시크릿이 60분간 계속 동작해 다운타임 없이 호출자 업데이트 가능. 스케줄로 로테이션 (분기별 흔함), 또는 누출 의심 즉시.

레시피

매일 오전 9시 서울 시간 스케줄 추가

Flow 배포 — 스케줄 발화 시작.

CMS 용 웹훅 트리거 추가

웹훅 URL: https://api.platform.nora.my/trigger/webhook/<flow-slug>/cms. X-Nora-Signature 로 POST 하도록 CMS 설정.

preset 스케줄을 cron 으로 전환

Cron 이 preset 보다 표현력 있음 — daily/weekly/monthly 패턴 넘는 모든 것에 사용.

웹훅이 추출하는 입력 경로 변경

옛 CMS 모양: { "body": "..." } — 경로 body. 새 모양: { "message": { "body": "..." } }:
변경 라이브 위해 Flow 배포.