Skip to main content
VoicePing API Access and Integration — query meeting transcripts from your backend

​
從後端查詢 VoicePing 會議記錄

API 存取專為伺服器對伺服器的工作流程而設計 — 排程匯出、CRM 同步、儀表板、法遵歸檔等。您可在工作區建立 API 金鑰、授予一組權限範圍，然後讓後端以標準 bearer token 呼叫 VoicePing API。 若是由人員透過 AI 用戶端詢問問題，請改用 MCP 存取。 
If a person is asking questions, use MCP Access.
If a server is fetching data, use API Access.

​
何時該使用 API 存取

使用情境範例
排程匯出每週五匯出當週的會議記錄
內部報表建立每週會議摘要報告
CRM 或專案管理流程將會議記錄摘要推送至 Salesforce 或 Asana
法遵歸檔將會議紀錄存放於符合規範的儲存位置
儀表板將會議記錄的 metadata 導入分析系統

​
建立 API 金鑰

  1. 開啟工作區設定 → 外部存取 → API 存取。
  2. 若 API 存取模式尚未啟用，請先啟用。
  3. 點擊建立 API 金鑰。
  4. 選擇名稱、允許的 IP 位址（建議設定）、該金鑰所需的權限範圍，以及有效期間。
  5. 立即複製產生的金鑰並存放於您的密鑰管理工具中。完整金鑰只會顯示一次。
Create API key modal showing name, allowed IP, scopes, and validity fields
切勿將 API 金鑰提交至程式碼儲存庫。 請存放於環境變數或密鑰管理工具。若要更進一步防護，可在建立金鑰視窗中為每個金鑰鎖定特定允許的 IP 位址 — 即使金鑰外洩，從其他 IP 發出的請求也會被拒絕。

​
驗證請求

每個請求都需對 https://api.voiceping.io 使用 bearer token 進行驗證： 
GET /api/v1/transcripts/search?q=pricing&limit=10 HTTP/1.1
Host: api.voiceping.io
Authorization: Bearer <VOICEPING_API_KEY>
只需將金鑰設為 VOICEPING_API_KEY 環境變數一次，下方範例就會自動讀取。

​
快速上手 — 以您的語言呼叫 API

同樣的兩步驟流程 — 先搜尋會議記錄，再擷取其中一筆 — 以四種語言呈現。預設顯示 TypeScript；可切換分頁選擇您使用的技術棧。 
// Requires Node.js 18+ (for built-in fetch)
const apiKey = process.env.VOICEPING_API_KEY!;
const base = "https://api.voiceping.io/api/v1";
const headers = { Authorization: `Bearer ${apiKey}` };

// 1. Search transcripts
const searchRes = await fetch(
  `${base}/transcripts/search?q=pricing&limit=10`,
  { headers },
);
const { transcripts } = await searchRes.json();

// 2. Read the first result in full
const detailRes = await fetch(
  `${base}/transcripts/${transcripts[0].id}`,
  { headers },
);
const transcript = await detailRes.json();

console.log(transcript.title, transcript.content);

​
下一步

外部存取總覽

回到總覽，了解同時適用於 MCP 與 API 的權限範圍、生命週期控制與事件記錄。

供 AI 用戶端使用的 MCP 存取

若是由人員透過 Claude、ChatGPT、Codex、Claude Code 或 Gemini CLI 詢問問題，請改用 MCP 存取。