Note Events

​

개요

​

이벤트 상세

​

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.recording.completed는 녹음 일시정지를 알려요. 이벤트를 받을 때마다 최신 노트 데이터를 가져오세요
• note.ended는 노트가 완전히 끝났을 때 한 번만 발생해요
• 두 이벤트를 함께 구독하면 일시정지 시점의 중간 결과와 최종 종료를 각각 처리할 수 있어요

1. 회의 시작 → 녹음 시작
2. 녹음 일시정지 → transcript와 요약 처리 → note.recording.completed 발생
3. 녹음 재개 → 처리 계속
4. 녹음 일시정지 → note.recording.completed 다시 발생
5. 녹음 재개 후 종료 → note.ended 발생

async function handleRecordingPaused(event) {
  const noteId = event.data.resourceId;
  const note = event.data.resource;
  const paragraphs = await fetchNoteParagraphs(noteId);

  processPausedNote(note, paragraphs);
}

async def handle_recording_paused(event):
    note_id = event['data']['resourceId']
    note = event['data']['resource']
    paragraphs = await fetch_note_paragraphs(note_id)

    process_paused_note(note, paragraphs)

func handleRecordingPaused(event WebhookEvent) error {
    noteID := event.Data.ResourceID
    note := event.Data.Resource

    paragraphs, err := fetchNoteParagraphs(noteID)
    if err != nil {
        return err
    }

    return processPausedNote(note, paragraphs)
}

suspend fun handleRecordingPaused(event: WebhookEvent) {
    val noteId = event.data.resourceId
    val note = event.data.resource
    val paragraphs = fetchNoteParagraphs(noteId)

    processPausedNote(note, paragraphs)
}