Zoom

  # 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`.