Ghidul Mokapen

Jamie

Integrarea Jamie aduce automat în Mokapen transcrierile întâlnirilor și notele AI de pe meetjamie.ai. Când o întâlnire este procesată în Jamie, Mokapen poate crea un document, o notă sau poate păstra doar un pointer ușor și — când este posibil — poate lega rezultatul de programarea potrivită deja din calendar.

Jamie este un AI note taker axat pe confidențialitate, care funcționează fără bot în întâlnire. Această integrare este pentru echipele de vânzări și customer success care înregistrează deja cu Jamie și doresc rezultatul (rezumat, acțiuni, dialog complet) lângă programarea din CRM.

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

Cerințe

• Un plan Mokapen care include integrarea Jamie (Premium — pictogramă medalie pe pagină dacă nu este disponibilă în planul dvs.).
• Un cont Jamie pe plan Pro / Team / Enterprise (sau eligibil) cu permisiunea de a crea chei API și webhook-uri.
• Opțional, dar recomandat: Google Calendar sau Outlook Calendar sincronizat cu Mokapen, pentru ca programările să poată fi potrivite după id-ul evenimentului din calendar.

Conectare

Jamie se conectează cu o cheie API (fără OAuth). Lipiți cheia o dată în Mokapen, apoi configurați webhook-ul care notifică Mokapen când o întâlnire este gata.

1. Meniu utilizator → Integrations → Jamie.
2. Faceți clic pe Sync / Connect (necesită un plan Premium adecvat).
3. Creați o cheie API în Jamie: Settings → Developers → API Keys (documentație pentru dezvoltatori). Folosiți o cheie personală (/v1/me) sau de workspace (/v1/workspace).
4. Lipiți cheia în Mokapen și confirmați Connect.
5. Când legătura reușește, pagina arată conexiunea și deblochează setările de webhook și salvare.

Webhook

După conectarea cheii API, pagina Integrations → Jamie afișează un URL de webhook de copiat. În Jamie mergeți la Settings → Integrations → Webhooks, creați un webhook, lipiți URL-ul Mokapen și abonați-vă la meeting.completed.

Alegeți autentificarea în Jamie:

• API key (recomandat) — Jamie trimite secretul în x-jamie-api-key (sau un header personalizat). Lipiți același secret în Mokapen la Webhook secret.
• Signature — Jamie semnează cu HMAC-SHA256 în x-jamie-signature. Lipiți secretul de semnare în Mokapen.

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

Setări de salvare

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

• Document — creează un document cu conținutul întâlnirii (ideal pentru transcrieri lungi).
• Note — creează o notă legată de programarea potrivită când este posibil.
• URL — stochează un pointer ușor fără a importa textul complet.

Puteți activa sau dezactiva și includerea rezumatului (și a acțiunilor) și a transcrierii.

Potrivirea programărilor

Când ajunge o transcriere, Mokapen încearcă să o atașeze unei programări existente folosind externalId-ul evenimentului din calendar din Jamie (id-urile de sincronizare Google Calendar sau Outlook Calendar deja stocate în Mokapen).

Dacă nicio programare nu se potrivește, documentul sau nota este totuși creat(ă) — pur și simplu nu este legat(ă) de un eveniment din calendar.

Partajare cu echipa

Ca și la celelalte integrări Mokapen, puteți partaja conexiunea Jamie cu colegi selectați sau cu întreaga organizație din controalele de partajare a sincronizării de pe pagina de setări.

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

1. Jamie termină procesarea și trimite meeting.completed (payload-ul include rezumat, transcriere și sarcini).
2. Mokapen primește payload-ul, verifică opțional cheia API sau semnătura HMAC și pune un job de fundal în coadă.
3. Job-ul folosește conținutul webhook-ului (și poate recurge la API-ul Jamie meetings.get când este necesar), aplică opțiunile dvs. de salvare și creează documentul/nota.
4. Dacă se găsește o potrivire de programare, noul element este legat de acea programare.
5. Livrările duplicate pentru aceeași întâlnire sunt ignorate prin deduplicarea sincronizării.

Probleme frecvente

• Nu apare nimic după un apel — verificați că URL-ul webhook este lipit corect în Jamie, că evenimentul este meeting.completed, că integrarea este încă conectată și că planul Premium include această aplicație. Asigurați-vă și că worker-ul de coadă rulează.
• Document creat, dar nu pe programare — externalId-ul calendarului nu s-a potrivit. Păstrați sincronizarea calendarului activă pentru cea mai fiabilă potrivire.
• Webhook respins / erori de semnătură — secretul din Mokapen trebuie să coincidă exact cu ce arată Jamie la crearea webhook-ului; regenerați pe ambele părți dacă sunteți nesiguri.
• Se salvează doar o înregistrare scurtă — verificați Save as și casetele rezumat/transcriere; modul URL omite intenționat corpul complet.
• Cheie API invalidă — regenerați cheia în Jamie (Settings → Developers → API Keys) și reconectați-vă. Accesul API necesită un plan Jamie eligibil.

Deconectare

Folosiți Disconnect pe pagina Integrations → Jamie (disponibil utilizatorului care a conectat integrarea). Eliminați sau dezactivați și webhook-ul din Jamie dacă nu mai doriți livrări.

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

Întrebări frecvente

Q: Mokapen se alătură întâlnirii ca bot?

A: Nu. Jamie înregistrează fără bot; Mokapen primește doar notele procesate prin webhook/API.

Q: Cheie API personală sau de workspace?

A: Ambele funcționează. Mokapen detectează domeniul la conectare. Folosiți o cheie de workspace dacă aveți nevoie de întâlnirile din întregul workspace Jamie.

Q: Unde este documentația oficială Jamie?

A: API și Webhooks.