API ir Zapier
API ir Zapier
Kiekviena InterMIND parengta santrauka gali atsidurti įrankyje, kuriame dirbate: jūsų CRM, pagalbos tarnybos sistemoje, užduočių sekimo įrankyje ar skaičiuoklėje, ir niekam nereikės jos kopijuoti rankomis. Yra trys keliai:
- Jūsų DI asistentas (Claude, ChatGPT, Copilot, Gemini ir bet kuris kitas MCP klientas): žr. DI asistentai (MCP).
- Zapier (be programavimo): vieną kartą prijunkite InterMIND API raktu, tada kurkite Zap'us su trigeriu Meeting Recap Ready ir veiksmu Create Meeting Link. Ta pati integracija veikia ir su Make, n8n ar Pipedream, naudojant jų bendruosius webhook ir HTTP modulius bei toliau aprašytą API.
- API (kūrėjams): asmeninis raktas, vienas webhook įvykis ir keliolika galinių taškų: susitikimai, santraukos, transkripcijos, kanalai, dokumentai.
Prieinama: kiekvienoje registruotoje paskyroje. Svečiai raktų kurti negali. Kur: Integrations → API keys.
API raktai
- Atidarykite Integrations ir suraskite kortelę API keys.
- Spustelėkite Create key, suteikite raktui pavadinimą (įrankio, kuris jį naudos, pvz., „Zapier“) ir nukopijuokite raktą. Jis prasideda
imk_ir rodomas tik vieną kartą: InterMIND saugo tik jo maišą (hash). - Raktą bet kada galite atšaukti toje pačioje kortelėje. Su tuo raktu sukurtos webhook prenumeratos iškart nustoja veikti.
Iki 10 raktų vienai paskyrai. Raktą siųskite kaip bearer žetoną:
Authorization: Bearer imk_…
Raktai veikia tik su toliau aprašytais /api/v1 galiniais taškais; jie niekada nesuteikia prieigos prie paties žiniatinklio programos API.
Zapier
- Zapier sistemoje pridėkite programą InterMIND į Zap'ą ir paprašyti įklijuokite savo API raktą. Prisijungimas pažymimas jūsų paskyros el. pašto adresu.
- Trigeris Meeting Recap Ready suveikia vieną kartą per kiekvieną jūsų vestą baigtą susitikimą, kai tik atsiranda santrauka. Laukai: susitikimo pavadinimas ir nuoroda, santraukos nuoroda, transkripcijos nuoroda, santrauka Markdown formatu, santraukos kalba, pradžios ir pabaigos laikas, dalyviai (vardas, el. paštas), vedėjas.
- Veiksmas Create Meeting Link sukuria jūsų valdomą neplanuotą susitikimą ir grąžina jo URL. Įdėkite jį į CRM sandorį, pagalbos užklausą ar kalendoriaus kvietimą; kiekvienas, atidaręs nuorodą, pasibels, o jūs patvirtinsite jį susitikimo kambaryje.
Tipiniai Zap'ai: santrauka → nauja pastaba HubSpot sandoryje; santrauka → vidinis komentaras Zendesk užklausoje; santrauka → eilutė Google Sheets; naujas Pipedrive sandoris → susitikimo nuoroda įrašoma atgal į sandorį.
Galiniai taškai
Bazinis URL: https://intermind.com/api/v1. Visi atsakymai yra JSON formato. Mašininiu būdu skaitoma specifikacija (OpenAPI 3.1, skirta Make, n8n, Pipedream ir DI agentams): https://intermind.com/api/v1/openapi.json.
| Metodas | Kelias | Paskirtis |
|---|---|---|
GET | /me | Kam priklauso raktas: { id, email, name } |
POST | /meetings | Sukuria neplanuoto susitikimo nuorodą. Turinys { "title": "…" } (neprivalomas). Grąžina 201 { id, url, title, created_at }. Nurodžius starts_at (YYYY-MM-DDTHH:mm), time_zone, neprivalomus duration_min ir invitees, susitikimas papildomai įrašomas į jūsų prijungtą kalendorių; atsakyme atsiranda laiko intervalas ir calendar: created / not_connected / failed |
GET | /meetings?kind=recent|upcoming&type=&limit=10 | Susitikimai, kuriuos vedate arba kuriuose dalyvaujate: recent pagal paskutinę veiklą, upcoming suplanuoti ateityje |
GET | /meetings/{id}/transcript?session=&max_chars=60000 | Naujausia galutinė transkripcija Markdown formatu pagal kalbėtoją, kalbėta kalba (arba jūsų išsaugotas vertimas); truncated, kai sutrumpinta |
GET | /recaps?limit=3 | Jūsų naujausios santraukos (1–10), naujausios pirmos, webhook turinio formatu |
GET | /recaps/search?q=&limit=5 | Santraukos, kurių pavadinime ar dabartinėje santraukoje minimi žodžiai (atitinka žodžių formos), su paryškintu fragmentu ir nuorodomis |
GET | /channels?limit=20 | Komandos pokalbiai ir gautieji, kuriems priklausote |
GET | /channels/{id}/messages?limit=50&before= | Vienas kanalo pokalbio puslapis, seniausios žinutės pirmos, su išsaugotu vertimu į jūsų pokalbio kalbą, jei kambarys jį sukūrė |
POST | /channels/{id}/messages | Paskelbia { "text": "…" } jūsų vardu → 201 { id, sent_at, text }; išsiunčiama tiesiogiai ir išverčiama kiekvienam skaitytojui |
GET | /documents?meeting_id=&limit=50 | Jūsų susitikimuose bendrinami failai: įkelti ir susieti Drive / OneDrive failai |
GET | /webhooks | Jūsų webhook prenumeratos |
POST | /webhooks | Užsiprenumeruoti: { "target_url": "https://…", "event": "recap.ready" } → 201 { id, event, target_url, secret, created_at } |
DELETE | /webhooks/{id} | Atsisakyti prenumeratos → 204 |
Raktas turi tas teises, su kuriomis buvo sukurtas: raktai, sukurti iki 2026 m. rugsėjo, atveria tik /me, POST /meetings, /recaps ir /webhooks, o naujesni galiniai taškai atsako 403, kol sukursite naują raktą (arba iš naujo prijungsite programą). Skaityti galima tik susitikimus, kuriuos vedate arba kuriuose dalyvaujate: kito susitikimo id atsako 404.
Apribojimai: 10 raktų ir 20 webhook prenumeratų vienai paskyrai. target_url turi būti https:// ir viešai pasiekiamas; privataus tinklo adresai atmetami.
Webhook: recap.ready
Siunčiamas kaip POST JSON į kiekvieną prenumeruotą target_url, kai tik baigiama rengti santrauka susitikimo, kurį jūs vedėte, ir ji nėra tuščia. Siunčiamas vieną kartą per susitikimo sesiją. Antraštės:
| Antraštė | Reikšmė |
|---|---|
X-InterMIND-Event | recap.ready |
X-InterMIND-Delivery | Unikalus šio įvykio id (<meeting id>.<session id>): pagal jį šalinkite dublikatus |
X-InterMIND-Signature | sha256=<HMAC-SHA256 of the raw body with the subscription's secret> |
User-Agent | InterMIND-Webhooks/1 |
Turinys:
{
"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" }
}
Pristatymo taisyklės: jūsų galinis taškas turėtų atsakyti 2xx per 8 sekundes. Dėl tinklo klaidos, 5xx ar 429 siunčiama dar kartą, vieną kartą ir iškart. 410 arba 404 ištrina prenumeratą. Bet kuri kita nesėkmė užfiksuojama žurnale, o įvykis nesiunčiamas iš naujo: santraukos el. laiškas ir santraukos puslapis lieka patvariu įrašu. Santraukos ir transkripcijos nuorodos atsidaro susitikimo dalyviams, kurie yra prisijungę.