> ## Documentation Index
> Fetch the complete documentation index at: https://docs.brightalk.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Brightalk API 簡介

> 瞭解 Brightalk 私人測試版 server-to-server REST API 的支援範圍。

<Note>
  **私人測試版。** 新組織預設已啟用。組織管理員仍須在 Brightalk 設定中建立具權限範圍的 API 金鑰，請求才能通過驗證。可用範圍與限制以本文件和 OpenAPI 契約為準。
</Note>

Brightalk API 是用來啟動及追蹤 AI 語音工作的 server-to-server REST API。正式環境 base URL 為 `https://api.brightalk.ai`；請將所有 API 金鑰保存在受信任的伺服器，切勿從瀏覽器或行動裝置客戶端程式碼呼叫 API。

AI 語音代理與 Automations 都在 Brightalk 儀表板中設定及管理。透過本 API 建立的通話僅限 AI 模式。

## 選擇執行方式

<CardGroup cols={3}>
  <Card title="單次 AI 通話 — 私人測試版" icon="phone" href="/zh-Hant/guides/place-one-call">
    使用符合資格的 AI 語音代理，將一通立即執行的非同步通話加入佇列，再查詢結果。
  </Card>

  <Card title="批次撥號 — 私人測試版" icon="list" href="/zh-Hant/guides/create-start-batch">
    為最多 1,000 位不重複的收話人建立草稿，再啟動、排程及控制批次。
  </Card>

  <Card title="Automation — 私人測試版" icon="diagram-project" href="/zh-Hant/guides/run-automation">
    為一位聯絡人啟動儀表板管理中的有效 Automation，並追蹤執行狀態。
  </Card>
</CardGroup>

## API 涵蓋範圍

API 提供組織範圍內的聯絡人、符合資格的代理目錄、單次通話、批次、Automation 摘要及 Automation 執行。已接受的執行工作皆為非同步：成功回應會建立或傳回一個 API 資源，您的伺服器需持續查詢，直到資源進入終止狀態。

契約未載明的功能目前不受支援。請參閱[可用性](/zh-Hant/availability)，瞭解明確邊界與儀表板相依性。

## 下一步

依照[快速開始](/zh-Hant/quickstart)建立具適當權限範圍的金鑰、將一通電話加入佇列，並判讀結果。