Skip to main content

Documentation Index

Fetch the complete documentation index at: https://manual.voiceping.net/llms.txt

Use this file to discover all available pages before exploring further.

VoicePing API Access and Integration — query meeting transcripts from your backend

Truy vấn bản ghi VoicePing từ backend của bạn

API Access dành cho các quy trình server-to-server — xuất định kỳ, đồng bộ CRM, bảng điều khiển, lưu trữ tuân thủ. Bạn tạo API key trong workspace, cấp cho nó một tập phạm vi, và backend của bạn gọi VoicePing API với bearer token tiêu chuẩn. Nếu một con người đang đặt câu hỏi thông qua ứng dụng AI, hãy dùng MCP Access thay thế.
If a person is asking questions, use MCP Access.
If a server is fetching data, use API Access.

Khi nào dùng API Access

Trường hợpVí dụ
Xuất định kỳXuất bản ghi tuần này mỗi thứ Sáu
Báo cáo nội bộTạo báo cáo tóm tắt cuộc họp hàng tuần
Quy trình CRM hoặc PMĐẩy tóm tắt bản ghi vào Salesforce hoặc Asana
Lưu trữ tuân thủLưu trữ hồ sơ cuộc họp trong bộ lưu trữ đã được phê duyệt
Bảng điều khiểnĐưa metadata bản ghi vào hệ thống phân tích

Tạo API key

  1. Mở workspace settings → External Access → API Access.
  2. Bật API Access Mode nếu chưa bật.
  3. Nhấp Create API key.
  4. Chọn tên, địa chỉ IP được phép (khuyến nghị), phạm vi mà key cần, và thời hạn hiệu lực.
  5. Sao chép key được tạo ngay lập tức và lưu vào trình quản lý bí mật. Key đầy đủ chỉ hiển thị một lần.
Create API key modal showing name, allowed IP, scopes, and validity fields
Không bao giờ commit API key. Giữ chúng trong biến môi trường hoặc trình quản lý bí mật. Để an toàn hơn, khóa mỗi key vào một địa chỉ IP được phép cụ thể trong modal tạo key — bất kỳ request nào từ IP khác sẽ bị từ chối ngay cả khi key bị rò rỉ.

Xác thực request

Mọi request xác thực bằng bearer token đến https://api.voiceping.io:
GET /api/v1/transcripts/search?q=pricing&limit=10 HTTP/1.1
Host: api.voiceping.io
Authorization: Bearer <VOICEPING_API_KEY>
Đặt key một lần làm biến môi trường VOICEPING_API_KEY, và các mẫu bên dưới sẽ tự động sử dụng.

Quickstart — gọi API bằng ngôn ngữ của bạn

Cùng luồng hai bước — tìm bản ghi, sau đó lấy một bản — trong bốn ngôn ngữ. TypeScript được hiển thị đầu tiên; chuyển tab sang stack của bạn.
// 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);

Bước tiếp theo

Tổng quan External Access

Quay lại phạm vi, kiểm soát vòng đời và nhật ký sự kiện áp dụng cho cả MCP và API.

MCP Access cho ứng dụng AI

Nếu một người đặt câu hỏi qua Claude, ChatGPT, Codex, Claude Code hoặc Gemini CLI, hãy dùng MCP Access.