Skip to main content
VoicePing API Access e integración — consulta las transcripciones de reuniones desde tu backend

Consulta las transcripciones de VoicePing desde tu backend

API Access está pensado para flujos servidor a servidor — exportaciones programadas, sincronización con CRM, dashboards, archivos de cumplimiento. Creas una clave de API en tu workspace, le concedes un conjunto de ámbitos y tu backend llama a la API de VoicePing con un bearer token estándar. Si es una persona haciendo preguntas a través de un cliente de IA, usa MCP Access en su lugar.
If a person is asking questions, use MCP Access.
If a server is fetching data, use API Access.

Cuándo usar API Access

Caso de usoEjemplo
Exportaciones programadasExportar las transcripciones de esta semana cada viernes
Reportes internosGenerar un informe semanal de reuniones
Flujos con CRM o PMEnviar resúmenes de transcripciones a Salesforce o Asana
Archivos de cumplimientoGuardar registros de reuniones en almacenamiento aprobado
DashboardsAlimentar metadatos de transcripciones a sistemas de analítica

Crear una clave de API

  1. Abre workspace settings → External Access → API Access.
  2. Activa API Access Mode si aún no está encendido.
  3. Haz clic en Create API key.
  4. Elige un nombre, la dirección IP permitida (recomendado), los ámbitos que la clave necesita y un período de validez.
  5. Copia la clave generada inmediatamente y guárdala en tu gestor de secretos. La clave completa se muestra una sola vez.
Modal de creación de clave de API mostrando nombre, IP permitida, ámbitos y campos de validez
Nunca hagas commit de las claves de API. Guárdalas en variables de entorno o en tu gestor de secretos. Para mayor seguridad, limita cada clave a una dirección IP permitida concreta en el modal de creación — cualquier petición desde otra IP será rechazada aunque la clave se filtre.

Autenticar peticiones

Cada petición se autentica con un bearer token contra 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>
Configura la clave una vez como la variable de entorno VOICEPING_API_KEY y los ejemplos siguientes la tomarán automáticamente.

Quickstart — llama a la API en tu lenguaje

El mismo flujo de dos pasos — buscar transcripciones y luego obtener una — en cuatro lenguajes. TypeScript se muestra primero; cambia de pestaña para tu 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);

Siguientes pasos

Visión general de External Access

Vuelve a los ámbitos, controles de ciclo de vida y registros de eventos que aplican tanto a MCP como a la API.

MCP Access para clientes de IA

Si una persona está haciendo preguntas a través de Claude, ChatGPT, Codex, Claude Code o Gemini CLI, usa MCP Access en su lugar.