API ja Zapier
API ja Zapier
Jokainen InterMINDin tuottama yhteenveto voi päätyä siihen työkaluun, jossa työskentelet – CRM-järjestelmään, asiakaspalveluun, tehtävienhallintaan tai taulukkoon – ilman että kukaan kopioi sitä käsin. Kolme tapaa yhdistää:
- Tekoälyavustajasi (Claude, ChatGPT, Copilot, Gemini ja muut MCP-asiakasohjelmat): katso Tekoälyavustajat (MCP).
- Zapier (ilman koodia): yhdistä InterMIND kerran API-avaimella ja rakenna sitten Zapit Meeting Recap Ready -triggerin ja Create Meeting Link -toiminnon varaan. Sama integraatio toimii myös Makessa, n8n:ssä ja Pipedreamissa niiden yleisten webhook- ja HTTP-moduulien kautta, käyttäen alla kuvattua API:a.
- API (kehittäjille): henkilökohtainen avain, yksi webhook-tapahtuma ja kymmenkunta rajapintaa – meetingit, yhteenvedot, litteraatit, kanavat, dokumentit.
Saatavilla: jokaiselle rekisteröityneelle tilille. Vieraat eivät voi luoda avaimia. Sijainti: Integrations → API keys.
API-avaimet
- Avaa Integrations ja etsi API keys -kortti.
- Napsauta Create key, anna avaimelle nimi (sen työkalun nimi, joka avainta käyttää, esim. "Zapier") ja kopioi avain. Se alkaa merkeillä
imk_ja näytetään vain kerran – InterMIND tallentaa ainoastaan sen tiivisteen (hash). - Voit perua avaimen samasta kortista milloin tahansa. Kyseisellä avaimella luodut webhook-tilaukset lakkaavat toimimasta heti.
Enintään 10 avainta tiliä kohden. Lähetä avain bearer-tokenina:
Authorization: Bearer imk_…
Avaimet toimivat vain alla lueteltujen /api/v1-rajapintojen kanssa; ne eivät koskaan anna pääsyä verkkosovelluksen omaan API:in.
Zapier
- Lisää Zapierissa InterMIND-sovellus Zapiin ja liitä API-avaimesi pyydettäessä. Yhteys nimetään tilisi sähköpostiosoitteen mukaan.
- Trigger Meeting Recap Ready – laukeaa kerran jokaisesta isännöimästäsi päättyneestä meetingistä heti, kun yhteenveto on valmis. Kentät: meetingin otsikko ja linkki, yhteenvedon linkki, litteraatin linkki, yhteenveto Markdown-muodossa, yhteenvedon kieli, alkamis- ja päättymisaika, osallistujat (nimi, sähköposti), isäntä.
- Toiminto Create Meeting Link – luo omistamasi ad hoc -meetingin ja palauttaa sen URL-osoitteen. Lisää se CRM-kauppaan, tukipyyntöön tai kalenterikutsuun; kuka tahansa linkin avaava koputtaa, ja sinä hyväksyt hänet huoneeseen.
Tyypillisiä Zapeja: yhteenveto → uusi muistiinpano HubSpotin kauppaan; yhteenveto → sisäinen kommentti Zendesk-tukipyyntöön; yhteenveto → rivi Google Sheetsiin; uusi Pipedrive-kauppa → meeting-linkki kirjoitetaan takaisin kauppaan.
Rajapinnat
Perus-URL: https://intermind.com/api/v1. Kaikki vastaukset ovat JSON-muodossa. Koneluettava kuvaus (OpenAPI 3.1, Makea, n8n:ää, Pipedreamia ja tekoälyagentteja varten): https://intermind.com/api/v1/openapi.json.
| Metodi | Polku | Tarkoitus |
|---|---|---|
GET | /me | Avaimen omistaja: { id, email, name } |
POST | /meetings | Luo ad hoc -meetinglinkin. Body { "title": "…" } (valinnainen). Palauttaa 201 { id, url, title, created_at }. Kun mukana on starts_at (YYYY-MM-DDTHH:mm), time_zone sekä valinnaisesti duration_min ja invitees, meeting kirjoitetaan myös yhdistettyyn kalenteriisi; vastaukseen lisätään ajankohta ja calendar: created / not_connected / failed |
GET | /meetings?kind=recent|upcoming&type=&limit=10 | Meetingit, joita isännöit tai joihin osallistut: recent viimeisimmän toiminnan mukaan, upcoming tulevaisuuteen ajoitetut |
GET | /meetings/{id}/transcript?session=&max_chars=60000 | Viimeisin viimeistelty litteraatti Markdown-muodossa puhujittain, puhutulla kielellä (tai välimuistissa olevana käännöksenäsi); truncated, kun sisältöä on katkaistu |
GET | /recaps?limit=3 | Uusimmat yhteenvetosi (1–10), uusin ensin, webhookin sisällön muodossa |
GET | /recaps/search?q=&limit=5 | Yhteenvedot, joiden otsikossa tai nykyisessä yhteenvedossa mainitaan hakusanat (sanamuodot huomioidaan), korostetun katkelman ja linkkien kera |
GET | /channels?limit=20 | Tiimichatit ja postilaatikot, joihin kuulut |
GET | /channels/{id}/messages?limit=50&before= | Yksi sivu kanavan keskustelua, vanhin ensin, sekä välimuistissa oleva käännös chat-kielellesi, jos huone on sellaisen tehnyt |
POST | /channels/{id}/messages | Julkaise { "text": "…" } omissa nimissäsi → 201 { id, sent_at, text }; välitetään reaaliaikaisesti ja käännetään jokaiselle lukijalle |
GET | /documents?meeting_id=&limit=50 | Meetingeissäsi jaetut tiedostot – lataukset ja linkitetyt Drive- ja OneDrive-tiedostot |
GET | /webhooks | Webhook-tilauksesi |
POST | /webhooks | Tilaa: { "target_url": "https://…", "event": "recap.ready" } → 201 { id, event, target_url, secret, created_at } |
DELETE | /webhooks/{id} | Peru tilaus → 204 |
Avain sisältää ne oikeudet, joilla se on luotu: ennen syyskuuta 2026 luodut avaimet avaavat vain /me, POST /meetings, /recaps ja /webhooks -rajapinnat – uudemmat rajapinnat vastaavat 403, kunnes luot uuden avaimen (tai yhdistät sovelluksen uudelleen). Lukeminen rajoittuu meetingeihin, joita isännöit tai joihin osallistut: toisen meetingin tunnus palauttaa 404.
Rajat: 10 avainta ja 20 webhook-tilausta tiliä kohden. target_url:n on oltava https:// ja julkisesti tavoitettavissa – yksityisverkon osoitteet hylätään.
Webhook: recap.ready
Lähetetään POST-pyyntönä JSON-muodossa jokaiseen tilattuun target_url-osoitteeseen heti, kun isännöimäsi meetingin yhteenveto on viimeistelty ja sen sisältö ei ole tyhjä. Se lähetetään kerran meetingin istuntoa kohden. Otsakkeet:
| Otsake | Arvo |
|---|---|
X-InterMIND-Event | recap.ready |
X-InterMIND-Delivery | Tämän tapahtuman yksilöllinen tunnus (<meeting id>.<session id>) – poista kaksoiskappaleet sen perusteella |
X-InterMIND-Signature | sha256=<HMAC-SHA256 raakasisällöstä tilauksen secret-avaimella> |
User-Agent | InterMIND-Webhooks/1 |
Sisältö:
{
"id": "abc-def-ghi.conf_01",
"event": "recap.ready",
"occurred_at": "2026-09-04T10:32:11.000Z",
"meeting": { "id": "abc-def-ghi", "title": "Weekly sync with Acme", "url": "https://intermind.com/abc-def-ghi", "type": "adhoc" },
"recap": {
"url": "https://intermind.com/r/abc-def-ghi/…",
"transcript_url": "https://intermind.com/t/abc-def-ghi/…",
"summary_md": "## Decisions\n- …",
"language": "en"
},
"session": { "started_at": "2026-09-04T10:00:03.000Z", "ended_at": "2026-09-04T10:31:40.000Z" },
"participants": [{ "name": "Anna Müller", "email": "anna@acme.example" }],
"host": { "name": "Anna Müller", "email": "anna@acme.example" }
}
Toimitussäännöt: päätepisteesi tulisi vastata 2xx 8 sekunnin kuluessa. Verkkovirhe, 5xx tai 429 yritetään uudelleen kerran välittömästi. 410 tai 404 poistaa tilauksen. Mikä tahansa muu virhe kirjataan lokiin, eikä tapahtumaa lähetetä uudelleen – yhteenvetosähköposti ja yhteenvetosivu säilyvät pysyvänä tietueena. Yhteenvedon ja litteraatin linkit aukeavat meetingin osallistujille, jotka ovat kirjautuneet sisään.