Għall-iżviluppaturi

API u webhooks

Daħħal it-traskrizzjonijiet, is-sommarji u l-kompiti awtomatikament fis-sistemi tiegħek, permezz tar-REST API jew ta' webhook. Bla ma tgħaddi minn servizzi Amerikani: kollox jaħdem fuq l-infrastruttura tagħna fl-UE.

Ipprova b'xejn għal 14-il jum Ara l-prezzijiet

Inkluż mill-pjan Pro 'il fuq. L-aċċess għall-API diġà jkun attiv matul il-prova ta' 14-il jum.

Konness f'3 passi

F'MeetingIQ, oħloq token tal-API taħt Einstellungen → API & Webhooks (Issettjar → API u webhooks). Għal raġunijiet ta' sigurtà, jintwera darba biss.
Jew ikkonsulta r-REST API, jew daħħal URL ta' webhook fejn nibagħtu kull laqgħa lesta.
Lest. Għal Make, Zapier jew n8n, għandek bżonn biss l-URL tal-webhook li jiġi ġġenerat hemm.

REST API

L-endpoints kollha huma għall-qari biss, jirritornaw JSON u jistennew it-token fl-headerAuthorization: Bearer miq_…Limitu: 120 talba kull minuta għal kull token.

GET/api/v1/meetingsLista, tista' tiffiltraha skont l-istatus

GET/api/v1/meetings/{id}Sommarju, punti ewlenin, kompiti

GET/api/v1/meetings/{id}/transcriptTest sħiħ + segmenti tal-kelliema

Eżempju

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

Tweġiba

{
  "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

Malli laqgħa tkun ġiet ipproċessata kompletament, nibagħtu r-riżultat sħiħ lill-URL tiegħek permezz ta' POST, bl-istess struttura tal-API. Il-kunsinni li jfallu jerġgħu jiġu ppruvati awtomatikament, u kull kunsinna tista' taraha bl-istatus tagħha fl-interfaċċja.

POST https://your-domain.com/hook
X-MeetingIQ-Event:     meeting.completed
X-MeetingIQ-Delivery:  9f1c…            (ID ta' din il-kunsinna)
X-MeetingIQ-Signature: sha256=…         (HMAC fuq il-body mhux ipproċessat)

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

Ivverifika l-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 u n8n

Għal dan m'għandekx bżonn integrazzjoni addizzjonali. It-tlieta jaċċettaw webhook ġeneriku li jidħol:

Make: oħloq modulu “Custom Webhook” u kkopja l-URL iġġenerat.
Zapier: “Webhooks by Zapier” → trigger “Catch Hook”.
n8n: node tal-Webhook, uża l-URL tal-produzzjoni.

Daħħal l-URL f'MeetingIQ taħt Einstellungen → API & Webhooks (Issettjar → API u webhooks). Klikk fuq “Testen” (Ittestja) jibgħat kunsinna tat-test minnufih, biex tkun tista' tibni l-mapping tal-oqsma mingħajr ma tistenna l-laqgħa li jmiss.

Protezzjoni tad-data

L-ipproċessar u l-ħażna jsiru esklużivament fl-UE. It-tokens jinħażnu biss bħala hash, jistgħu jiġu revokati fi kwalunkwe ħin, u kull kunsinna tal-webhook hija ffirmata. L-aċċess permezz tal-API jista' jiġi traċċat fir-reġistru tal-awditjar. Id-dettalji tista' ssibhom fiċ-ċentru tal-privatezza tagħna u fil-ftehim dwar l-ipproċessar tad-data (it-tnejn bil-Ġermaniż).

Mistoqsijiet dwar l-integrazzjoni?

Għidilna f'liema sistema għandha tmur id-data, u nissettjawha darba flimkien miegħek.

Ipprova b'xejn Ikkuntattjana