API e Zapier
API & Zapier
Ogni recap prodotto da InterMIND può arrivare nello strumento in cui lavori — il tuo CRM, l'help desk, il task tracker o un foglio di calcolo — senza che nessuno lo copi a mano. Tre modi per farlo:
- Il tuo assistente AI (Claude, ChatGPT, Copilot, Gemini e qualsiasi altro client MCP): vedi Assistenti AI (MCP).
- Zapier (senza codice): collega InterMIND una volta con una chiave API, poi crea Zap sul trigger Meeting Recap Ready e sull'azione Create Meeting Link. La stessa integrazione funziona anche da Make, n8n o Pipedream tramite i loro moduli webhook e HTTP generici, usando l'API qui sotto.
- L'API (per sviluppatori): una chiave personale, un evento webhook e una dozzina di endpoint — riunioni, recap, trascrizioni, canali, documenti.
Disponibile per: ogni account registrato. Gli ospiti non possono creare chiavi. Dove: Integrazioni → Chiavi API.
Chiavi API
- Apri Integrazioni e trova la scheda Chiavi API.
- Fai clic su Crea chiave, assegna un'etichetta (lo strumento che la userà, es. "Zapier") e copia la chiave. Inizia con
imk_e viene mostrata una sola volta — InterMIND memorizza solo un hash. - Revoca una chiave dalla stessa scheda in qualsiasi momento. Le sottoscrizioni webhook create con quella chiave si interrompono immediatamente.
Fino a 10 chiavi per account. Invia la chiave come bearer token:
Authorization: Bearer imk_…
Le chiavi funzionano solo sugli endpoint /api/v1 qui sotto; non concedono mai accesso all'API dell'applicazione web stessa.
Zapier
- In Zapier, aggiungi l'app InterMIND a uno Zap e incolla la tua chiave API quando richiesto. La connessione viene etichettata con l'email del tuo account.
- Attiva il trigger Meeting Recap Ready — si attiva una volta per ogni riunione conclusa che hai ospitato, non appena il riassunto è disponibile. Campi: titolo e link della riunione, link del recap, link della trascrizione, il riassunto in Markdown, lingua del riassunto, ora di inizio e di fine, partecipanti (nome, email), host.
- Azione Create Meeting Link — crea una riunione ad hoc di tua proprietà e ne restituisce l'URL. Inseriscilo in un'offerta CRM, un ticket di supporto o un invito al calendario; chiunque apra il link bussa e tu lo approvi nella stanza.
Zap tipici: recap → nuova nota sull'offerta HubSpot; recap → commento interno sul ticket Zendesk; recap → riga in Google Sheets; nuova offerta Pipedrive → link della riunione riportato sull'offerta.
Endpoint
URL di base: https://intermind.com/api/v1. Tutte le risposte sono in JSON. Contratto leggibile da macchina (OpenAPI 3.1, per Make, n8n, Pipedream e agenti AI): https://intermind.com/api/v1/openapi.json.
| Metodo | Percorso | Scopo |
|---|---|---|
GET | /me | Chi possiede la chiave: { id, email, name } |
POST | /meetings | Crea un link per una riunione ad hoc. Body { "title": "…" } (opzionale). Restituisce 201 { id, url, title, created_at }. Con starts_at (YYYY-MM-DDTHH:mm), time_zone, duration_min e invitees opzionali, la riunione viene scritta anche nel tuo calendario collegato; la risposta aggiunge la finestra e calendar: created / not_connected / failed |
GET | /meetings?kind=recent|upcoming&type=&limit=10 | Riunioni che ospiti o a cui partecipi: recent per ultima attività, upcoming in programma nel futuro |
GET | /meetings/{id}/transcript?session=&max_chars=60000 | Ultima trascrizione finalizzata in Markdown per parlante, nella lingua parlata (o la tua traduzione in cache); truncated quando viene tagliata |
GET | /recaps?limit=3 | I tuoi recap più recenti (1–10), dal più recente, nella forma del payload webhook |
GET | /recaps/search?q=&limit=5 | Recap il cui titolo o riassunto corrente menziona le parole (corrispondenza sulle forme delle parole), con uno snippet evidenziato e link |
GET | /channels?limit=20 | Chat di team e inbox a cui appartieni |
GET | /channels/{id}/messages?limit=50&before= | Una pagina della chat di un canale, dalla più vecchia, con la traduzione in cache nella lingua della chat quando la stanza ne aveva creata una |
POST | /channels/{id}/messages | Pubblica { "text": "…" } come te → 201 { id, sent_at, text }; diffuso in tempo reale e tradotto per ogni lettore |
GET | /documents?meeting_id=&limit=50 | File condivisi nelle tue riunioni — upload e file di Drive / OneDrive collegati |
GET | /webhooks | Le tue sottoscrizioni webhook |
POST | /webhooks | Sottoscrivi: { "target_url": "https://…", "event": "recap.ready" } → 201 { id, event, target_url, secret, created_at } |
DELETE | /webhooks/{id} | Annulla la sottoscrizione → 204 |
Una chiave porta con sé i diritti con cui è stata creata: le chiavi create prima di settembre 2026 aprono solo /me, POST /meetings, /recaps e /webhooks — gli endpoint più recenti rispondono 403 finché non crei una nuova chiave (o ricolleghi l'app). La lettura è limitata alle riunioni che ospiti o a cui partecipi: l'id di un'altra riunione risponde 404.
Limiti: 10 chiavi e 20 sottoscrizioni webhook per account. target_url deve essere https:// e pubblicamente raggiungibile — gli indirizzi di rete privati vengono rifiutati.
Webhook: recap.ready
Inviato come POST JSON a ogni target_url sottoscritto nel momento in cui un recap per una riunione che hai ospitato viene finalizzato con un riassunto non vuoto. Viene inviato una volta per sessione di riunione. Header:
| Header | Valore |
|---|---|
X-InterMIND-Event | recap.ready |
X-InterMIND-Delivery | ID univoco di questo evento (<meeting id>.<session id>) — usalo per la deduplicazione |
X-InterMIND-Signature | sha256=<HMAC-SHA256 del body raw con il secret della sottoscrizione> |
User-Agent | InterMIND-Webhooks/1 |
Payload:
{
"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" }
}
Regole di consegna: il tuo endpoint dovrebbe rispondere 2xx entro 8 secondi. Un errore di rete, 5xx o 429 viene ritentato una volta immediatamente. Un 410 o 404 elimina la sottoscrizione. Qualsiasi altro fallimento viene registrato e l'evento non viene reinviato — l'email del recap e la pagina del recap restano il record durevole. I link del recap e della trascrizione si aprono per i partecipanti alla riunione che hanno effettuato l'accesso.