Ghidul Mokapen

Read.ai

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

Este concepută pentru echipele de vânzări și customer success care înregistrează deja apeluri în Read.ai și doresc rezultatul (rezumat, acțiuni, dialog complet) lângă programarea CRM, fără export manual de fișiere.

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

Cerințe

• Un plan Mokapen care include integrarea Read.ai (Premium — iconița de medalie pe pagină dacă nu este disponibilă în planul dvs.).
• Un cont Read.ai activ cu permisiunea de a adăuga webhook-uri în Integrations.
• Opțional, dar recomandat: Google Calendar sau Outlook Calendar sincronizat cu Mokapen, astfel încât programările să poată fi asociate după id-ul evenimentului din calendar sau URL-ul întâlnirii.

Conectare

Read.ai nu folosește o autentificare simplă cu cheie API în Mokapen. Mai întâi activați integrarea, apoi lipiți URL-ul webhook Mokapen în Read.ai, astfel încât rapoartele de întâlnire să fie livrate când sunt gata.

1. Meniu utilizator → Integrări → Read.ai.
2. Faceți clic pe Sync / Connect pentru a activa integrarea în Mokapen (necesită Premium).
3. Copiați URL-ul webhook afișat pe pagina de setări.
4. În Read.ai → Integrations, creați un webhook pentru evenimentul meeting_end și lipiți acel URL.
5. Opțional: copiați cheia de semnare din Read.ai în câmpul Webhook secret din Mokapen, apoi salvați.

Webhook

URL-ul webhook de pe pagina Integrări → Read.ai este endpoint-ul pe care Read.ai trebuie să îl apeleze. Lipiți-l în setările Integrations din Read.ai pentru evenimentul meeting_end. Dacă Read.ai afișează o cheie de semnare, lipiți-o în Webhook secret din Mokapen pentru ca solicitările să poată fi verificate prin X-Read-Signature.

Setări de salvare

Tot pe Integrări → Read.ai, 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 asociată sau disponibilă în fluxul de note.
• URL — stochează în principal linkul către înregistrarea din Read.ai, fără a importa textul complet.

Puteți activa sau dezactiva și 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ă.

Asocierea 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 Read.ai cu câmpul URL al programărilor.
3. Dacă nicio programare nu se potrivește, documentul sau nota este creat oricum — pur și simplu 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ă Read.ai (Zoom, Meet, Teams…) și mențineți sincronizarea calendarului activă pentru cea mai fiabilă asociere.

Partajare cu colegii

Ca la celelalte integrări Mokapen, puteți partaja conexiunea Read.ai cu colegi sau echipe selectate din controalele de partajare sync de pe pagina de setări. Utilizatorii cu acces beneficiază de transcrieri în organizație fără ca fiecare să își conecteze propria cheie.

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

1. Read.ai termină procesarea înregistrării și declanșează webhook-ul (sau Grain livrează meeting_end).
2. Mokapen primește payload-ul, verifică opțional semnătura/secretul și pune în coadă un job în fundal.
3. Jobul preia detaliile de rezumat/transcriere prin API când este necesar, aplică opțiunile de salvare și creează înregistrarea document/notă/URL.
4. Dacă se găsește o programare potrivită, 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 sync, 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 Read.ai (cu excepția 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-au 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ă corespundă exact cu cel configurat în Read.ai; regenerați ambele părți dacă nu sunteți sigur.
• Se salvează doar linkul — verificați Save as și casetele pentru rezumat/transcriere; modul URL omite intenționat corpul complet.
• Cheie API invalidă — regenerați cheia în Read.ai și reconectați-vă din Integrări → Read.ai.

Deconectare

Folosiți Disconnect pe pagina Integrări → Read.ai (disponibil pentru utilizatorul care a conectat integrarea). Eliminați sau dezactivați și webhook-ul din Read.ai 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 apeluri de vânzări — după un apel discovery înregistrat în Read.ai, rezumatul ajunge ca document pe programare: AE poate partaja acțiunile fără a rescrie notele.
• Arhivă QBR CS — recenziile trimestriale de business rămân căutabile în documentele Mokapen, legate de programarea clientului.
• Predare între roluri — SDR-ii înregistrează demo-uri în Read.ai; closerii deschid programarea asociată și citesc transcrierea fără a schimba instrumentul.
• Pointer CRM ușor — folosiți modul de salvare URL când aveți nevoie doar de un deep link înapoi la Read.ai din cardul programării.

Întrebări frecvente

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

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

Î: Este întotdeauna necesară o cheie API?

R: Nu există cheie API în Mokapen pentru Read.ai: activați integrarea și configurați webhook-ul în Read.ai.

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

R: Documentul sau nota este creat oricum. Îl puteți lega manual mai târziu sau puteți corecta URL-ul întâlnirii / sincronizarea calendarului pentru apelurile viitoare.

Î: Pot colegii să folosească conexiunea mea?

R: Da, dacă partajați integrarea cu ei din setările de partajare sync de pe pagina Integrări.

Î: Reconectarea va duplica întâlnirile vechi?

R: Mokapen deduplică după identitatea sync înregistrările deja importate. Întâlnirile noi continuă să creeze documente/note noi.

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

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