개요
Note 리소스에 대한 webhook 이벤트예요. 모든 note 이벤트는resourceType: "Note"를 사용해요.
이벤트 상세
note.created
- 실시간 음성 노트 녹음을 시작할 때
- 녹음 파일로부터 노트를 생성할 때
note.deleted
- 사용자가 노트를 영구적으로 삭제할 때
note.recording.completed (녹음 일시정지)
- 실시간 녹음을 일시정지하고, 그 시점까지의 오디오 처리와 텍스트 변환, 문단 생성이 끝났을 때 발생해요
- 한 회의에서 녹음을 여러 번 일시정지할 수 있으므로 같은 노트에서 여러 번 발생할 수 있어요
- 이벤트 이름에는
completed가 남아 있지만, 노트가 끝났다는 뜻은 아니에요. 노트의 최종 종료는note.ended로 확인하세요
note.user_content.updated
- 사용자가 노트 내용을 직접 편집할 때
note.ended
- 노트의 모든 처리가 끝나면 발생해요
note.recording.completed와 달리 노트마다 한 번만 발생해요
note.participants.updated
- 노트에서 회의 참가자가 추가되거나 제거될 때 발생해요
- 기존 참가자의 이름이나 이메일이 변경될 때는 발생하지 않아요
resource필드에는 업데이트된participants배열을 포함한 전체 Note 오브젝트가 담겨요
Payload 예시
리소스 데이터
Note 이벤트에는 완전한 Note 리소스 데이터가 포함돼요. 필드 설명은 Note API를 참고하세요. 중요: Note 리소스에는 메타데이터만 담겨 있어요. transcript 내용은 List Note Paragraphs API를 사용해 실제 텍스트 데이터를 가져오세요.가이드
실시간 녹음의 일시정지와 종료 구분하기
일시정지 중간 결과는note.recording.completed, 최종 종료는 note.ended로 처리하세요.
예시 시나리오:
- 회의 시작 → 녹음 시작
- 녹음 일시정지 → transcript와 요약 처리 →
note.recording.completed발생 - 녹음 재개 → 처리 계속
- 녹음 일시정지 →
note.recording.completed다시 발생 - 녹음 재개 후 종료 →
note.ended발생