Skip to main content
VoicePing API Access e integrazione — interroga le trascrizioni delle riunioni dal tuo backend

​
Interroga le trascrizioni VoicePing dal tuo backend

API Access è pensato per i workflow server-to-server — export programmati, sincronizzazione CRM, dashboard, archivi di compliance. Crei una chiave API nel tuo workspace, le assegni un insieme di scope, e il tuo backend chiama l’API VoicePing con un bearer token standard. Se è una persona a porre domande tramite un client IA, usa invece MCP Access. 
If a person is asking questions, use MCP Access.
If a server is fetching data, use API Access.

​
Quando usare API Access

Caso d’usoEsempio
Export programmatiEsportare ogni venerdì le trascrizioni della settimana
Reporting internoCostruire un report settimanale di sintesi delle riunioni
Workflow CRM o PMInviare riepiloghi di trascrizioni a Salesforce o Asana
Archivi di complianceConservare i record delle riunioni in uno storage approvato
DashboardAlimentare i sistemi di analytics con i metadati delle trascrizioni

​
Creare una chiave API

  1. Apri impostazioni workspace → External Access → API Access.
  2. Abilita API Access Mode se non è già attivo.
  3. Clicca Create API key.
  4. Scegli un nome, l’indirizzo IP consentito (consigliato), gli scope richiesti dalla chiave e un periodo di validità.
  5. Copia subito la chiave generata e conservala nel tuo secret manager. La chiave completa viene mostrata una sola volta.
Modale di creazione chiave API con campi per nome, IP consentita, scope e validità
Non committare mai le chiavi API. Tienile in variabili d’ambiente o nel tuo secret manager. Per maggiore sicurezza vincola ogni chiave a uno specifico indirizzo IP consentito nella modale di creazione — qualsiasi richiesta da un’altra IP verrà rifiutata anche se la chiave dovesse trapelare.

​
Autenticare le richieste

Ogni richiesta si autentica con un bearer token verso 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>
Imposta la chiave una volta come variabile d’ambiente VOICEPING_API_KEY, e gli esempi seguenti la useranno automaticamente.

​
Quickstart — chiama l’API nel tuo linguaggio

Lo stesso flusso a due passi — cerca trascrizioni, poi recuperane una — in quattro linguaggi. TypeScript è mostrato per primo; cambia scheda per il tuo stack. 
// 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);

​
Prossimi passi

Panoramica External Access

Torna a scope, controlli del ciclo di vita e log eventi che si applicano sia a MCP sia all’API.

MCP Access per client IA

Se una persona pone domande tramite Claude, ChatGPT, Codex, Claude Code o Gemini CLI, usa invece MCP Access.