API un webhook

1. MeetingIQ sadaļā Einstellungen → API & Webhooks (Iestatījumi → API un webhook) izveidojiet API piekļuves marķieri. Drošības apsvērumu dēļ tas tiek parādīts tikai vienu reizi.
2. Vaicājiet REST API vai norādiet webhook URL, uz kuru mēs nosūtīsim katru pabeigto sanāksmi.
3. Gatavs. Ja izmantojat Make, Zapier vai n8n, pietiek ar tur ģenerēto webhook URL.

Visi galapunkti ir tikai lasīšanai, atgriež JSON un sagaida marķieri galvenēAuthorization: Bearer miq_…Ierobežojums: 120 pieprasījumi minūtē vienam marķierim.

Piemērs

curl -H "Authorization: Bearer miq_..." \
  "https://meetingiq.de/api/v1/meetings?status=completed&limit=10"

Atbilde

{
  "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": "…" }
  }
}

Tiklīdz sanāksme ir pilnībā apstrādāta, mēs ar POST pieprasījumu nosūtām pilnu rezultātu uz jūsu URL tādā pašā struktūrā kā API. Neveiksmīgas piegādes tiek automātiski atkārtotas, un katru piegādi ar tās statusu var apskatīt saskarnē.

POST https://your-domain.com/hook
X-MeetingIQ-Event:     meeting.completed
X-MeetingIQ-Delivery:  9f1c…            (Šīs piegādes ID)
X-MeetingIQ-Signature: sha256=…         (HMAC no neapstrādātā pieprasījuma satura)

{ "event": "meeting.completed", "timestamp": "…", "data": { …Meeting… } }

Pārbaudiet parakstu (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"])
);

Papildu integrācija šim nav vajadzīga. Visi trīs pieņem vispārīgu ienākošo webhook:

• Make: izveidojiet moduli „Custom Webhook“ un nokopējiet ģenerēto URL.
• Zapier: „Webhooks by Zapier“ → aktivizētājs „Catch Hook“.
• n8n: Webhook mezgls, izmantojiet produkcijas URL.

Ievadiet URL MeetingIQ sadaļā Einstellungen → API & Webhooks (Iestatījumi → API un webhook). Noklikšķinot uz „Testen“ (Testēt), uzreiz tiek nosūtīta testa piegāde, tāpēc lauku kartēšanu varat izveidot, negaidot nākamo sanāksmi.

Apstrāde un glabāšana notiek tikai ES. Marķieri tiek glabāti tikai jaucējvērtības (hash) veidā, tos var jebkurā laikā atsaukt, un katra webhook piegāde ir parakstīta. Datu izgūšana ar API ir izsekojama audita žurnālā. Sīkāka informācija ir mūsu privātuma centrā un datu apstrādes līgumā (abi vācu valodā).