La Guida di Mokapen

Grain

L'integrazione Grain porta automaticamente in Mokapen i trascritti e le note AI delle riunioni. Quando una chiamata viene elaborata in Grain, 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 Grain 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 Grain (Premium — icona medaglia sulla pagina se non disponibile sul tuo piano).
• Un account Grain 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

Grain si collega con una API key (token di accesso). Quando colleghi, Mokapen registra automaticamente il webhook su Grain per l'evento recording_added — non devi incollare l'URL del webhook in Grain.

1. Menu utente → Integrazioni → Grain.
2. Clicca Sincronizza / Collega (serve Premium).
3. Crea un token API Grain dalla documentazione developer Grain.
4. Incolla il token in Mokapen e conferma Collega.
5. Mokapen crea il webhook su Grain; alla disconnessione lo rimuove anche da remoto.

Webhook

Dopo il collegamento, Mokapen registra su Grain un webhook per recording_added. La pagina Integrazioni → Grain mostra l'URL per riferimento; non serve altra configurazione in Grain. Alla disconnessione Mokapen elimina l'hook remoto così non continua a sparare richieste.

Impostazioni di salvataggio

Sempre in Integrazioni → Grain, 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 Grain, senza importare tutto il testo.

Puoi anche scegliere se includere il riepilogo e il trascritto (Grain 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 Grain 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 Grain 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 Grain 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. Grain termina l'elaborazione della registrazione e invia il webhook (o Grain consegna recording_added).
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 Grain (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 Grain; 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 Grain e ricollega da Integrazioni → Grain.

Disconnessione

Usa Disconnetti nella pagina Integrazioni → Grain (disponibile per l'utente che ha collegato l'integrazione). Mokapen rimuove anche il webhook Grain che aveva creato.

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 Grain, 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 Grain; 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 Grain dalla scheda appuntamento.

Domande frequenti

Q: Mokapen registra la riunione?

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

Q: Serve sempre una API key?

A: Sì per Grain: 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 → Grain. URL webhook, secret e opzioni di salvataggio sono in quella pagina dopo il collegamento.