取得通話逐字稿 - Brightalk Developer Documentation

cURL

curl --request GET 'https://api.brightalk.ai/calls/11111111-1111-4111-8111-111111111111/transcript?limit=100' \
  --header "Authorization: Bearer $BRIGHTALK_API_KEY" \
  --header "Brightalk-Version: 2026-07-16"

const response = await fetch("https://api.brightalk.ai/calls/11111111-1111-4111-8111-111111111111/transcript?limit=100", {
  method: "GET",
  headers: {
    Authorization: `Bearer ${process.env.BRIGHTALK_API_KEY}`,
    "Brightalk-Version": "2026-07-16",
  },
});
console.log(response.status, await response.json());

import os
import requests

response = requests.request(
    "GET",
    "https://api.brightalk.ai/calls/11111111-1111-4111-8111-111111111111/transcript?limit=100",
    headers={
    "Authorization": f"Bearer {os.environ['BRIGHTALK_API_KEY']}",
    "Brightalk-Version": "2026-07-16",
    },
)
print(response.status_code, response.json())

{
  "object": "call_transcript",
  "schema_version": "2026-07-28",
  "call_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "status": "processing",
  "revision": 0,
  "turns": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "sequence": 1,
      "speaker": "agent",
      "text": "<string>",
      "audio_offset_ms": 4503599627370495
    }
  ],
  "next_cursor": null,
  "reason": null,
  "generated_at": null,
  "poll_after_seconds": 5
}

GET

/

calls

/

{call_id}

/

transcript

cURL

curl --request GET 'https://api.brightalk.ai/calls/11111111-1111-4111-8111-111111111111/transcript?limit=100' \
  --header "Authorization: Bearer $BRIGHTALK_API_KEY" \
  --header "Brightalk-Version: 2026-07-16"

const response = await fetch("https://api.brightalk.ai/calls/11111111-1111-4111-8111-111111111111/transcript?limit=100", {
  method: "GET",
  headers: {
    Authorization: `Bearer ${process.env.BRIGHTALK_API_KEY}`,
    "Brightalk-Version": "2026-07-16",
  },
});
console.log(response.status, await response.json());

import os
import requests

response = requests.request(
    "GET",
    "https://api.brightalk.ai/calls/11111111-1111-4111-8111-111111111111/transcript?limit=100",
    headers={
    "Authorization": f"Bearer {os.environ['BRIGHTALK_API_KEY']}",
    "Brightalk-Version": "2026-07-16",
    },
)
print(response.status_code, response.json())

{
  "object": "call_transcript",
  "schema_version": "2026-07-28",
  "call_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "status": "processing",
  "revision": 0,
  "turns": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "sequence": 1,
      "speaker": "agent",
      "text": "<string>",
      "audio_offset_ms": 4503599627370495
    }
  ],
  "next_cursor": null,
  "reason": null,
  "generated_at": null,
  "poll_after_seconds": 5
}

授權

Authorization

string

header

必填

Use a server-side Brightalk API key in the Authorization header.

標頭

Brightalk-Version

string

預設值:2026-07-16

選擇以日期為基礎的 API 版本。省略時會使用組織固定的預設版本。

Allowed value: "2026-07-16"

X-Request-Id

string

由呼叫端產生且符合 [A-Za-z0-9._:-]{1,64} 的關聯值。無效值會被取代。

Maximum string length: 64

Pattern: ^[A-Za-z0-9._:-]{1,64}$

路徑參數

call_id

string<uuid>

必填

不透明的通話識別碼。不透明的資源識別碼。

Required string length: 1 - 255

範例:

"11111111-1111-4111-8111-111111111111"

查詢參數

limit

integer

預設值:100

單頁最多傳回的逐字稿輪次數量。預設為 100，上限為 250；達到回應大小預算時可提早截頁。

必填範圍: 1 <= x <= 250

cursor

string

前一頁逐字稿回傳的不透明游標。

Required string length: 1 - 2048

回應

已傳回目前或游標固定版本的逐字稿結果。

Option 1
Option 2
Option 3
Option 4

具有獨立修訂版本的通話逐字稿結果。游標會固定一個不可變修訂版本；只有在不帶該游標重新開始分頁時，才會看到較高的 revision。

object

string

必填

Allowed value: "call_transcript"

schema_version

string

必填

Allowed value: "2026-07-28"

call_id

string<uuid>

必填

Required string length: 1 - 255

status

string

必填

Allowed value: "processing"

revision

integer

必填

turns

object[]

必填

Show child attributes

next_cursor

null

必填

reason

null

必填

generated_at

null

必填

poll_after_seconds

integer

必填