Ghidul Mokapen

Fireflies

Integrarea Fireflies aduce automat în Mokapen transcrierile întâlnirilor și notele AI. Când un apel este procesat în Fireflies, Mokapen poate crea un document, o notă sau poate păstra doar URL-ul întâlnirii și — când este posibil — leagă rezultatul de programarea corespunzătoare deja din calendar.

Este concepută pentru echipele de vânzări și customer success care înregistrează deja apelurile în Fireflies și vor ca rezultatul (rezumat, acțiuni, dialog complet) să fie disponibil lângă programarea din CRM, fără export manual de fișiere.

Prezentare generală a integrărilor: Integrări.

Cerințe

• Un plan Mokapen care include integrarea Fireflies (Premium — pictograma medalie pe pagină dacă nu este disponibilă pe planul dvs.).
• Un cont Fireflies activ cu permisiunea de a crea chei API și/sau webhook-uri.
• Opțional, dar recomandat: Google Calendar sau Outlook Calendar sincronizat cu Mokapen, pentru potrivirea programărilor după ID-ul evenimentului din calendar sau URL-ul întâlnirii.

Conectare

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

1. Meniu utilizator → Integrări → Fireflies.
2. Faceți clic pe Sync / Conectare (necesită un plan Premium adecvat).
3. Creați sau copiați cheia API din Fireflies (documentație pentru dezvoltatori).
4. Lipiți cheia în Mokapen și confirmați Conectare.
5. Când legătura reușește, pagina afișează contul conectat și deblochează setările de webhook și salvare.

Webhook

După conectarea cheii API, pagina Integrări → Fireflies afișează un URL webhook de copiat. Lipiți-l în setările Fireflies Developer și abonați-vă la evenimentul care se declanșează când o transcriere este gata (de obicei meeting transcribed / summarized).

Opțional setați un secret webhook în Mokapen și folosiți aceeași valoare ca secretul opțional de semnare configurat în Fireflies Developer. Este recomandat în producție, astfel încât să fie acceptate doar cererile autentice Fireflies.

Apăsați Salvare pe pagina Mokapen după ce modificați secretul webhook sau opțiunile de salvare.

Setări de salvare

Tot pe Integrări → Fireflies, alegeți cum este stocată fiecare întâlnire procesată în Mokapen:

• Document — creează un document cu conținutul întâlnirii (ideal pentru partajarea transcrierilor lungi cu echipa).
• Notă — creează o notă legată de programarea potrivită sau disponibilă în fluxul de note.
• URL — stochează în principal linkul către înregistrarea din Fireflies, fără importul corpului de text complet.

Puteți activa sau dezactiva includerea rezumatului și a transcrierii (rezumat AI, acțiuni și transcriere completă). Dezactivarea ambelor în modul URL păstrează doar un pointer ușor către înregistrarea externă.

Potrivirea programărilor

Când sosește o transcriere, Mokapen încearcă să o atașeze unei programări existente:

1. Mai întâi caută un ID de sincronizare calendar deja stocat pentru acea întâlnire (integrările Google Calendar sau Outlook Calendar).
2. Dacă eșuează, compară URL-ul întâlnirii din Fireflies cu câmpul URL al programărilor.
3. Dacă nicio programare nu se potrivește, documentul sau nota este totuși creată — doar că nu este legată de un eveniment din calendar.

Sfat: păstrați pe cardul programării același link de întâlnire pe care îl înregistrează Fireflies (Zoom, Meet, Teams…) și mențineți sincronizarea calendarului activă pentru potrivirea cea mai fiabilă.

Partajare cu colegii

Ca și celelalte integrări Mokapen, puteți partaja conexiunea Fireflies cu colegi sau echipe selectate din controalele de partajare a sincronizării de pe pagina de setări. Utilizatorii cu care partajați pot beneficia de transcrierile din organizație fără ca fiecare să își conecteze propria cheie.

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

1. Fireflies termină procesarea înregistrării și declanșează webhook-ul (sau livrează meeting transcribed / summarized).
2. Mokapen primește payload-ul, verifică opțional semnătura/secretul și pune în coadă un job pe fundal.
3. Job-ul preia prin API detaliile rezumatului/transcrierii când este nevoie, aplică opțiunile de salvare și creează înregistrarea document/notă/URL.
4. Dacă se găsește o potrivire de programare, noul element este legat de acea programare pentru a apărea în context.
5. Livrările duplicate pentru aceeași înregistrare sunt ignorate prin deduplicarea sincronizării, astfel încât reîncercările nu creează documente duble.

Probleme frecvente

• Nu apare nimic după un apel — verificați că webhook-ul este lipit corect în Fireflies (excepție Grain, unde este automat), că integrarea este încă conectată și că planul Premium include această aplicație.
• Document creat, dar nu pe programare — URL-ul întâlnirii sau ID-ul evenimentului din calendar nu s-a potrivit. Deschideți programarea, confirmați URL-ul și asigurați-vă că sincronizarea calendarului este activă.
• Webhook respins / erori de semnătură — secretul din Mokapen trebuie să coincidă exact cu cel configurat în Fireflies; regenerați ambele părți dacă nu sunteți sigur.
• Se salvează doar linkul — verificați Salvare ca și casetele rezumat/transcriere; modul URL omite intenționat corpul complet.
• Cheie API invalidă — regenerați cheia în Fireflies și reconectați-vă din Integrări → Fireflies.

Deconectare

Folosiți Deconectare pe pagina Integrări → Fireflies (disponibil pentru utilizatorul care a conectat integrarea). Eliminați sau dezactivați webhook-ul și în Fireflies 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

• Follow-up după apel de vânzări — după un apel de discovery înregistrat în Fireflies, rezumatul ajunge ca document pe programare: AE-ul poate partaja acțiunile fără a rescrie notele.
• Arhivă CS QBR — review-urile trimestriale rămân căutabile în documentele Mokapen, legate de programarea clientului.
• Predare între roluri — SDR-ii înregistrează demo-uri în Fireflies; closer-ii deschid programarea potrivită și citesc transcrierea fără a schimba uneltele.
• Pointer ușor în CRM — folosiți modul de salvare URL când aveți nevoie doar de un deep link înapoi la Fireflies de pe cardul programării.

Întrebări frecvente

Q: Mokapen înregistrează el însuși întâlnirea?

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

Q: Este întotdeauna necesară o cheie API?

A: Da pentru Fireflies: lipiți-o o dată pentru conectare. Webhook-ul livrează apoi fiecare transcriere finalizată.

Q: Ce se întâmplă dacă nu există o programare potrivită?

A: Documentul sau nota este totuși creată. O puteți lega manual mai târziu sau corecta URL-ul întâlnirii / sincronizarea calendarului pentru apelurile viitoare.

Q: Pot colegii folosi conexiunea mea?

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

Q: Reconectarea va duplica întâlnirile vechi?

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

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

A: Meniu utilizator → Integrări → Fireflies. URL-ul webhook, secretele și opțiunile de salvare sunt pe acea pagină după conectare.