API y webhooks
Lleva transcripciones, resúmenes y tareas a tus propios sistemas automáticamente, mediante la API REST o un webhook. Sin pasar por servicios estadounidenses: todo funciona en nuestra infraestructura de la UE.
Incluido a partir del plan Pro. El acceso a la API ya está activado durante la prueba de 14 días.
Conectado en 3 pasos
- En MeetingIQ, crea un token de API en Einstellungen → API & Webhooks (Ajustes → API y webhooks). Por motivos de seguridad, solo se muestra una vez.
- Consulta la API REST o introduce una URL de webhook a la que enviaremos cada reunión terminada.
- Listo. Para Make, Zapier o n8n solo necesitas la URL de webhook que se genera allí.
API REST
Todos los endpoints son de solo lectura, devuelven JSON y esperan el token en la cabeceraAuthorization: Bearer miq_…Límite: 120 solicitudes por minuto y token.
/api/v1/meetingsLista, filtrable por estado/api/v1/meetings/{id}Resumen, puntos clave, tareas/api/v1/meetings/{id}/transcriptTexto completo + segmentos por hablanteEjemplo
curl -H "Authorization: Bearer miq_..." \ "https://meetingiq.de/api/v1/meetings?status=completed&limit=10"
Respuesta
{
"data": {
"id": "6165b3df-…", "title": "Jour Fixe Vertrieb", "status": "completed",
"language": "de", "durationSec": 2984,
"summaryShort": "…", "summary": "…",
"keyPoints": ["…"], "decisions": ["…"],
"participants": [{ "name": "Anna Beispiel", "email": "anna@firma.de" }],
"tasks": [{ "title": "Angebot nachfassen", "assignee": { "name": "Anna" },
"dueDate": null, "status": "open" }],
"links": { "self": "…", "transcript": "…", "app": "…" }
}
}Webhooks
En cuanto una reunión se ha procesado por completo, enviamos el resultado completo a tu URL mediante POST, con la misma estructura que la API. Los envíos fallidos se reintentan automáticamente, y cada envío puede consultarse con su estado en la interfaz.
POST https://your-domain.com/hook
X-MeetingIQ-Event: meeting.completed
X-MeetingIQ-Delivery: 9f1c… (ID de este envío)
X-MeetingIQ-Signature: sha256=… (HMAC sobre el cuerpo sin procesar)
{ "event": "meeting.completed", "timestamp": "…", "data": { …Meeting… } }Verificar la firma (Node.js)
const expected = "sha256=" + crypto
.createHmac("sha256", SIGNING_SECRET)
.update(rawBody)
.digest("hex");
crypto.timingSafeEqual(
Buffer.from(expected),
Buffer.from(req.headers["x-meetingiq-signature"])
);Make, Zapier y n8n
No necesitas ninguna integración adicional. Los tres aceptan un webhook entrante genérico:
- Make: crea un módulo «Custom Webhook» y copia la URL generada.
- Zapier: «Webhooks by Zapier» → disparador «Catch Hook».
- n8n: nodo Webhook, usa la URL de producción.
Introduce la URL en MeetingIQ en Einstellungen → API & Webhooks (Ajustes → API y webhooks). Un clic en «Testen» (Probar) realiza al instante un envío de prueba, para que puedas montar la asignación de campos sin esperar a la siguiente reunión.
Protección de datos
El tratamiento y el almacenamiento se realizan exclusivamente en la UE. Los tokens solo se guardan como hash, pueden revocarse en cualquier momento y cada envío de webhook está firmado. Las consultas a través de la API quedan reflejadas en el registro de auditoría. Encontrarás los detalles en nuestro centro de privacidad y en el contrato de encargo del tratamiento (ambos en alemán).
¿Preguntas sobre la integración?
Cuéntanos a qué sistema deben ir los datos y hacemos la configuración inicial contigo.