メインコンテンツへスキップ
GET
商談音声を取得(文字起こし・AI 要約を同梱)

承認

Authorization
string
header
必須

Stockwork が発行する API キー(sk_ プレフィックス、base62 ランダム ≥ 40 文字)。 キーには 1 つの role(read / analyst / write / admin)が紐付き、 各エンドポイントの必要 role 以上であることが要求される(対応表は info.description 参照)。

パスパラメータ

record_id
string
必須

Stockwork record_id(18 文字英数字)

Pattern: ^[A-Za-z0-9]{18}$

レスポンス

取得成功

商談音声の単一レコード表現。MeetingRecord に文字起こし平文 (properties.transcript_text)と AI 要約(summary)を加えたもの。 取得の応答で返る(一覧・検索では返らない)。 文字起こしは 1 時間の会議で 100 KB 強になる。

id
string
必須

Stockwork record_id(18 文字)

例:

"Mr7XkQpYz3Lh9vMs2N"

properties
object
必須

商談音声のプロパティ集合。すべて読み取り専用。

  • source_type — 取得元(Teams / Zoom / Google Meet / ファイル / 電話連携 / スマホ録音 等)。 選択肢は GET /v1/meeting-records/properties/ の options
  • status — 処理ステータス。reserved(予約のみ)/ pending / processing の間は 文字起こしが未完成。available(登録可能)/ registered(商談ログ等に登録済み)/ error
  • transcription_status — 文字起こしの状態。completed で全文が確定する
  • visibility — private(作成者と共有メンバーのみ)/ public(組織内公開)。API キーには public のものだけが返る(登録して商談ログ等になると public に変わる)
  • assignee_ids — 担当者(User)の record_id の配列。GET /v1/users/ で解決する
  • duration_seconds — 録音時間(秒)。文字起こし未完了時は null
  • transcript_text — 文字起こしの平文。MM:SS --> MM:SS(分は 60 を超えうる)の 時刻行と 話者: 発言 の対を空行で区切って並べる。詳細取得の応答にのみ含まれる (一覧・検索にはキー自体が無い)
  • 組織別カスタムプロパティも同じ namespace で返る

created_by_name、tags(タグ名の配列)、access_level(private / org / external)、 link_status(approved / has_suggestion / unlinked。承認済みと提案の両方があれば approved)も返す。

created_at
string<date-time>
必須
updated_at
string<date-time>
必須

レコードの値が最後に変わった日時。コアフィールド・カスタムプロパティ・アクティビティ件数などの集計値のいずれかが実際に変わったときに進む。商談ログやメールなどの活動を記録した場合も、それが集計値を動かすためこの日時が進む。同じ値での再保存や、他レコードとの紐付け変更では進まない。

summary
object | null
必須

AI 要約。未生成なら null。

例: