La Guida di Mokapen

Read.ai

L'integrazione Read.ai porta automaticamente in Mokapen i trascritti e le note AI delle riunioni. Quando una chiamata viene elaborata in Read.ai, 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 Read.ai e vogliono l'esito (riepilogo, action item, dialogo completo) accanto all'appuntamento CRM, senza esportare file a mano.

General integrations overview: Integrazioni.

Requisiti

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

Collegamento

Read.ai non usa un login con API key semplice in Mokapen. Prima attivi l'integrazione, poi incolli l'URL del webhook Mokapen in Read.ai così i report delle riunioni arrivano quando sono pronti.

1. Menu utente → Integrazioni → Read.ai.
2. Clicca Sincronizza / Collega per attivare l'integrazione in Mokapen (serve Premium).
3. Copia l'URL del webhook mostrato nella pagina impostazioni.
4. In Read.ai → Integrations crea un webhook per l'evento meeting_end e incolla quell'URL.
5. Opzionale: copia la signing key da Read.ai nel campo Webhook secret in Mokapen, poi salva.

Webhook

L'URL del webhook nella pagina Integrazioni → Read.ai è l'endpoint che Read.ai deve chiamare. Incollalo in Read.ai Integrations settings per l'evento meeting_end. Se Read.ai mostra una signing key, incollala in Webhook secret in Mokapen per verificare le richieste con X-Read-Signature.

Impostazioni di salvataggio

Sempre in Integrazioni → Read.ai, 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 Read.ai, 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 Read.ai 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 Read.ai 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 Read.ai 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. Read.ai termina l'elaborazione della registrazione e invia il webhook (o Grain consegna meeting_end).
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 Read.ai (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 Read.ai; 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 Read.ai e ricollega da Integrazioni → Read.ai.

Disconnessione

Usa Disconnetti nella pagina Integrazioni → Read.ai (disponibile per l'utente che ha collegato l'integrazione). Rimuovi o disattiva anche il webhook in Read.ai 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 Read.ai, 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 Read.ai; 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 Read.ai dalla scheda appuntamento.

Domande frequenti

Q: Mokapen registra la riunione?

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

Q: Serve sempre una API key?

A: No per Read.ai: attivi l'integrazione in Mokapen e configuri il webhook (e opzionalmente la signing key) in Read.ai.

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 → Read.ai. URL webhook, secret e opzioni di salvataggio sono in quella pagina dopo il collegamento.