La Guida di Mokapen

tl;dv

L'integrazione tl;dv porta automaticamente in Mokapen i trascritti e le note AI delle riunioni. Quando una chiamata viene elaborata in tl;dv, 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 tl;dv 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 tl;dv (Premium — icona medaglia sulla pagina se non disponibile sul tuo piano).
• Un account tl;dv 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, tl;dv 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 → tl;dv.
2. Clicca Sincronizza / Collega (serve un piano Premium adeguato).
3. Crea o copia l'API key da tl;dv (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 → tl;dv mostra un URL webhook da copiare. Incollalo in tl;dv Webhooks settings e iscriviti all'evento che scatta quando il trascritto è pronto (in genere TranscriptReady).

Opzionale: imposta un Webhook secret in Mokapen e usa lo stesso valore come optional custom header secret (e.g. X-Webhook-Secret) configured in tl;dv. In produzione è consigliato, così vengono accettate solo richieste autentiche da tl;dv.

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

Impostazioni di salvataggio

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

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

Disconnessione

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

Domande frequenti

Q: Mokapen registra la riunione?

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

Q: Serve sempre una API key?

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