Ghidul Mokapen

Cerințe

• Un plan Mokapen care include integrarea Fathom (Premium — pictograma medaliei pe pagină dacă nu este disponibilă în planul dumneavoastră).
• Un cont Fathom 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, Fathom 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 → Fathom.
2. Faceți clic pe Sync / Connect (necesită un plan Premium adecvat).
3. Creați sau copiați cheia API din Fathom (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 → Fathom afișează un webhook URL de copiat. Lipiți-l în setările Fathom API Access și abonați-vă la evenimentul care se declanșează atunci când o transcriere este gata (de obicei întâlnirea transcrisă).

Setați opțional un Webhook secret în Mokapen și utilizați aceeași valoare ca și secretul opțional webhook de la Fathom API Access. Acest lucru este recomandat în producție, astfel încât sunt acceptate numai cererile Fathom autentice.

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

Salvați setările

Tot pe Integrations → Fathom, 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 Fathom, fără a importa textul integral.

De asemenea, puteți comuta dacă includeți rezumatul și transcrierea (rezumatul AI, elementele de acțiune ș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 Fathom 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ă Fathom (Zoom, Meet, Teams...) și mențineți activat sincronizarea calendarului pentru cel mai sigur meci.

Partajare cu colegii de echipă

Ca și alte integrări Mokapen, puteți partaja conexiunea Fathom 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. Fathom termină procesarea înregistrării și declanșează webhook-ul (sau Grain livrează întâlnirea transcrisă).
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 Fathom (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 Fathom; 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 nevalidă — regenerează cheia în Fathom și reconectați-vă de la Integrations → Fathom.

Deconectare

Utilizați Disconnect pe pagina Integrations → Fathom (disponibil pentru utilizatorul care a conectat integrarea). Eliminați sau dezactivați webhook-ul și în Fathom 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 Fathom, rezumatul ajunge ca un 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 Fathom; î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 Fathom de pe cardul de programare.

Întrebări frecvente

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

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

Î: Este întotdeauna necesară o cheie API?

A: Da pentru Fathom: 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 → Fathom. URL-ul webhook, secretele și opțiunile de salvare sunt pe pagina respectivă după conectare.