Ghidul Mokapen

tl;dv

Integrarea tl;dv aduce automat transcrierile întâlnirilor și notele AI în Mokapen. Când un apel este procesat în tl;dv, Mokapen poate crea un document, o notă sau poate păstra doar întâlnirea URL și, atunci când este posibil, să lege rezultatul la potrivire programare deja în calendarul tău.

Acest lucru este conceput pentru echipele de vânzări și succesul clienților care înregistrează deja apelurile în tl;dv și doresc ca rezultatul (rezumat, elemente de acțiune, dialog complet) să fie disponibil lângă programarea CRM, fără a exporta fișierele manual.

Prezentare generală a integrărilor: Integrații.

Cerințe

• Un plan Mokapen care include integrarea tl;dv (Premium — pictograma medaliei pe pagină dacă nu este disponibilă în planul dumneavoastră).
• Un cont tl;dv activ cu permisiunea de a crea chei API și/sau webhook-uri.
• Opțional, dar recomandat: Google Calendar sau Outlook Calendar sincronizat cu Mokapen, astfel încât întâlnirile pot fi asociate cu id-ul evenimentului din calendar sau adresa URL a întâlnirii.

Conectare

Spre deosebire de aplicațiile de calendar OAuth, tl;dv se conectează cu o cheie API. Lipiți cheia o dată în Mokapen, apoi configurați webhook-ul care îl anunță pe Mokapen când o transcriere este gata.

1. Meniu utilizator → Integrații → tl;dv.
2. Faceți clic pe Sync / Connect (necesită un plan Premium adecvat).
3. Creați sau copiați cheia API din tl;dv (documentația dezvoltatorului).
4. Inserați cheia în Mokapen și confirmați Connect.
5. Când linkul reușește, pagina arată contul conectat și deblochează webhook-ul și salvează setările.

Webhook

După conectarea cheii API, pagina Integrations → tl;dv afișează un webhook URL de copiat. Lipiți-l în setările tl;dv Webhooks și abonați-vă la evenimentul care se declanșează atunci când o transcriere este gata (de obicei TranscriptReady).

Setați opțional un Webhook secret în Mokapen și utilizați aceeași valoare ca și secretul antet personalizat opțional (de exemplu, X-Webhook-Secret) configurat în tl;dv. Acest lucru este recomandat în producție, așa că sunt acceptate numai cererile tl;dv autentice.

Apăsați Salvare pe pagina Mokapen după modificarea secretului webhook sau opțiunile de salvare.

Salvați setările

Tot pe integrări → tl;dv, alegeți cum este stocată fiecare întâlnire procesată în Mokapen:

• Document — creează un document cu conținutul întâlnirii (cel mai bine pentru a partaja transcrieri lungi cu echipa).
• Notă — creează o notă legată de întâlnirea potrivită sau disponibilă în fluxul de note.
• URL — stochează în principal linkul înapoi la înregistrare în tl;dv, fără a importa textul integral.

De asemenea, puteți comuta dacă includeți notele și transcrierea (tl;dv note și transcrierea completă). Dezactivarea ambelor în modul URL păstrează doar un indicator ușor către înregistrarea externă.

Potrivire întâlniri

Când sosește o transcriere, Mokapen încearcă să o atașeze la o programare existentă:

1. Mai întâi caută un ID de sincronizare a calendarului deja stocat pentru acea întâlnire (integrare Google Calendar sau Outlook Calendar).
2. Dacă nu reușește, compară adresa URL a întâlnirii de la tl;dv cu câmpul URL de la întâlniri.
3. Dacă nu se potrivește nicio întâlnire, documentul sau nota este încă creată — pur și simplu nu este legată de un eveniment din calendar.

Sfat: păstrați același link de întâlnire pe cardul de întâlnire pe care îl înregistrează tl;dv (Zoom, Meet, Teams...) și păstrați sincronizarea calendarului activă pentru cel mai sigur meci.

Partajare cu colegii de echipă

Ca și alte integrări Mokapen, puteți partaja conexiunea tl;dv cu colegii de echipă sau echipele selectate din comenzile de partajare a sincronizarii de pe pagina de setări. Utilizatorii partajați pot beneficia de transcrierile care ajung în organizație fără ca fiecare persoană să-și conecteze propria cheie.

Ce se întâmplă după o întâlnire

1. tl;dv termină procesarea înregistrării și declanșează webhook-ul (sau Grain livrează TranscriptReady).
2. Mokapen primește sarcina utilă, verifică opțional semnătura/secretul și pune în coadă un job de fundal.
3. Serviciul preia detalii rezumate/transcriere prin API atunci când este necesar, aplică opțiunile de salvare și creează documentul/notă/înregistrarea URL.
4. Dacă se găsește o potrivire de întâlnire, noul articol este legat de acea întâlnire, astfel încât să apară în context.
5. Livrările duplicate pentru aceeași înregistrare sunt ignorate prin deduplicarea sincronizată, astfel încât reîncercările nu creează documente duble.

Probleme comune

• Nu apare nimic după un apel — verificați dacă webhook-ul este lipit corect în tl;dv (cu excepția Grain, unde este automat), dacă integrarea este încă conectată și că planul Premium include această aplicație.
• Document creat, dar nu la întâlnire — adresa URL a întâlnirii sau id-ul evenimentului din calendar nu se potriveau. Deschideți întâlnirea, confirmați adresa URL și asigurați-vă că sincronizarea calendarului este activă.
• Webhook respins / erori de semnătură — secretul din Mokapen trebuie să se potrivească exact cu ceea ce este configurat în tl;dv; regenerați ambele părți dacă nu sunteți sigur.
• Numai linkul este salvat — bifați Salvare ca și casetele de selectare rezumat/transcriere; Modul URL omite în mod intenționat întregul corp.
• Cheie API invalidă — regenerează cheia în tl;dv și reconectați-vă de la Integrations → tl;dv.

Deconectare

Utilizați Disconnect pe pagina Integrations → tl;dv (disponibil pentru utilizatorul care a conectat integrarea). Eliminați sau dezactivați webhook-ul și în tl;dv dacă nu mai doriți livrări.

Documentele și notele deja create rămân în Mokapen; deconectarea oprește doar sosirea noilor transcrieri.

Cazuri de utilizare

• Urmărirea apelului de vânzări — după un apel de descoperire înregistrat în tl;dv, rezumatul ajunge ca document privind programarea: AE poate partaja elemente de acțiune fără a rescrie note.
• CS Arhiva QBR — recenziile trimestriale de afaceri rămân căutate în documentele Mokapen, legate de programarea clientului.
• Handoff între roluri — SDR-urile înregistrează demonstrații în tl;dv; închizătorii deschid programarea potrivită și citesc transcrierea fără a schimba instrumentele.
• Pointer CRM ușor — utilizați modul de salvare URL atunci când aveți nevoie doar de o legătură profundă înapoi la tl;dv de pe cardul de întâlnire.

Întrebări frecvente

Î: Mokapen înregistrează întâlnirea în sine?

A: Nu. Înregistrarea și transcrierea au loc în tl;dv. Mokapen primește rezultatul numai prin webhook și îl stochează conform setărilor dvs.

Î: Este întotdeauna necesară o cheie API?

A: Da pentru tl;dv: lipiți-l o dată pentru a vă conecta. Webhook-ul livrează apoi fiecare transcriere completată.

Î: Ce se întâmplă dacă nu există o întâlnire potrivită?

A: Documentul sau nota este încă creată. Îl puteți conecta manual mai târziu sau puteți remedia adresa URL a întâlnirii/sincronizarea calendarului pentru apeluri viitoare.

Î: Pot colegii de echipă să-mi folosească conexiunea?

A: Da, dacă partajați integrarea cu ei din setările de partajare a sincronizării de pe pagina de integrări.

Î: Reconectarea se va duplica întâlniri vechi?

A: Mokapen deduplică prin identitatea de sincronizare pentru înregistrările deja importate. Noile întâlniri continuă să creeze noi documente/note.

Î: Unde găsesc setările mai târziu?

A: Meniu utilizator → Integrații → tl;dv. URL-ul webhook, secretele și opțiunile de salvare sunt pe pagina respectivă după conectare.