La Guida di Mokapen

Fathom

L'integrazione Fathom porta automaticamente in Mokapen i trascritti e le note AI delle riunioni. Quando una chiamata viene elaborata in Fathom, Mokapen può creare un documento, una nota oppure conservare solo l'URL della riunione e — quando possibile — collegare il risultato all'appuntamento già presente in calendario.

È pensata per team di vendita e customer success che già registrano le call in Fathom e vogliono l'esito (riepilogo, action item, dialogo completo) accanto all'appuntamento CRM, senza esportare file a mano.

Panoramica generale sulle integrazioni: Integrazioni.

Requisiti

• Un piano Mokapen che include l'integrazione Fathom (Premium — icona medaglia sulla pagina se non disponibile sul tuo piano).
• Un account Fathom attivo con permesso di creare API key e/o webhook.
• Consigliato: Google Calendar o Outlook Calendar sincronizzati con Mokapen, così gli appuntamenti si possono abbinare per id evento o URL della riunione.

Collegamento

A differenza delle app calendario OAuth, Fathom si collega con una API key. Incolli la chiave una volta in Mokapen, poi configuri il webhook che notifica Mokapen quando il trascritto è pronto.

1. Menu utente → Integrazioni → Fathom.
2. Clicca Sincronizza / Collega (serve un piano Premium adeguato).
3. Crea o copia l'API key da Fathom (documentazione developer).
4. Incolla la chiave in Mokapen e conferma Collega.
5. Se il collegamento va a buon fine, la pagina mostra l'account connesso e sblocca webhook e opzioni di salvataggio.

Webhook

Dopo aver collegato l'API key, la pagina Integrazioni → Fathom mostra un URL webhook da copiare. Incollalo in Fathom API Access settings e iscriviti all'evento che scatta quando il trascritto è pronto (in genere meeting transcribed).

Opzionale: imposta un Webhook secret in Mokapen e usa lo stesso valore come optional webhook secret from Fathom API Access. In produzione è consigliato, così vengono accettate solo richieste autentiche da Fathom.

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

Impostazioni di salvataggio

Sempre in Integrazioni → Fathom, scegli come salvare ogni riunione elaborata in Mokapen:

• Documento — crea un documento con il contenuto della riunione (ideale per condividere trascritti lunghi col team).
• Nota — crea una nota collegata all'appuntamento abbinato o disponibile tra le note.
• URL — conserva principalmente il link alla registrazione in Fathom, senza importare tutto il testo.

Puoi anche scegliere se includere il riepilogo e il trascritto (AI summary, action items and full transcript). Disattivando entrambi in modalità URL resta solo un puntatore leggero alla registrazione esterna.

Abbinamento agli appuntamenti

Quando arriva un trascritto, Mokapen prova ad associarlo a un appuntamento esistente:

1. Prima cerca un id di sync calendario già salvato per quella riunione (integrazioni Google Calendar o Outlook Calendar).
2. Se non lo trova, confronta l'URL della riunione da Fathom con il campo URL degli appuntamenti.
3. Se nessun appuntamento corrisponde, documento o nota vengono comunque creati — semplicemente senza link all'evento calendario.

Suggerimento: tieni sullo scheda appuntamento lo stesso link meeting che Fathom registra (Zoom, Meet, Teams…) e mantieni attiva la sync calendario per l'abbinamento più affidabile.

Condivisione con il team

Come le altre integrazioni Mokapen, puoi condividere il collegamento Fathom con colleghi o team dai controlli di condivisione sync nella pagina impostazioni. Gli utenti condivisi ricevono i trascritti in organizzazione senza collegare ciascuno la propria chiave.

Cosa succede dopo una riunione

1. Fathom termina l'elaborazione della registrazione e invia il webhook (o Grain consegna meeting transcribed).
2. Mokapen riceve il payload, eventualmente verifica firma/secret, e mette in coda un job in background.
3. Il job recupera riepilogo/trascritto via API se serve, applica le opzioni di salvataggio e crea documento/nota/URL.
4. Se trova un appuntamento abbinato, collega il nuovo elemento così compare nel contesto giusto.
5. Le consegne duplicate della stessa registrazione vengono ignorate (deduplica sync), così i retry non creano doppioni.

Problemi comuni

• Non compare nulla dopo una call — verifica che il webhook sia incollato correttamente in Fathom (eccetto Grain, dove è automatico), che l'integrazione sia ancora collegata e che il piano Premium includa l'app.
• Documento creato ma non sull'appuntamento — URL meeting o id evento calendario non corrispondevano. Apri l'appuntamento, controlla l'URL e assicurati che la sync calendario sia attiva.
• Webhook rifiutato / errori di firma — il secret in Mokapen deve coincidere esattamente con quello in Fathom; se dubbi, rigenera entrambi i lati.
• Viene salvato solo il link — controlla Salva come e le checkbox riepilogo/trascritto; la modalità URL salta intenzionalmente il corpo completo.
• API key non valida — rigenera la chiave in Fathom e ricollega da Integrazioni → Fathom.

Disconnessione

Usa Disconnetti nella pagina Integrazioni → Fathom (disponibile per l'utente che ha collegato l'integrazione). Rimuovi o disattiva anche il webhook in Fathom se non vuoi più ricevere consegne.

Documenti e note già creati restano in Mokapen; la disconnessione ferma solo l'arrivo di nuovi trascritti.

Casi d'uso

• Follow-up call commerciali — dopo una discovery registrata in Fathom, il riepilogo arriva come documento sull'appuntamento: l'AE condivide gli action item senza riscrivere le note.
• Archivio QBR CS — i quarterly business review restano ricercabili nei documenti Mokapen, collegati all'appuntamento cliente.
• Handoff tra ruoli — gli SDR registrano le demo in Fathom; i closer aprono l'appuntamento abbinato e leggono il trascritto senza cambiare tool.
• Puntatore leggero nel CRM — usa la modalità URL quando ti serve solo un deep link a Fathom dalla scheda appuntamento.

Domande frequenti

Q: Mokapen registra la riunione?

A: No. Registrazione e trascrizione avvengono in Fathom. Mokapen riceve solo l'esito via webhook e lo salva secondo le tue impostazioni.

Q: Serve sempre una API key?

A: Sì per Fathom: la incolli una volta per collegare. Poi il webhook consegna ogni trascritto completato.

Q: E se non c'è un appuntamento abbinato?

A: Documento o nota vengono creati comunque. Puoi collegarli a mano dopo, oppure sistemare URL meeting / sync calendario per le call successive.

Q: I colleghi possono usare il mio collegamento?

A: Sì, se condividi l'integrazione con loro dai controlli di condivisione sync nella pagina Integrazioni.

Q: Ricollegando si duplicano le vecchie riunioni?

A: Mokapen deduplica per identità di sync le registrazioni già importate. Le nuove riunioni continuano a creare nuovi documenti/note.

Q: Dove ritrovo le impostazioni?

A: Menu utente → Integrazioni → Fathom. URL webhook, secret e opzioni di salvataggio sono in quella pagina dopo il collegamento.