取得通話摘要 - Brightalk Developer Documentation

cURL

curl --request GET 'https://api.brightalk.ai/calls/11111111-1111-4111-8111-111111111111/summary' \
  --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/summary", {
  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/summary",
    headers={
    "Authorization": f"Bearer {os.environ['BRIGHTALK_API_KEY']}",
    "Brightalk-Version": "2026-07-16",
    },
)
print(response.status_code, response.json())

{
  "object": "call_summary",
  "schema_version": "2026-07-28",
  "call_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "status": "processing",
  "revision": 0,
  "summary": null,
  "reason": null,
  "generated_at": null,
  "poll_after_seconds": 5
}

GET

/

calls

/

{call_id}

/

summary

cURL

curl --request GET 'https://api.brightalk.ai/calls/11111111-1111-4111-8111-111111111111/summary' \
  --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/summary", {
  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/summary",
    headers={
    "Authorization": f"Bearer {os.environ['BRIGHTALK_API_KEY']}",
    "Brightalk-Version": "2026-07-16",
    },
)
print(response.status_code, response.json())

{
  "object": "call_summary",
  "schema_version": "2026-07-28",
  "call_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "status": "processing",
  "revision": 0,
  "summary": 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"

回應

已傳回目前的摘要結果，包括正常的處理中狀態。

Option 1
Option 2
Option 3
Option 4

具有獨立修訂版本的通話摘要結果。較高的 revision 表示清理後的端點內容已變更；相同內容的重投影會保留目前 revision。

object

string

必填

Allowed value: "call_summary"

schema_version

string

必填

Allowed value: "2026-07-28"

call_id

string<uuid>

必填

Required string length: 1 - 255

status

string

必填

Allowed value: "processing"

revision

integer

必填

summary

null

必填

reason

null

必填

generated_at

null

必填

poll_after_seconds

integer

必填