Przewodnik po Mokapen

tl;dv

Integracja tl;dv automatycznie przenosi transkrypcje spotkań i notatki AI do Mokapen. Kiedy połączenie jest przetwarzane w tl;dv, 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 tl;dv 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ę z tl;dv (Premium — ikona medalu na stronie, jeśli nie jest dostępna w Twoim planie).
• Aktywne konto tl;dv 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, tl;dv łą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 → tl;dv.
2. Kliknij Sync / Connect (wymaga odpowiedniego planu Premium).
3. Utwórz lub skopiuj klucz API z tl;dv (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 → tl;dv wyświetla adres URL webhooka do skopiowania. Wklej go w ustawieniach webhooks tl;dv i zasubskrybuj zdarzenie uruchamiane, gdy transkrypcja będzie gotowa (zwykle TranscriptReady).

Opcjonalnie ustaw Webhook secret w Mokapen i użyj tej samej wartości, co opcjonalny niestandardowy sekret nagłówka (np. X-Webhook-Secret) skonfigurowany w tl;dv. Jest to zalecane w środowisku produkcyjnym, dlatego akceptowane są tylko oryginalne żądania tl;dv.

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

Zapisz ustawienia

Wciąż w integracji → tl;dv, 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 tl;dv, bez importowania pełnej treści tekstowej.

Możesz także wybrać opcję dołączania notatek i transkrypt (notatki tl;dv 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 tl;dv z polem URL w spotkaniach.
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óry rejestruje tl;dv (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 tl;dv 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. tl;dv kończy przetwarzanie nagrania i uruchamia webhook (lub Grain dostarcza TranscriptReady).
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 tl;dv (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, co jest skonfigurowane w tl;dv; 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 tl;dv i połącz się ponownie z Integracjami → tl;dv.

Rozłączanie

Użyj Disconnect na stronie Integracje → tl;dv (dostępnej dla użytkownika, który podłączył integrację). Usuń lub wyłącz webhook w tl;dv, 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 tl;dv podsumowanie ląduje jako dokument podczas spotkania: AE 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 tl;dv; osoby zamykające otwierają dopasowane spotkanie i czytają transkrypcję bez zmiany narzędzi.
• Lekki wskaźnik CRM — użyj trybu zapisu URL, gdy potrzebujesz tylko dokładnego łącza zwrotnego do tl;dv z karty spotkań.

Często zadawane pytania

P: Czy Mokapen nagrywa samo spotkanie?

A: Nie. Nagrywanie i transkrypcja odbywają się w formacie tl;dv. 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 tl;dv: wklej raz, aby się 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 → tl;dv. Adres URL webhooka, sekrety i opcje zapisywania znajdują się na tej stronie po połączeniu.