메인 콘텐츠로 건너뛰기

​
개요

모든 webhook 이벤트는 일관된 payload 구조를 따라요. 이 문서는 모든 이벤트 타입에 공통으로 사용되는 표준 형식을 설명해요.

​
표준 Event Structure

​
필드 설명

​
최상위 필드

​
id
string
필수
이 webhook 이벤트의 고유 식별자예요. idempotency와 중복 제거에 사용하세요.
​
type
string
필수
이벤트 타입 식별자예요 (예: note.created, note.recording.completed).
​
createdAt
string
필수
이벤트가 발생한 시각의 ISO-8601 timestamp예요. 이벤트 정렬에 사용하세요.
​
data
object
필수
리소스 정보를 담고 있는 이벤트별 데이터예요.

​
Data 오브젝트 필드

​
data.resourceType
string
필수
이벤트를 발생시킨 리소스의 타입이에요. 예: Note, NoteDocument, NoteSummary, FolderNoteRelation.
​
data.resourceId
string
필수
특정 리소스 인스턴스의 고유 식별자예요. 빠른 라우팅과 idempotency에 사용하세요.
​
data.resource
object
필수
실제 리소스 데이터예요. 구조는 리소스 타입에 따라 달라지며 Tiro의 표준 스키마를 따라요.

​
이벤트 타입

이벤트 타입은 발생한 특정 동작을 식별해요. 다음은 몇 가지 예시예요. 
"note.created"
"note.deleted"
"note.user_content.updated"
"note.recording.completed"
"note.ended"
"note.participants.updated"
"note_document.generated"
"note_document.updated"
"note_document.deleted"
"note_summary.generated"
"note_summary.updated"
"note_summary.deleted"
"folder.note.added"
"folder.note.removed"

​
리소스 타입 매핑

Event TypeResource TypeSchema Reference
note.*NoteNote API
note_document.*NoteDocumentNoteDocument Events
note_summary.*NoteSummaryNoteSummary Events
folder.*FolderNoteRelationFolderNote Events