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

​
백엔드에서 VoicePing 회의록 조회

API Access는 서버 간 워크플로우 ― 정기 내보내기, CRM 동기화, 대시보드, 규정 준수 아카이브 등 ― 를 위한 방식입니다. 워크스페이스에서 API 키를 생성하고, 해당 키에 스코프를 부여한 뒤, 백엔드에서 표준 Bearer 토큰으로 VoicePing API를 호출합니다. 사람 이 AI 클라이언트를 통해 질문하는 경우에는 대신 MCP Access 를 사용하세요. 
If a person is asking questions, use MCP Access.
If a server is fetching data, use API Access.

​
API Access를 언제 사용하는가

사용 사례예시
정기 내보내기매주 금요일에 이번 주 회의록 내보내기
사내 리포팅주간 회의 요약 리포트 작성
CRM / PM 워크플로우회의록 요약을 Salesforce, Asana 등에 반영
규정 준수 아카이브승인된 저장소에 회의 기록 보관
대시보드회의록 메타데이터를 분석 시스템에 공급

​
API 키 생성

  1. 워크스페이스 설정 → 외부 접근(External Access) → API Access 를 엽니다.
  2. API Access Mode 가 꺼져 있으면 활성화합니다.
  3. Create API key 를 클릭합니다.
  4. 이름, 허용된 IP 주소(권장), 필요한 스코프, 유효 기간을 선택합니다.
  5. 생성된 키를 즉시 복사해 시크릿 매니저에 저장하세요. 전체 키는 단 한 번만 표시됩니다.
Create API key modal showing name, allowed IP, scopes, and validity fields
API 키는 절대 커밋하지 마세요. 환경 변수나 시크릿 매니저에 보관하세요. 더 안전하게 하려면 키 생성 모달에서 각 키를 특정 허용된 IP 주소 에 잠그세요. 키가 유출되더라도 다른 IP에서의 요청은 거부됩니다.

​
요청 인증

모든 요청은 Bearer 토큰으로 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>
키를 환경 변수 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 Access

Claude, ChatGPT, Codex, Claude Code, Gemini CLI 등을 통해 사람이 질문하는 경우에는 MCP Access를 사용하세요.