API & 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. Due modi per farlo:
- Zapier (senza codice): collega InterMIND una sola 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 tre endpoint.
Disponibile su: ogni account registrato. Gli ospiti non possono creare chiavi. Dove: Impostazioni → Chiavi API.
Chiavi API
- Apri Impostazioni e trova la scheda Chiavi API.
- Fai clic su Crea chiave, assegnale un'etichetta (lo strumento che la userà, ad es. "Zapier") e copia la chiave. Inizia con
imk_e viene mostrata una sola volta — InterMIND conserva 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 propria dell'applicazione web.
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.
- Trigger Meeting Recap Ready — si attiva una volta per ogni riunione terminata che hai ospitato, non appena il riepilogo è disponibile. Campi: titolo e link della riunione, link del recap, link della trascrizione, il riepilogo in Markdown, lingua del riepilogo, ora di inizio e fine, partecipanti (nome, email), host.
- Azione Create Meeting Link — crea una riunione ad hoc di tua proprietà e restituisce il relativo URL. Inseriscilo in un deal CRM, un ticket di supporto o un invito in calendario; chiunque apra il link bussa e tu lo approvi nella stanza.
Zap tipici: recap → nuova nota sul deal HubSpot; recap → commento interno sul ticket Zendesk; recap → riga in Google Sheets; nuovo deal Pipedrive → link di riunione scritto sul deal.
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 } |
GET | /recaps?limit=3 | I tuoi recap più recenti (1–10), dal più nuovo, nel formato del payload del webhook |
GET | /webhooks | Le tue sottoscrizioni webhook |
POST | /webhooks | Iscriviti: { "target_url": "https://…", "event": "recap.ready" } → 201 { id, event, target_url, secret, created_at } |
DELETE | /webhooks/{id} | Annulla l'iscrizione → 204 |
Limiti: 10 chiavi e 20 sottoscrizioni webhook per account. target_url deve essere https:// e pubblicamente raggiungibile — gli indirizzi di rete privata 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 riepilogo 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 deve 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 errore 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.