Note イベント

​

概要

​

イベントの詳細

​

note.created

• ライブ音声ノートの録音を開始したとき
• 録音ファイルからノートを作成したとき

​

note.deleted

• ユーザーがノートを完全に削除したとき

​

note.recording.completed

• すべての音声データの処理が完了し、テキスト変換と段落の生成が終わったとき
• 重要: このイベントは、リアルタイム会議ノートでは複数回発生することがあります。1 回の会議セッション中に録音と停止が複数回行われる場合があるためです
• このイベントを受信した時点で、その時点のノート情報をすべて取得できます

​

note.user_content.updated

• ユーザーがノートの内容を手動で編集したとき

​

note.ended

• ノートが完全に終了したとき（すべての処理が完了した後）にトリガーされます
• 複数回発生しうる note.recording.completed とは異なり、ノートのライフサイクルごとに 1 回だけ発生します
• これはノートの完了を示す、確定的なイベントです
• ノートが最終状態に達したことを把握する必要がある場合に、このイベントを利用してください

​

note.participants.updated

• ノートに会議の参加者が追加または削除されたときにトリガーされます
• 既存の参加者の名前やメールアドレスが更新された場合には発生しません
• resource フィールドには、更新後の participants 配列を含む完全な Note オブジェクトが含まれます

​

payload の例

​

リソースデータ

​

ガイド

​

リアルタイム会議ノート

• リアルタイム会議では、recording.completed が同じノートに対して複数回発生することがあります
• このイベントを受信した際は、常に最新のノートデータを取得してください

• note.ended はノートが完全に終了したときに 1 回だけ発生するため、ライフサイクルの管理がより明確になります
• 会議中に複数回発生しうる recording.completed とは異なり、note.ended は確定的な終了を示します
• recording.completed と note.ended の両方のイベントがサポートされており、ニーズに応じて併用できます

1. 会議が開始 → 録音が開始
2. 録音が一時停止 → transcript と要約の処理 → note.recording.completed が発生（イベント #1）
3. 録音が再開 → 処理を継続
4. 録音が停止 → transcript と要約の処理 → note.recording.completed が発生（イベント #2）

async function handleNoteRecordingCompleted(event) {
  const noteId = event.data.resourceId;
  
  // Use note metadata from event data
  const note = event.data.resource;
  
  // Fetch paragraph content
  const paragraphs = await fetchNoteParagraphs(noteId);
  
  // Process the complete note data
  processNoteUpdate(note, paragraphs);
}