Zoom

  # Intégration de la transcription dans Zoom

Recevez facilement et automatisez les transcriptions des réunions Zoom dans Botpress pour les réunions organisées par des utilisateurs Zoom spécifiques.

## Comment ça marche

1. **La réunion Zoom se termine** → Zoom envoie un webhook lorsque la transcription est prête.
2. **Filtres d'intégration `host_id`** → N'autorise que les événements de l'utilisateur Zoom spécifié.
3. **La transcription est récupérée et nettoyée** → Elle est téléchargée depuis Zoom et convertie en texte brut.
4. **Événement émis** → Un événement `transcriptReceived` avec `meetingUUID` et `transcript` est disponible pour vos flux.

---

## Usage

- **Trigger workflows** → Ajouter une carte "Listen to Event" pour `transcriptReceived`.
- **Accéder aux données** → Utiliser `event.payload.meetingUUID` et `event.payload.transcript` dans les flux.
- **Store transcripts** → Save to tables for later analysis or reporting.

---

## Conditions préalables

Vous devez être :
- Un **propriétaire de compte Zoom**, **administrateur**, ou avoir le rôle **"Zoom pour les développeurs "** pour pouvoir créer l'application Zoom OAuth.
- Disposer d'un **plan Zoom premium** (le plan gratuit ne prend pas en charge les enregistrements dans le nuage)

---

## Installation pas à pas

### 1. Créer une application Zoom OAuth

- Visitez le site : [https://marketplace.zoom.us/](https://marketplace.zoom.us/)
- Allez dans **Develop > Build App** → Choisissez **Server-to-Server OAuth** → Nommez votre application
- Sur la page **App Credentials**, copiez :
  - **Identifiant du compte**
  - **Identifiant du client**
  - **Secret du client**

Vous utiliserez ces informations dans la configuration de l'intégration de Botpress plus tard.

- Dans **Information**, remplissez les informations nécessaires sur vous et l'application.
- Dans **Features**, copiez le **Token secret**
- Dans **Scopes**, ajoutez :
cloud_recording:read:list_user_recordings:admin
cloud_recording:read:list_recording_files:admin
cloud_recording:read:recording:admin

- Activez l'application sous l'onglet **Activation**.

### 2. Obtenir Zoom `host_id`

Vous pouvez trouver votre Zoom `host_id` directement à partir du portail web de Zoom.

#### Étapes :
1. Connectez-vous à votre compte Zoom et naviguez vers :  
   **Panneau d'administration de Zoom > Gestion des utilisateurs > Utilisateurs**  

2. Cliquez sur le nom de l'utilisateur pour lequel vous souhaitez obtenir le `host_id`.

3. Regardez l'URL dans la barre d'adresse de votre navigateur. Elle se présente sous la forme suivante :
https://yourdomain.zoom.us/user/xxxxxxxxxxxxx/profile vous voulez copier le xxxxxxxxxxxxx car il s'agit de votre host_id


---

### 3. Configurer l'intégration de Botpress 

- Installez cette intégration dans votre Bot
- Collez :
- `Zoom Client ID`
- `Zoom Client Secret`
- `Identifiant du compte Zoom`
- `Token secret`
- `Allowed Zoom User IDs` → Collez votre `host_id` (vous pouvez en inclure plusieurs)

Cliquez sur **Sauvegarder la configuration**.

---

### 4. Définir le Webhook dans Zoom

Retournez dans votre application Zoom OAuth :

- Allez dans **Features** → Activer **Abonnements aux événements**
- Nom : `Transcript Received` (Vous pouvez également choisir un autre nom)
- Méthode : Webhook
- Endpoint URL : utilisez l'URL d'intégration de Botpress 
- Ajouter des événements :
- Sous **Enregistrement** :
  - `Tous les enregistrements sont terminés`
  - `L'enregistrement des fichiers de transcription est terminé`
- Cliquez sur **Done**
- Cliquez sur **Valider** à côté de l'URL du point de terminaison (vous devriez voir Validated).
- Cliquez sur **Save**

---

## Terminé ! 

Votre bot Botpress recevra maintenant des transcriptions pour les utilisateurs de Zoom autorisés lorsque les enregistrements seront terminés. Assurez-vous que :

- Vous **enregistrez sur le cloud**
- Vous êtes sur un **plan Zoom payant**
- Vous avez correctement ajouté tous les `host_id`s prévus