D'fhorbróirí

API agus webhooks

Tarraing tras-scríbhinní, achoimrí agus tascanna isteach i do chórais féin go huathoibríoch, tríd an REST API nó trí webhook. Gan cor bealaigh trí sheirbhísí Meiriceánacha: ritheann gach rud ar ár mbonneagar san AE.

Bain triail as saor in aisce ar feadh 14 lá Féach na praghsanna

San áireamh ón bplean Pro ar aghaidh. Tá rochtain ar an API cumasaithe cheana féin le linn na trialach 14 lá.

Ceangailte i 3 chéim

In MeetingIQ, cruthaigh comhartha API faoi Einstellungen → API & Webhooks (Socruithe → API agus webhooks). Ar chúiseanna slándála, ní thaispeántar é ach uair amháin.
Cuir fiosrúcháin chuig an REST API, nó cuir isteach URL webhook a seolfaimid gach cruinniú críochnaithe chuige.
Sin é. Do Make, Zapier nó n8n, níl uait ach an URL webhook a ghintear ansin.

REST API

Is le haghaidh léimh amháin atá gach críochphointe, tugann siad JSON ar ais agus bíonn siad ag súil leis an gcomhartha sa cheanntáscAuthorization: Bearer miq_…Teorainn: 120 iarratas in aghaidh an nóiméid in aghaidh an chomhartha.

GET/api/v1/meetingsLiosta, is féidir scagadh de réir stádais

GET/api/v1/meetings/{id}Achoimre, príomhphointí, tascanna

GET/api/v1/meetings/{id}/transcriptTéacs iomlán + míreanna de réir cainteora

Sampla

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

Freagra

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

Chomh luath agus a bhíonn cruinniú próiseáilte go hiomlán, seolaimid an toradh iomlán chuig do URL trí POST, sa struchtúr céanna leis an API. Déantar seachadtaí a theip a atriail go huathoibríoch, agus is féidir gach seachadadh agus a stádas a fheiceáil sa chomhéadan.

POST https://your-domain.com/hook
X-MeetingIQ-Event:     meeting.completed
X-MeetingIQ-Delivery:  9f1c…            (Aitheantas an tseachadta seo)
X-MeetingIQ-Signature: sha256=…         (HMAC thar an gcorp amh)

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

Fíoraigh an síniú (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 agus n8n

Níl comhtháthú breise uait chuige seo. Glacann an trí cinn acu le webhook ginearálta isteach:

Make: cruthaigh modúl “Custom Webhook” agus cóipeáil an URL a ghintear.
Zapier: “Webhooks by Zapier” → truicear “Catch Hook”.
n8n: nód Webhook, úsáid an URL táirgeachta.

Cuir an URL isteach in MeetingIQ faoi Einstellungen → API & Webhooks (Socruithe → API agus webhooks). Má chliceálann tú ar “Testen” (Tástáil), seoltar seachadadh tástála láithreach, ionas gur féidir leat mapáil na réimsí a thógáil gan fanacht leis an gcéad chruinniú eile.

Cosaint sonraí

Is san AE amháin a dhéantar an phróiseáil agus an stóráil. Ní stóráiltear comharthaí ach mar haiseáil, is féidir iad a chúlghairm am ar bith, agus sínítear gach seachadadh webhook. Is féidir aisghabháil tríd an API a rianú sa loga iniúchta. Tá tuilleadh eolais inár lárionad príobháideachais agus sa chomhaontú próiseála sonraí (iad araon i nGearmáinis).

Ceisteanna faoin gcomhtháthú?

Inis dúinn cén córas ar chóir do na sonraí dul chuige, agus socróimid é uair amháin in éineacht leat.

Bain triail as saor in aisce Déan teagmháil linn