# Zoom Transcript Integratie Ontvang en automatiseer eenvoudig Zoom transcripties in Botpress voor vergaderingen van specifieke Zoom gebruikers. ## Hoe het werkt 1. **Zoom vergadering eindigt** → Zoom stuurt een webhook wanneer het transcript klaar is. 2. **Integratie filters `host_id`** → Laat alleen gebeurtenissen toe van gespecificeerde Zoom gebruiker(s). 3. **Transcript wordt opgehaald en opgeschoond** → Gedownload van Zoom en geconverteerd naar platte tekst. 4. **Event wordt uitgezonden** → Een `transcriptReceived` event met `meetingUUID` en `transcript` is beschikbaar voor je flows. --- ## Gebruik - **Trigger workflows** → Voeg een "Listen to Event" kaart toe voor `transcriptReceived`. - **Toegang tot gegevens** → Gebruik `event.payload.meetingUUID` en `event.payload.transcript` in flows. - Sla transcripts op** → Sla ze op in tabellen voor latere analyse of rapportage. --- ## Vereisten U moet: - Een Zoom **account eigenaar**, **admin**, of de **"Zoom voor Ontwikkelaars" rol** hebben om de Zoom OAuth App te kunnen maken. - Op een **Zoom premium plan** zitten (gratis tier ondersteunt geen cloud opnames) --- ## Stap voor stap instellen ### 1. Maak een Zoom OAuth App - Bezoek: [https://marketplace.zoom.us/](https://marketplace.zoom.us/) - Ga naar **Ontwikkelen > App maken** → Kies **Server-naar-server OAuth** → Geef uw app een naam - Kopieer op de pagina **App Credentials**: - **Account ID** - **Client ID** - **Client geheim** Je zult deze later gebruiken in je Botpress integratieconfiguratie. - In **Information** vul je de nodige informatie in over jezelf en de app. - Kopieer in **Features** het **Secret Token**. - Voeg in **Scopes** toe: cloud_recording:read:list_user_recordings:admin cloud_opname:lezen:lijst_opname_bestanden:admin cloud_opname:lezen:opname:admin - Activeer de app onder de **Activatie** tab ### 2. Zoom `host_id` ophalen Je kunt je Zoom `host_id` direct vinden op het Zoom webportaal. #### Stappen: 1. Log in op je Zoom account en navigeer naar: **Zoom Admin Paneel > Gebruikersbeheer > Gebruikers** 2. Klik op de naam van de gebruiker waarvoor je de `host_id` wilt opvragen. 3. Kijk naar de URL in de adresbalk van je browser. Het zal in dit formaat zijn: https://yourdomain.zoom.us/user/xxxxxxxxxxxxx/profile u wilt de xxxxxxxxxxxxxxxxxxxxxxxxxxx kopiëren want dat is uw host_id --- ### 3. De Botpress configureren - Installeer deze integratie in je Bot - Plakken: - `Zoom Klant ID` - `Zoom Klant Geheim` - `Zoom Account ID` - `geheim token` - `Allowed Zoom User IDs` (Toegestane Zoom gebruikers-ID's) → Plak je `host_id` (je kunt er meerdere toevoegen) Klik op **Configuratie opslaan**. --- ### 4. Webhook instellen in Zoom Terug in je Zoom OAuth App: - Ga naar **Features** → Schakel **Event Subscriptions** in - Naam: `Transcript ontvangen` (Kan ook een andere naam kiezen) - Methode: Webhook - URL eindpunt: gebruik de Botpress integratie URL** - Gebeurtenissen toevoegen: - Onder **Opname**: - `Alle opnamen zijn voltooid` - `Opname transcript bestanden is voltooid` - Klik op **Afgerond** - Klik **Validate** naast de URL van het eindpunt (er zou Validated moeten staan) - Klik op **Opslaan** --- ## Klaar! Je Botpress bot zal nu transcripties ontvangen voor toegestane Zoom gebruikers wanneer cloud opnames voltooid zijn. Zorg ervoor dat: - Je **opneemt in de cloud** - Je een **betaald Zoom-abonnement** hebt - Je hebt alle beoogde `host_id`s correct toegevoegd
