Para desarrolladores

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

  1. En MeetingIQ, crea un token de API en Einstellungen → API & Webhooks (Ajustes → API y webhooks). Por motivos de seguridad, solo se muestra una vez.
  2. Consulta la API REST o introduce una URL de webhook a la que enviaremos cada reunión terminada.
  3. 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.

GET/api/v1/meetingsLista, filtrable por estado
GET/api/v1/meetings/{id}Resumen, puntos clave, tareas
GET/api/v1/meetings/{id}/transcriptTexto completo + segmentos por hablante

Ejemplo

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.