Sprievodca Mokapenom

Jamie

Integrácia Jamie automaticky prenáša do Mokapenu prepisy stretnutí a AI poznámky z meetjamie.ai. Keď je stretnutie spracované v Jamie, Mokapen môže vytvoriť dokument, poznámku alebo uchovať len ľahký ukazovateľ a — ak je to možné — prepojiť výsledok s odpovedajúcim stretnutím už v kalendári.

Jamie je AI note taker zameraný na súkromie, ktorý funguje bez bota na stretnutí. Táto integrácia je určená pre obchodné a customer success tímy, ktoré už nahrávajú s Jamie a chcú mať výsledok (súhrn, úlohy, celý dialóg) vedľa CRM stretnutia.

Všeobecný prehľad integrácií: Integrácie.

Požiadavky

• Plán Mokapen, ktorý zahŕňa integráciu Jamie (Premium — ikona medaily na stránke, ak nie je vo vašom pláne k dispozícii).
• Účet Jamie v pláne Pro / Team / Enterprise (alebo oprávnenom) s oprávnením vytvárať API kľúče a webhooky.
• Voliteľné, ale odporúčané: Google Calendar alebo Outlook Calendar synchronizovaný s Mokapenom, aby bolo možné párovať stretnutia podľa id udalosti v kalendári.

Pripojenie

Jamie sa pripája pomocou API kľúča (bez OAuth). Kľúč raz vložíte do Mokapenu a potom nastavíte webhook, ktorý Mokapen upozorní, keď je stretnutie pripravené.

1. Používateľské menu → Integrations → Jamie.
2. Kliknite na Sync / Connect (vyžaduje zodpovedajúci plán Premium).
3. Vytvorte API kľúč v Jamie: Settings → Developers → API Keys (vývojárska dokumentácia). Použite osobný (/v1/me) alebo workspace (/v1/workspace) kľúč.
4. Vložte kľúč do Mokapenu a potvrďte Connect.
5. Po úspešnom prepojení stránka zobrazí pripojenie a odomkne nastavenia webhooku a ukladania.

Webhook

Po pripojení API kľúča stránka Integrations → Jamie zobrazí URL webhooku na skopírovanie. V Jamie prejdite na Settings → Integrations → Webhooks, vytvorte webhook, vložte URL Mokapenu a prihláste sa na odber meeting.completed.

Zvoľte autentifikáciu v Jamie:

• API key (odporúčané) — Jamie odosiela tajomstvo v x-jamie-api-key (alebo vo vlastnej hlavičke). Vložte rovnaké tajomstvo do Mokapenu do poľa Webhook secret.
• Signature — Jamie podpisuje HMAC-SHA256 v x-jamie-signature. Vložte podpisové tajomstvo do Mokapenu.

Stlačte Save na stránke Mokapenu po zmene tajomstva webhooku alebo možností ukladania.

Nastavenia ukladania

Stále na stránke Integrations → Jamie zvoľte, ako sa má každé spracované stretnutie uložiť v Mokapene:

• Document — vytvorí dokument s obsahom stretnutia (najlepšie pre dlhé prepisy).
• Note — vytvorí poznámku prepojenú s nájdeným stretnutím, ak je to možné.
• URL — uloží ľahký ukazovateľ bez importu celého textu.

Môžete tiež zapnúť alebo vypnúť zahrnutie súhrnu (a úloh) a prepisu.

Párovanie stretnutí

Keď dorazí prepis, Mokapen sa ho pokúsi pripojiť k existujúcemu stretnutiu pomocou externalId kalendárovej udalosti z Jamie (synchronizačné id Google Calendar alebo Outlook Calendar už uložené v Mokapene).

Ak žiadne stretnutie nezodpovedá, dokument alebo poznámka sa napriek tomu vytvorí — len nie je prepojená s udalosťou kalendára.

Zdieľanie s tímom

Rovnako ako pri ostatných integráciách Mokapen môžete pripojenie Jamie zdieľať s vybranými kolegami alebo celou organizáciou pomocou ovládacích prvkov zdieľania synchronizácie na stránke nastavení.

Čo sa stane po stretnutí

1. Jamie dokončí spracovanie a odošle meeting.completed (payload obsahuje súhrn, prepis a úlohy).
2. Mokapen prijme payload, voliteľne overí API kľúč alebo HMAC podpis a zaradí úlohu na pozadí do fronty.
3. Úloha použije obsah webhooku (a v prípade potreby môže siahnuť po Jamie API meetings.get), uplatní vaše možnosti ukladania a vytvorí dokument/poznámku.
4. Ak sa nájde zhoda so stretnutím, nová položka sa k tomuto stretnutiu prepojí.
5. Duplicitné doručenia rovnakého stretnutia sa vďaka deduplikácii synchronizácie ignorujú.

Časté problémy

• Po hovore sa nič neobjaví — skontrolujte, či je URL webhooku správne vložená v Jamie, či je udalosť meeting.completed, či je integrácia stále pripojená a či plán Premium túto aplikáciu zahŕňa. Tiež sa uistite, že beží worker fronty.
• Dokument vytvorený, ale nie pri stretnutí — externalId kalendára sa nezhodoval. Pre najspoľahlivejšie párovanie udržujte aktívnu synchronizáciu kalendára.
• Odmietnutý webhook / chyby podpisu — tajomstvo v Mokapene musí presne zodpovedať tomu, čo Jamie zobrazí pri vytváraní webhooku; pri neistote obe strany znova vygenerujte.
• Uložený je len krátky záznam — skontrolujte Save as a začiarkavacie polia súhrnu/prepisu; režim URL zámerne vynecháva celý text.
• Neplatný API kľúč — znova vygenerujte kľúč v Jamie (Settings → Developers → API Keys) a znova sa pripojte. Prístup k API vyžaduje oprávnený plán Jamie.

Odpojenie

Použite Disconnect na stránke Integrations → Jamie (dostupné používateľovi, ktorý integráciu pripojil). Odstráňte alebo vypnite webhook aj v Jamie, ak už nechcete doručovanie.

Už vytvorené dokumenty a poznámky v Mokapene zostanú; odpojenie iba zastaví príchod nových prepisov.

Často kladené otázky

Q: Pripája sa Mokapen na stretnutie ako bot?

A: Nie. Jamie nahráva bez bota; Mokapen iba prijíma spracované poznámky cez webhook/API.

Q: Osobný alebo workspace API kľúč?

A: Fungujú oba. Mokapen rozpozná rozsah pri pripojení. Použite workspace kľúč, ak potrebujete stretnutia z celého workspace Jamie.

Q: Kde je oficiálna dokumentácia Jamie?

A: API a Webhooks.