API ja veebihaagid

1. Looge MeetingIQ-s API-tõend (token) jaotises Einstellungen → API & Webhooks (Seaded → API ja veebihaagid). Turvalisuse huvides näidatakse seda ainult üks kord.
2. Pärige andmeid REST API kaudu või sisestage veebihaagi URL, kuhu saadame iga valmis koosoleku.
3. Valmis. Make'i, Zapieri või n8n-i puhul piisab sealt saadud veebihaagi URL-ist.

Kõik lõpp-punktid on ainult lugemiseks, tagastavad JSON-i ja ootavad tõendit päisesAuthorization: Bearer miq_…Piirang: 120 päringut minutis ühe tõendi kohta.

Näide

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

Vastus

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

Niipea kui koosolek on täielikult töödeldud, saadame kogu tulemuse POST-päringuga teie URL-ile, samas struktuuris nagu API. Ebaõnnestunud saatmisi korratakse automaatselt ja iga saatmist koos olekuga saab vaadata kasutajaliideses.

POST https://your-domain.com/hook
X-MeetingIQ-Event:     meeting.completed
X-MeetingIQ-Delivery:  9f1c…            (Selle saatmise ID)
X-MeetingIQ-Signature: sha256=…         (HMAC päringu töötlemata sisust)

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

Allkirja kontrollimine (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"])
);

Selleks pole vaja eraldi integratsiooni. Kõik kolm toetavad üldist sissetulevat veebihaaki:

• Make: looge moodul „Custom Webhook“ ja kopeerige loodud URL.
• Zapier: „Webhooks by Zapier“ → päästik „Catch Hook“.
• n8n: Webhook-sõlm, kasutage tootmis-URL-i.

Sisestage URL MeetingIQ-s jaotises Einstellungen → API & Webhooks (Seaded → API ja veebihaagid). Klõps nupul „Testen“ (Testi) saadab kohe testsaadetise, nii et saate väljade vastendamise valmis teha järgmist koosolekut ootamata.

Töötlemine ja salvestamine toimuvad ainult ELis. Tõendeid hoitakse ainult räsina, neid saab igal ajal tühistada ja iga veebihaagi saadetis on allkirjastatud. API kaudu pärimine on auditilogis jälgitav. Üksikasjad leiate meie privaatsuskeskusest ja andmetöötluslepingust (mõlemad saksa keeles).