Przewodnik po Mokapen

Jamie

Integracja Jamie automatycznie wczytuje do Mokapen transkrypcje spotkań i notatki AI z meetjamie.ai. Gdy spotkanie zostanie przetworzone w Jamie, Mokapen może utworzyć dokument, notatkę albo zachować tylko lekki wskaźnik i — gdy to możliwe — powiązać wynik z pasującym spotkaniem już obecnym w kalendarzu.

Jamie to chroniący prywatność AI note taker, który działa bez bota na spotkaniu. Integracja jest przeznaczona dla zespołów sprzedaży i customer success, które już nagrywają z Jamie i chcą mieć wynik (podsumowanie, zadania, pełny dialog) obok spotkania w CRM.

Ogólny przegląd integracji: Integracje.

Wymagania

• Plan Mokapen obejmujący integrację Jamie (Premium — ikona medalu na stronie, jeśli nie jest dostępna w Twoim planie).
• Konto Jamie w planie Pro / Team / Enterprise (lub uprawnionym) z uprawnieniem do tworzenia kluczy API i webhooków.
• Opcjonalnie, ale zalecane: Google Calendar lub Outlook Calendar zsynchronizowany z Mokapen, aby można było dopasować spotkania po identyfikatorze wydarzenia w kalendarzu.

Połączenie

Jamie łączy się za pomocą klucza API (bez OAuth). Wklejasz klucz raz w Mokapen, a następnie konfigurujesz webhook, który powiadamia Mokapen, gdy spotkanie jest gotowe.

1. Menu użytkownika → Integracje → Jamie.
2. Kliknij Sync / Connect (wymaga odpowiedniego planu Premium).
3. Utwórz klucz API w Jamie: Settings → Developers → API Keys (dokumentacja deweloperska). Użyj klucza osobistego (/v1/me) lub workspace (/v1/workspace).
4. Wklej klucz w Mokapen i potwierdź Connect.
5. Po udanym połączeniu strona pokazuje status połączenia i odblokowuje ustawienia webhooka oraz zapisu.

Webhook

Po połączeniu klucza API strona Integracje → Jamie wyświetla adres URL webhooka do skopiowania. W Jamie przejdź do Settings → Integrations → Webhooks, utwórz webhook, wklej URL Mokapen i zasubskrybuj meeting.completed.

Wybierz uwierzytelnianie w Jamie:

• API key (zalecane) — Jamie wysyła sekret w x-jamie-api-key (lub w niestandardowym nagłówku). Wklej ten sam sekret w Mokapen w polu Webhook secret.
• Signature — Jamie podpisuje HMAC-SHA256 w x-jamie-signature. Wklej sekret podpisu w Mokapen.

Naciśnij Save na stronie Mokapen po zmianie sekretu webhooka lub opcji zapisu.

Ustawienia zapisu

Nadal w Integracje → Jamie wybierz, jak każde przetworzone spotkanie ma być przechowywane w Mokapen:

• Document — tworzy dokument z treścią spotkania (najlepsze przy długich transkrypcjach).
• Note — tworzy notatkę powiązaną z dopasowanym spotkaniem, gdy to możliwe.
• URL — zapisuje lekki wskaźnik bez importu pełnej treści.

Możesz też włączyć lub wyłączyć uwzględnianie podsumowania (i action items) oraz transkrypcji.

Dopasowywanie spotkań

Gdy nadejdzie transkrypcja, Mokapen próbuje powiązać ją z istniejącym spotkaniem, używając externalId wydarzenia kalendarzowego z Jamie (identyfikatory synchronizacji Google Calendar lub Outlook Calendar już zapisane w Mokapen).

Jeśli żadne spotkanie nie pasuje, dokument lub notatka i tak jest tworzona — po prostu nie jest powiązana z wydarzeniem w kalendarzu.

Udostępnianie współpracownikom

Jak w innych integracjach Mokapen, możesz udostępnić połączenie Jamie wybranym współpracownikom lub całej organizacji z poziomu kontrolek udostępniania synchronizacji na stronie ustawień.

Co się dzieje po spotkaniu

1. Jamie kończy przetwarzanie i wysyła meeting.completed (payload zawiera podsumowanie, transkrypcję i zadania).
2. Mokapen odbiera payload, opcjonalnie weryfikuje klucz API lub podpis HMAC i kolejkuje zadanie w tle.
3. Zadanie korzysta z treści webhooka (i w razie potrzeby może użyć API Jamie meetings.get), stosuje Twoje opcje zapisu i tworzy dokument/notatkę.
4. Jeśli znaleziono dopasowane spotkanie, nowy element jest z nim powiązany.
5. Duplikaty dla tego samego spotkania są ignorowane dzięki deduplikacji synchronizacji.

Typowe problemy

• Nic nie pojawia się po rozmowie — sprawdź, czy URL webhooka jest poprawnie wklejony w Jamie, czy zdarzenie to meeting.completed, czy integracja jest nadal połączona i czy plan Premium obejmuje tę aplikację. Upewnij się też, że działa worker kolejki.
• Dokument utworzony, ale nie na spotkaniu — externalId kalendarza nie pasował. Utrzymuj aktywną synchronizację kalendarza dla najbardziej niezawodnego dopasowania.
• Odrzucenie webhooka / błędy podpisu — sekret w Mokapen musi dokładnie odpowiadać temu, co pokazuje Jamie przy tworzeniu webhooka; w razie wątpliwości wygeneruj ponownie po obu stronach.
• Zapisany tylko krótki rekord — sprawdź Save as oraz pola wyboru podsumowania/transkrypcji; tryb URL celowo pomija pełną treść.
• Nieprawidłowy klucz API — wygeneruj ponownie klucz w Jamie (Settings → Developers → API Keys) i połącz ponownie. Dostęp API wymaga uprawnionego planu Jamie.

Rozłączanie

Użyj Disconnect na stronie Integracje → Jamie (dostępne dla użytkownika, który połączył integrację). Usuń lub wyłącz także webhook w Jamie, jeśli nie chcesz już otrzymywać dostaw.

Dokumenty i notatki już utworzone pozostają w Mokapen; rozłączenie tylko zatrzymuje napływ nowych transkrypcji.

Często zadawane pytania

Q: Czy Mokapen dołącza do spotkania jako bot?

A: Nie. Jamie nagrywa bez bota; Mokapen tylko odbiera przetworzone notatki przez webhook/API.

Q: Klucz API osobisty czy workspace?

A: Oba działają. Mokapen wykrywa zakres podczas połączenia. Użyj klucza workspace, jeśli potrzebujesz spotkań z całego workspace Jamie.

Q: Gdzie jest oficjalna dokumentacja Jamie?

A: API i Webhooks.