メインコンテンツへスキップ

概要

Note リソースに関する webhook イベントです。すべての note イベントは resourceType: "Note" を使用します。

イベントの詳細

note.created

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

note.deleted

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

note.recording.completed(録音の一時停止)

  • ライブ録音が停止するたびに、その区間の最後の段落要約が保存された後に発生します。録音の一時停止だけでなく、録音中のノートの終了やエラーなど、どのような理由で録音が停止しても発生します
  • その区間で新しくテキスト変換された内容がない場合は発生しません
  • 録音が停止するたびに発生するため、同じノートで複数回発生することがあります
  • 互換性のためイベント名に completed が残っていますが、ノートの終了を意味しません。最終的な終了は note.ended で確認してください

note.user_content.updated

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

note.ended

  • ノートのすべての処理が完了したときに発生します
  • note.recording.completed とは異なり、ノートごとに 1 回だけ発生します

note.participants.updated

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

payload の例

リソースデータ

Note イベントには、完全な Note リソースデータが含まれます。各フィールドの説明については、Note API をご覧ください。 重要: Note リソースには metadata のみが含まれます。transcript の内容を取得するには、List Note Paragraphs API を使用して、実際のテキストデータを取得してください。

ガイド

録音の停止とノートの終了を区別する

録音区間ごとの途中結果は note.recording.completed、ノートの最終結果は note.ended で処理してください。 シナリオの例:
  1. 会議を開始 → 録音を開始
  2. 録音を一時停止 → その区間の transcript と要約を処理 → note.recording.completed が発生
  3. 録音を再開 → 処理を継続
  4. 録音中にノートを終了 → 最後の区間の note.recording.completed が発生 → note.ended が発生
処理の例: