# Zoom Transcript Integration Z łatwością odbieraj i automatyzuj transkrypcje spotkań Zoom w Botpress dla spotkań hostowanych przez określonych użytkowników Zoom. ## Jak to działa 1. **Spotkanie Zoom kończy się** → Zoom wysyła webhook , gdy transkrypcja jest gotowa. 2. **Filtry integracyjne `host_id`** → Zezwala tylko na zdarzenia od określonych użytkowników Zoom. 3. **Transkrypcja jest pobierana i czyszczona** → Pobierana z Zoom i konwertowana na zwykły tekst. 4. **Emitowane zdarzenie** → Zdarzenie `transcriptReceived` z `meetingUUID` i `transcript` jest dostępne dla przepływów. --- ## Użycie - **Trigger workflows** → Dodaj kartę "Listen to Event" dla `transcriptReceived`. - **Dostęp do danych** → Użyj `event.payload.meetingUUID` i `event.payload.transcript` w przepływach. - Przechowywanie transkrypcji** → Zapisz w tabelach do późniejszej analizy lub raportowania. --- ## Wymagania wstępne Musisz być: - **właścicielem konta Zoom**, **adminem** lub posiadać rolę **"Zoom for Developers "**, aby móc utworzyć aplikację Zoom OAuth. - W planie **Zoom premium** (darmowa warstwa nie obsługuje nagrań w chmurze) --- ## Konfiguracja krok po kroku ### 1. Utwórz aplikację Zoom OAuth - Odwiedź stronę: [https://marketplace.zoom.us/](https://marketplace.zoom.us/) - Przejdź do **Develop > Build App** → Wybierz **Server-to-Server OAuth** → Nazwij swoją aplikację. - Na stronie **App Credentials** skopiuj: - **Account ID** - **identyfikator klienta** - **Tajemnica klienta** Użyjesz ich później w konfiguracji integracji Botpress . - W **Information** wypełnij niezbędne informacje o sobie i aplikacji. - W **Features** skopiuj **Secret Token**. - W **Scopes** dodaj: cloud_recording:read:list_user_recordings:admin cloud_recording:read:list_recording_files:admin cloud_recording:read:recording:admin - Aktywuj aplikację w zakładce **Aktywacja**. ### 2. Pobierz Zoom `host_id` Możesz znaleźć swój `host_id` Zoom bezpośrednio z portalu internetowego Zoom. #### Kroki: 1. Zaloguj się na swoje konto Zoom i przejdź do: **Panel administracyjny Zoom > Zarządzanie użytkownikami > Użytkownicy**. 2. Kliknij nazwę użytkownika, dla którego chcesz uzyskać `host_id`. 3. Sprawdź adres URL w pasku adresu przeglądarki. Będzie on miał następujący format: https://yourdomain.zoom.us/user/xxxxxxxxxxxxx/profile chcesz skopiować xxxxxxxxxxxxx, ponieważ jest to twój host_id. --- ### 3. Skonfiguruj integrację Botpress - Zainstaluj tę integrację w swoim bocie - Wklej: - `Zoom Client ID` - `Tajemnica klienta zoom` - `Zoom Account ID` - `Secret Token` - `Dozwolone identyfikatory użytkowników Zoom` → Wklej swój `host_id` (możesz podać wiele) Kliknij **Zapisz konfigurację**. --- ### 4. Ustaw Webhook w Zoom Wróć do aplikacji Zoom OAuth: - Przejdź do **Funkcje** → Włącz **Subskrypcje zdarzeń**. - Nazwa: `Transcript Received` (można również wybrać inną nazwę) - Metoda: Webhook - Adres URL punktu końcowego: użyj adresu URL **integracji Botpress . - Dodaj zdarzenia: - W **Recording**: - `Wszystkie nagrania zostały zakończone` - `Nagrywanie plików transkrypcji zostało zakończone` - Kliknij **Done** - Kliknij **Validate** obok adresu URL punktu końcowego (powinieneś zobaczyć Validated). - Kliknij **Zapisz** --- ## Gotowe! Twój bot Botpress będzie teraz otrzymywał transkrypcje dla dozwolonych użytkowników Zoom po zakończeniu nagrywania w chmurze. Upewnij się: - **nagrywasz do chmury** - Korzystasz z **opłaconego planu Zoom**. - Poprawnie dodałeś wszystkie zamierzone `host_id`.