列出 API 可見的通話

cURL

curl --request GET 'https://api.brightalk.ai/calls?limit=20' \
  --header "Authorization: Bearer $BRIGHTALK_API_KEY" \
  --header "Brightalk-Version: 2026-07-16"

const response = await fetch("https://api.brightalk.ai/calls?limit=20", {
  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?limit=20",
    headers={
    "Authorization": f"Bearer {os.environ['BRIGHTALK_API_KEY']}",
    "Brightalk-Version": "2026-07-16",
    },
)
print(response.status_code, response.json())

{
  "data": [
    {
      "id": "call_demo_001",
      "contact_id": "con_demo_001",
      "agent_id": "agt_demo_001",
      "queued_at": "2026-07-20T01:00:00Z",
      "created_at": "2026-07-20T01:00:00Z",
      "updated_at": "2026-07-20T01:00:00Z",
      "batch_id": "bat_demo_001",
      "automation_run_id": "run_demo_001",
      "outcome": "qualified",
      "outcome_reason": "Requested a follow-up.",
      "summary": "Customer requested a follow-up next week.",
      "duration_seconds": 92,
      "dialing_at": "2026-07-20T01:00:00Z",
      "connected_at": "2026-07-20T01:00:00Z",
      "ended_at": "2026-07-20T01:00:00Z",
      "cancel_requested_at": "2026-07-20T01:00:00Z",
      "cancelled_at": "2026-07-20T01:00:00Z"
    }
  ],
  "next_cursor": "<string>"
}

GET

calls

cURL

curl --request GET 'https://api.brightalk.ai/calls?limit=20' \
  --header "Authorization: Bearer $BRIGHTALK_API_KEY" \
  --header "Brightalk-Version: 2026-07-16"

const response = await fetch("https://api.brightalk.ai/calls?limit=20", {
  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?limit=20",
    headers={
    "Authorization": f"Bearer {os.environ['BRIGHTALK_API_KEY']}",
    "Brightalk-Version": "2026-07-16",
    },
)
print(response.status_code, response.json())

{
  "data": [
    {
      "id": "call_demo_001",
      "contact_id": "con_demo_001",
      "agent_id": "agt_demo_001",
      "queued_at": "2026-07-20T01:00:00Z",
      "created_at": "2026-07-20T01:00:00Z",
      "updated_at": "2026-07-20T01:00:00Z",
      "batch_id": "bat_demo_001",
      "automation_run_id": "run_demo_001",
      "outcome": "qualified",
      "outcome_reason": "Requested a follow-up.",
      "summary": "Customer requested a follow-up next week.",
      "duration_seconds": 92,
      "dialing_at": "2026-07-20T01:00:00Z",
      "connected_at": "2026-07-20T01:00:00Z",
      "ended_at": "2026-07-20T01:00:00Z",
      "cancel_requested_at": "2026-07-20T01:00:00Z",
      "cancelled_at": "2026-07-20T01:00:00Z"
    }
  ],
  "next_cursor": "<string>"
}

授權

Authorization

string

header

必填

Use a private-beta server credential 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}$

查詢參數

limit

integer

預設值:20

要傳回的資源數量。預設為 20，上限為 100。

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

cursor

string

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

Required string length: 1 - 2048

status

enum<string>

可用選項:

queued,

dialing,

in_progress,

completed,

failed,

cancelled

contact_id

string

不透明的資源識別碼。

Required string length: 1 - 255

範例:

"con_demo_001"

batch_id

string

不透明的資源識別碼。

Required string length: 1 - 255

範例:

"bat_demo_001"

automation_run_id

string

不透明的資源識別碼。

Required string length: 1 - 255

範例:

"run_demo_001"

created_after

string<date-time>

created_before

string<date-time>

回應

已傳回通話。

data

object[]

必填

Show child attributes

next_cursor

string | null

必填

更新聯絡人將一通立即 AI 通話排入佇列

⌘I

開始使用

API 基礎

核心概念

操作指南

發布資訊

API 參考

授權

標頭

查詢參數

回應