La Guida di Mokapen

Jamie

L'integrazione Jamie porta automaticamente in Mokapen i trascritti e le note AI da meetjamie.ai. Quando una riunione viene elaborata in Jamie, Mokapen può creare un documento, una nota oppure un puntatore leggero e — quando possibile — collegare il risultato all'appuntamento già presente in calendario.

Jamie è un AI note taker privacy-first che lavora senza bot in call. L'integrazione è pensata per team sales e customer success che già registrano con Jamie e vogliono l'esito (riepilogo, action item, dialogo) accanto all'appuntamento CRM.

Panoramica generale sulle integrazioni: Integrazioni.

Requisiti

• Un piano Mokapen che include l'integrazione Jamie (Premium — icona medaglia sulla pagina se non disponibile sul tuo piano).
• Un account Jamie su piano Pro / Team / Enterprise (o idoneo) con permesso di creare API key e webhook.
• Consigliato: Google Calendar o Outlook Calendar sincronizzati con Mokapen, così gli appuntamenti si possono abbinare tramite id evento calendario.

Collegamento

Jamie si collega con una API key (niente OAuth). Incolli la chiave una volta in Mokapen, poi configuri il webhook che notifica Mokapen quando la riunione è pronta.

1. Menu utente → Integrazioni → Jamie.
2. Clicca Sincronizza / Collega (serve un piano Premium adeguato).
3. Crea un'API key in Jamie: Settings → Developers → API Keys (documentazione developer). Puoi usare una chiave personal (/v1/me) o workspace (/v1/workspace).
4. Incolla la chiave in Mokapen e conferma Collega.
5. Se il collegamento va a buon fine, la pagina sblocca webhook e opzioni di salvataggio.

Webhook

Dopo aver collegato l'API key, la pagina Integrazioni → Jamie mostra un URL webhook da copiare. In Jamie vai su Settings → Integrations → Webhooks, crea un webhook, incolla l'URL Mokapen e iscriviti all'evento meeting.completed.

Scegli l'autenticazione in Jamie:

• API key (consigliata) — Jamie invia il secret nell'header x-jamie-api-key. Incolla lo stesso secret in Mokapen come Webhook secret.
• Signature — Jamie firma con HMAC-SHA256 in x-jamie-signature. Incolla il signing secret in Mokapen.

Premi Salva in Mokapen dopo aver modificato secret o opzioni di salvataggio.

Impostazioni di salvataggio

• Documento — crea un documento con il contenuto della riunione.
• Nota — crea una nota collegata all'appuntamento abbinato quando possibile.
• URL — conserva un puntatore leggero senza importare tutto il testo.

Puoi anche attivare/disattivare summary (con action items) e transcript.

Abbinamento appuntamenti

Mokapen prova ad abbinare l'appuntamento usando l'externalId dell'evento calendario inviato da Jamie (id già presenti dalla sync Google/Outlook).

Se non c'è match, documento/nota vengono creati comunque senza collegamento.

Condivisione

Come le altre integrazioni, puoi condividere il collegamento Jamie con i colleghi o con tutta l'organizzazione dai controlli di sync sharing.

Cosa succede dopo una riunione

1. Jamie termina l'elaborazione e invia meeting.completed (summary, transcript e task nel payload).
2. Mokapen verifica eventualmente secret/firma e mette in coda un job.
3. Il job usa il contenuto del webhook (con eventuale fallback API meetings.get), applica le tue opzioni e crea documento/nota.
4. Se trova un appuntamento, collega l'elemento.
5. Le consegne duplicate dello stesso meeting vengono ignorate.

Problemi comuni

• Non compare nulla dopo una call — verifica URL webhook, evento meeting.completed, integrazione attiva, piano Premium e che il queue worker sia in esecuzione.
• Documento creato ma non sull'appuntamento — l'externalId calendario non ha fatto match. Mantieni attiva la sync calendario.
• Webhook rifiutato / errori di firma — il secret in Mokapen deve coincidere con quello di Jamie.
• Viene salvato poco contenuto — controlla Salva come e le checkbox summary/transcript.
• API key non valida — rigenera la chiave in Jamie e riconnetti. Serve un piano Jamie idoneo.

Disconnessione

Usa Disconnetti in Integrazioni → Jamie e disabilita/elimina anche il webhook in Jamie se non vuoi più ricevere eventi. I documenti già creati restano in Mokapen.

FAQ

D: Mokapen entra in call come bot?

R: No. Jamie registra senza bot; Mokapen riceve solo le note già elaborate via webhook/API.

D: Chiave personal o workspace?

R: Entrambe funzionano. Mokapen rileva lo scope al collegamento. Usa una workspace key se ti servono le riunioni di tutto il workspace Jamie.

D: Documentazione ufficiale?

R: API e Webhooks.