API ir webhook’ai

1. MeetingIQ skiltyje Einstellungen → API & Webhooks (Nustatymai → API ir webhook’ai) sukurkite API prieigos raktą. Saugumo sumetimais jis parodomas tik vieną kartą.
2. Teikite užklausas REST API arba įveskite webhook’o URL adresą, kuriuo išsiųsime kiekvieną užbaigtą susitikimą.
3. Viskas. Naudojant Make, Zapier ar n8n, pakanka ten sugeneruoto webhook’o URL adreso.

Visi galiniai taškai skirti tik skaitymui, grąžina JSON ir reikalauja prieigos rakto antraštėjeAuthorization: Bearer miq_…Riba: 120 užklausų per minutę vienam raktui.

Pavyzdys

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

Atsakymas

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

Kai tik susitikimas būna visiškai apdorotas, POST užklausa išsiunčiame visą rezultatą jūsų URL adresu, tokia pačia struktūra kaip API. Nepavykę pristatymai automatiškai kartojami, o kiekvieną pristatymą ir jo būseną galima peržiūrėti sąsajoje.

POST https://your-domain.com/hook
X-MeetingIQ-Event:     meeting.completed
X-MeetingIQ-Delivery:  9f1c…            (Šio pristatymo ID)
X-MeetingIQ-Signature: sha256=…         (HMAC nuo neapdoroto užklausos turinio)

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

Patikrinkite parašą (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"])
);

Papildomos integracijos tam nereikia. Visi trys priima bendrinį gaunamąjį webhook’ą:

• Make: sukurkite modulį „Custom Webhook“ ir nukopijuokite sugeneruotą URL adresą.
• Zapier: „Webhooks by Zapier“ → paleidiklis „Catch Hook“.
• n8n: Webhook mazgas, naudokite produkcinės aplinkos URL adresą.

Įveskite URL adresą MeetingIQ skiltyje Einstellungen → API & Webhooks (Nustatymai → API ir webhook’ai). Paspaudus „Testen“ (Testuoti), iš karto išsiunčiamas bandomasis pristatymas, todėl laukų susiejimą galite sukurti nelaukdami kito susitikimo.

Duomenys tvarkomi ir saugomi tik ES. Prieigos raktai saugomi tik kaip maišos reikšmė (hash), juos galima bet kada atšaukti, o kiekvienas webhook’o pristatymas pasirašomas. Duomenų gavimas per API atsekamas audito žurnale. Daugiau informacijos rasite mūsų privatumo centre ir duomenų tvarkymo sutartyje (abu dokumentai vokiečių kalba).