MeetingIQ
KirjauduKokeile 14 päivää maksutta
Kehittäjille

API ja webhookit

Hae litteraatit, yhteenvedot ja tehtävät automaattisesti omiin järjestelmiisi REST-rajapinnan tai webhookin kautta. Ei kiertotietä yhdysvaltalaisten palvelujen kautta: kaikki toimii EU:ssa sijaitsevalla infrastruktuurillamme.

Kokeile 14 päivää maksuttaKatso hinnat

Sisältyy Pro-pakettiin ja sitä ylempiin. API-käyttö on päällä jo 14 päivän kokeilun aikana.

Käyttövalmis 3 vaiheessa

  1. Luo MeetingIQ:ssa API-tunnus kohdassa Einstellungen → API & Webhooks (Asetukset → API ja webhookit). Tietoturvasyistä tunnus näytetään vain kerran.
  2. Tee kyselyjä REST-rajapintaan tai anna webhook-URL, johon lähetämme jokaisen valmiin kokouksen.
  3. Valmista. Make-, Zapier- tai n8n-palvelussa tarvitset vain siellä luodun webhook-URL:n.

REST-rajapinta

Kaikki päätepisteet ovat vain luku -tyyppisiä, palauttavat JSONia ja odottavat tunnusta otsakkeessaAuthorization: Bearer miq_…Raja: 120 pyyntöä minuutissa tunnusta kohden.

GET/api/v1/meetingsLuettelo, suodatettavissa tilan mukaan
GET/api/v1/meetings/{id}Yhteenveto, keskeiset kohdat, tehtävät
GET/api/v1/meetings/{id}/transcriptKoko teksti + puhujakohtaiset jaksot

Esimerkki

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

Vastaus

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

Webhookit

Heti kun kokous on käsitelty kokonaan, lähetämme koko tuloksen URL-osoitteeseesi POST-pyyntönä, samassa rakenteessa kuin API:ssa. Epäonnistuneet toimitukset yritetään automaattisesti uudelleen, ja jokaisen toimituksen tilaa voi seurata käyttöliittymässä.

POST https://your-domain.com/hook
X-MeetingIQ-Event:     meeting.completed
X-MeetingIQ-Delivery:  9f1c…            (Tämän toimituksen tunniste)
X-MeetingIQ-Signature: sha256=…         (HMAC raa'asta viestirungosta)

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

Allekirjoituksen tarkistus (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 ja n8n

Erillistä integraatiota ei tarvita. Kaikki kolme hyväksyvät yleisen saapuvan webhookin:

  • Make: luo ”Custom Webhook” -moduuli ja kopioi luotu URL.
  • Zapier: ”Webhooks by Zapier” → ”Catch Hook” -käynnistin.
  • n8n: Webhook-solmu, käytä tuotanto-URL-osoitetta.

Syötä URL MeetingIQ:ssa kohdassa Einstellungen → API & Webhooks (Asetukset → API ja webhookit). Napsauttamalla ”Testen” (Testaa) lähetät heti testitoimituksen, joten voit rakentaa kenttävastaavuudet odottamatta seuraavaa kokousta.

Tietosuoja

Käsittely ja tallennus tapahtuvat yksinomaan EU:ssa. Tunnuksista tallennetaan vain tiiviste, ne voi perua milloin tahansa, ja jokainen webhook-toimitus allekirjoitetaan. API:n kautta tehdyt haut ovat jäljitettävissä tarkastuslokista. Lisätietoja on tietosuojakeskuksessamme ja tietojenkäsittelysopimuksessa (molemmat saksaksi).

Kysyttävää integraatiosta?

Kerro, mihin järjestelmään tietojen pitäisi päätyä, niin teemme määritykset kerran yhdessä kanssasi.

Kokeile maksuttaOta yhteyttä