Przewodnik po Mokapen

Fathom

Integracja z Fathom automatycznie przenosi transkrypcje spotkań i notatki AI do Mokapen. Kiedy połączenie jest przetwarzane w Fathom, Mokapen może utworzyć dokument, notatkę lub zachować tylko spotkanie URL i – jeśli to możliwe – powiązać wynik z pasującym spotkanie już w Twoim kalendarzu.

Jest przeznaczony dla zespołów sprzedaży i obsługi klienta, które już nagrywają rozmowy w Fathom i chcą, aby wynik (podsumowanie, elementy działań, pełny dialog) był dostępny obok spotkania w CRM, bez konieczności ręcznego eksportowania plików.

Ogólny przegląd integracji: Integracje.

Wymagania

• Plan Mokapen obejmujący integrację Fathom (Premium — ikona medalu na stronie, jeśli nie jest dostępna w Twoim planie).
• Aktywne konto Fathom z uprawnieniami do tworzenia kluczy API i/lub webhooków.
• Opcjonalne, ale zalecane: Kalendarz Google lub Kalendarz Outlook zsynchronizowany z Mokapen, dzięki czemu spotkania można dopasowywać według identyfikatora wydarzenia w kalendarzu lub adresu URL spotkania.

Łączenie

W przeciwieństwie do aplikacji kalendarza OAuth, Fathom łączy się za pomocą klucza API. Wklejasz klucz raz w Mokapen, a następnie konfigurujesz webhook, który powiadamia Mokapen, gdy transkrypcja będzie gotowa.

1. Menu użytkownika → Integracje → Fathom.
2. Kliknij Sync / Connect (wymaga odpowiedniego planu Premium).
3. Utwórz lub skopiuj klucz API z Fathom (dokumentacja programisty).
4. Wklej klucz w Mokapen i potwierdź Connect.
5. Gdy połączenie się powiedzie, strona wyświetli połączone konto, odblokuje webhook i zapisze ustawienia.

Webhook

Po podłączeniu klucza API, strona Integracje → Fathom wyświetla adres URL webhooka do skopiowania. Wklej go w ustawieniach Fathom API Access i zasubskrybuj zdarzenie uruchamiane, gdy transkrypcja będzie gotowa (zazwyczaj spotkanie zostało zapisane).

Opcjonalnie ustaw sekret webhooka w Mokapen i użyj tej samej wartości, co opcjonalny sekret webhooka z Fathom API Access. Jest to zalecane w środowisku produkcyjnym, dlatego akceptowane są tylko oryginalne żądania Fathom.

Naciśnij Zapisz na stronie Mokapen po zmianie sekretu webhooka lub opcji zapisywania.

Zapisz ustawienia

Wciąż w integracji → Fathom, wybierz sposób przechowywania każdego przetworzonego spotkania w Mokapen:

• Dokument — tworzy dokument zawierający treść spotkania (najlepiej do udostępniania zespołowi długich transkrypcji).
• Notatka — tworzy notatkę powiązaną z dopasowanym spotkaniem lub dostępną w strumieniu notatek.
• URL — przechowuje głównie link do nagrania w Fathom, bez importowania pełnej treści tekstowej.

Możesz także wybrać, czy dołączać podsumowanie i transkrypt (podsumowanie AI, elementy działań i pełny zapis). Wyłączenie obu trybów w trybie URL powoduje pozostawienie jedynie lekkiego wskaźnika do nagrania zewnętrznego.

Dopasowane spotkania

Kiedy nadejdzie transkrypcja, Mokapen próbuje dołączyć ją do istniejącego spotkania:

1. Najpierw szuka identyfikatora synchronizacji kalendarza już zapisanego dla tego spotkania (integracja z Kalendarzem Google lub Kalendarzem Outlook).
2. Jeśli to się nie powiedzie, porównuje adres URL spotkania z Fathom z polem URL w terminach.
3. Jeśli żadne spotkanie nie pasuje, dokument lub notatka jest nadal tworzona — po prostu nie jest powiązana z wydarzeniem w kalendarzu.

Wskazówka: zachowaj ten sam link do spotkania na karcie spotkania, którą rejestruje Fathom (Zoom, Meet, Teams…) i włącz synchronizację kalendarza, aby zapewnić najbardziej niezawodne dopasowanie.

Udostępnianie członkom drużyny

Podobnie jak inne integracje Mokapen, możesz udostępniać połączenie Fathom wybranym członkom drużyny lub zespołom za pomocą opcji udostępniania synchronizacji na stronie ustawień. Użytkownicy współdzieleni mogą korzystać z transkrypcji trafiających do organizacji bez konieczności podłączania przez każdą osobę własnego klucza.

Co dzieje się po spotkaniu

1. Fathom kończy przetwarzanie nagrania i uruchamia webhook (lub Grain dostarcza transkrypcję spotkania).
2. Mokapen odbiera ładunek, opcjonalnie weryfikuje podpis/tajemnicę i umieszcza w kolejce zadanie w tle.
3. Zadanie pobiera w razie potrzeby szczegóły podsumowania/transkrypcji za pośrednictwem interfejsu API, stosuje opcje zapisywania i tworzy rekord dokumentu/notatki/adresu URL.
4. Jeśli zostanie znalezione dopasowanie spotkania, nowy element zostanie powiązany z tym spotkaniem, tak aby pojawił się w kontekście.
5. Zduplikowane dostawy tego samego nagrania są ignorowane przez deduplikację synchronizacji, więc ponowne próby nie powodują tworzenia podwójnych dokumentów.

Częste problemy

• Po wywołaniu nic się nie pojawia — sprawdź, czy webhook jest poprawnie wklejony w Fathom (z wyjątkiem Grain, gdzie odbywa się to automatycznie), czy integracja jest nadal połączona i czy plan Premium obejmuje tę aplikację.
• Dokument został utworzony, ale nie na spotkaniu — adres URL spotkania lub identyfikator wydarzenia w kalendarzu nie są zgodne. Otwórz spotkanie, potwierdź adres URL i upewnij się, że synchronizacja kalendarza jest aktywna.
• Webhook odrzucony / błędy w podpisie — sekret w Mokapen musi dokładnie odpowiadać temu, który jest skonfigurowany w Fathom; jeśli nie jesteś pewien, zregeneruj obie strony.
• Zapisywany jest tylko link — zaznacz Zapisz jako i pola wyboru podsumowania/transkrypcji; Tryb adresu URL celowo pomija całą treść.
• Nieprawidłowy klucz API — wygeneruj ponownie klucz w Fathom i połącz się ponownie z Integracji → Fathom.

Rozłączanie

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

Utworzone już dokumenty i notatki pozostają w Mokapen; odłączenie zatrzymuje jedynie napływ nowych transkrypcji.

Przypadki użycia

• Kontynuacja rozmowy telefonicznej sprzedażowej — po rozmowie telefonicznej informacyjnej zarejestrowanej w Fathom podsumowanie ląduje jako dokument spotkania: specjalista ds. realizacji może udostępniać elementy działań bez przepisywania notatek.
• Archiwum CS QBR — kwartalne recenzje biznesowe można przeszukiwać w dokumentach Mokapen, powiązane ze spotkaniem z klientem.
• Przekazywanie między rolami — SDR nagrywają dema w Fathom; osoby zamykające otwierają dopasowane spotkanie i czytają transkrypcję bez zmiany narzędzi.
• Lekki wskaźnik CRM — użyj trybu zapisu URL, gdy potrzebujesz jedynie dokładnego łącza zwrotnego do Fathom z karty spotkań.

Często zadawane pytania

P: Czy Mokapen nagrywa samo spotkanie?

A: Nie. Nagrywanie i transkrypcja odbywają się w Fathom. Mokapen otrzymuje wynik wyłącznie za pośrednictwem webhooka i zapisuje go zgodnie z Twoimi ustawieniami.

P: Czy zawsze wymagany jest klucz API?

A: Tak dla Fathom: wklej go raz, aby połączyć. Następnie webhook dostarcza każdy ukończony transkrypt.

P: Co się stanie, jeśli nie będzie pasującego spotkania?

A: Dokument lub notatka jest nadal tworzona. Możesz później połączyć je ręcznie lub ustawić synchronizację adresu URL spotkania/kalendarza na potrzeby przyszłych rozmów.

P: Czy członkowie drużyny mogą korzystać z mojego połączenia?

A: Tak, jeśli udostępnisz im integrację w ustawieniach udostępniania synchronizacji na stronie Integracje.

P: Czy ponowne łączenie będzie duplikować stare spotkania?

A: Mokapen deduplikuje poprzez synchronizację tożsamości dla już zaimportowanych nagrań. Nowe spotkania nadal tworzą nowe dokumenty/notatki.

P: Gdzie znajdę później ustawienia?

A: Menu użytkownika → Integrations → Fathom. Adres URL webhooka, sekrety i opcje zapisywania znajdują się na tej stronie po połączeniu.