개요
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발생