개요
모든 웹훅 이벤트는 아래 공통 구조를 사용해요.표준 Event Structure
필드 설명
최상위 필드
string
필수
이 webhook 이벤트의 고유 식별자예요. idempotency와 중복 제거에 사용하세요.
string
필수
이벤트 타입 식별자예요 (예:
note.created, note.recording.completed).string
필수
이벤트가 발생한 시각의 ISO-8601 timestamp예요. 이벤트 정렬에 사용하세요.
string
이벤트가 속한 워크스페이스의 GUID예요. 하나의 endpoint가 여러 워크스페이스의 이벤트를 받을 때 출처를 구분하는 데 사용하세요. 이벤트가 워크스페이스에 연결되지 않은 경우
null이에요.object
필수
리소스 정보를 담고 있는 이벤트별 데이터예요.
Data 오브젝트 필드
string
필수
이벤트를 발생시킨 리소스의 타입이에요. 예:
Note, NoteDocument, NoteSummary, FolderNoteRelation.string
필수
리소스의 고유 식별자예요. 라우팅과 중복 제거에 사용하세요.
object
필수
실제 리소스 데이터예요. 구조는 리소스 타입에 따라 달라지며 Tiro의 표준 스키마를 따라요.
이벤트 타입
지원하는 이벤트 타입 예시예요.Voice File Job 이벤트에는 어떤 데이터가 포함되나요?
voice_file_job.* 이벤트의 data.resource는 작업 메타데이터만 담아요. Tiro는 오디오와 전사 본문을 웹훅으로 전송하지 않아요.