Ghidul Mokapen

Grain

Integrarea Grain aduce automat în Mokapen transcrierile întâlnirilor și notele AI. Când un apel este procesat în Grain, 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 Grain ș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 Grain (Premium — iconița de medalie pe pagină dacă nu este disponibilă în planul dvs.).
• Un cont Grain 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 programările să poată fi asociate după id-ul evenimentului din calendar sau URL-ul întâlnirii.

Conectare

Grain se conectează cu o cheie API (token de acces personal). Când vă conectați, Mokapen înregistrează webhook-ul automat pe Grain pentru evenimentul recording_added — nu trebuie să lipiți un URL de webhook în Grain.

1. Meniu utilizator → Integrări → Grain.
2. Faceți clic pe Sync / Connect (necesită un plan Premium adecvat).
3. Creați un token API Grain din documentația pentru dezvoltatori Grain.
4. Lipiți tokenul în Mokapen și confirmați Connect.
5. Mokapen creează webhook-ul pe Grain; la deconectare elimină și acel hook.

Webhook

După o conexiune reușită, Mokapen înregistrează un webhook pe Grain pentru recording_added. Pagina Integrări → Grain afișează URL-ul webhook pentru referință; nu este nevoie de altă configurare în Grain. Când vă deconectați, Mokapen șterge hook-ul remote, astfel încât resturile să nu continue să se declanșeze.

Setări de salvare

Tot pe Integrări → Grain, 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 Grain, fără a importa textul complet.

Puteți activa sau dezactiva și includerea rezumatului și a transcrierii (rezumat AI Grain, 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 Grain 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ă Grain (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 Grain 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. Grain termină procesarea înregistrării și declanșează webhook-ul (sau Grain livrează recording_added).
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 Grain (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 Grain; 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 Grain și reconectați-vă din Integrări → Grain.

Deconectare

Folosiți Disconnect pe pagina Integrări → Grain (disponibil pentru utilizatorul care a conectat integrarea). Mokapen elimină și webhook-ul Grain pe care l-a creat.

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 Grain, 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 Grain; 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 Grain din cardul programării.

Întrebări frecvente

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

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

Î: Este întotdeauna necesară o cheie API?

R: Da pentru Grain: lipiți-o o dată pentru a vă conecta. Webhook-ul livrează apoi fiecare transcriere finalizată.

Î: 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 → Grain. URL-ul webhook, secretele și opțiunile de salvare sunt pe acea pagină după conectare.