> ## Documentation Index
> Fetch the complete documentation index at: https://docs.platform.nora.my/llms.txt
> Use this file to discover all available pages before exploring further.

# Trigger 블록

> Flow 시작 방식 — 채팅, 웹훅, 스케줄, 이벤트.

**Trigger 블록** 은 Flow 의 진입점입니다. 실행이 *어떻게* 시작되는지와 *어떤 페이로드* 가 첫 Agent 로 들어가는지 정의합니다.

모든 Flow 는 최소 하나의 Trigger 가 필요합니다. 여러 개도 가능 — 같은 Flow 가 채팅 UI, 웹훅, 야간 스케줄을 동시에 서빙할 수 있습니다.

## Trigger 종류

### 채팅 Trigger

기본 — Nora 대시보드, 공유된 워크스페이스 채팅 링크, 또는 임베드에서 Flow 를 채팅 인터페이스로 표면화. 각 턴은 같은 세션 안에 새 실행을 만듭니다.

설정:

* **Public link** — 온/오프. 켜면 공유 가능한 URL 생성 (워크스페이스에 인증 게이트).
* **Anonymous access** — 온/오프. 기본 오프. 오프면 로그인 필요.
* **Session memory** — 유지할 컨텍스트 턴 수. 기본 20.

### 웹훅 Trigger

Flow 를 HTTP 엔드포인트로 만듭니다. JSON 을 POST 할 수 있는 무엇이든 호출 가능.

받게 되는 것:

* URL: `https://api.platform.nora.my/flows/{slug}/trigger`
* 서명 시크릿. 매 요청에 `X-Nora-Signature` 로 포함.

POST 본문이 Trigger 의 출력 페이로드가 됩니다 — 첫 Agent 가 입력으로 받습니다.

### 스케줄 Trigger

Flow 를 크론 스케줄로 실행.

* **Cron 표현식** — 표준 5필드, `@daily` / `@hourly` 축약 지원.
* **Timezone** — 워크스페이스 타임존이 기본.
* **Payload 템플릿** — 첫 Agent 로 보낼 정적 JSON 페이로드 (스케줄 실행 파라미터화에 유용).

Flow 가 언퍼블리시되면 스케줄은 자동으로 일시정지.

### 이벤트 Trigger

Nora 내부 이벤트에 발화: 새 문서 인제스트, 피드백 추가, 시그널 열림, 승인 결정. 시스템 활동에 반응하는 메타-Flow 에 유용.

## 서명 (웹훅)

Trigger 인스펙터에서 언제든 서명 시크릿을 로테이션 가능. 60분 유예 기간 동안은 이전 서명도 허용되어 호출자를 다운타임 없이 업데이트 가능.

호출자에서 검증:

```python theme={null}
import hmac, hashlib
signature = hmac.new(secret.encode(), request.body, hashlib.sha256).hexdigest()
assert signature == request.headers["X-Nora-Signature"]
```

## 요율 제한

Trigger 별 요율 제한 (RPS + 동시 실행). 제한 초과 요청은 `429`. 인스펙터 → **Limits** 에서 조정.

## 여러 Trigger

각 Trigger 를 다른 시작 Agent 로 배선하거나 하나로 수렴시키세요. Agent 의 입력 스키마는 받을 수 있는 모든 페이로드 모양을 다뤄야 합니다 — 페이로드에 `type` 판별자를 두는 것이 흔한 패턴.