Zoom

  # Integrazione della trascrizione Zoom

Ricevete facilmente e automatizzate le trascrizioni delle riunioni Zoom in Botpress per le riunioni ospitate da specifici utenti Zoom.

## Come funziona

1. **La riunione Zoom termina** → Zoom invia un webhook quando la trascrizione è pronta.
2. **Filtri di integrazione `host_id`** → Consente solo gli eventi provenienti dagli utenti Zoom specificati.
3. **La trascrizione viene recuperata e pulita** → Scaricata da Zoom e convertita in testo normale.
4. **Un evento `transcriptReceived` con `meetingUUID` e `transcript` è disponibile per i flussi.

---

## Uso

- **Innesca i flussi di lavoro** → Aggiungere una scheda "Ascolta evento" per `transcriptReceived`.
- **Accesso ai dati** → Utilizzare `event.payload.meetingUUID` e `event.payload.transcript` nei flussi.
- **Salvataggio delle trascrizioni** → Salvare in tabelle per analisi o report successivi.

---

## Prerequisiti

È necessario essere:
- Essere il **proprietario di un account Zoom**, **admin** o avere il ruolo **"Zoom per sviluppatori "** per poter creare l'app Zoom OAuth.
- Avere un piano **Zoom premium** (il livello gratuito non supporta le registrazioni su cloud)

---

## Configurazione passo-passo

### 1. Creare un'applicazione Zoom OAuth

- Visitare: [https://marketplace.zoom.us/](https://marketplace.zoom.us/)
- Andare su **Sviluppo > Costruisci app** → Scegliere **Server-to-Server OAuth** → Dare un nome all'applicazione
- Nella pagina **Credenziali app**, copiare:
  - **Identità dell'account**
  - **ID cliente**
  - **Segreto cliente**

Questi dati verranno utilizzati in seguito nella configurazione dell'integrazione con Botpress .

- In **Informazioni**, compilare le informazioni necessarie su di sé e sull'applicazione.
- In **Features**, copiare il **Secret Token**.
- In **Scopes**, aggiungere:
cloud_recording:read:list_user_recordings:admin
cloud_recording:read:list_recording_files:admin
cloud_recording:read:recording:admin

- Attivare l'applicazione nella scheda **Attivazione**.

### 2. Ottenere Zoom `host_id

Potete trovare il vostro `host_id` di Zoom direttamente dal portale web di Zoom.

#### Passi:
1. Accedere all'account Zoom e navigare in:  
   **Pannello di amministrazione di Zoom > Gestione utenti > Utenti**  

2. Fare clic sul nome dell'utente per il quale si desidera ottenere il `host_id`.

3. Guardate l'URL nella barra degli indirizzi del browser. Sarà in questo formato:
https://yourdomain.zoom.us/user/xxxxxxxxxxxxx/profile si desidera copiare il xxxxxxxxxxxxx, poiché si tratta del proprio host_id.


---

### 3. Configurare l'integrazione Botpress 

- Installare questa integrazione nel Bot
- Incollare:
- `Zoom Client ID`
- `Segreto cliente Zoom`
- ID account Zoom
- Gettone segreto
- `Individui utente Zoom consentiti` → Incolla il tuo `host_id` (puoi includerne più di uno)

Fare clic su **Salva configurazione**.

---

### 4. Impostare Webhook in Zoom

Tornate all'app Zoom OAuth:

- Andare a **Caratteristiche** → Abilitare **Sottoscrizioni agli eventi**.
- Nome: `Transcript Received` (si può scegliere anche un nome diverso)
- Metodo: Webhook
- URL dell'endpoint: utilizzare l'URL di **integrazione con Botpress .
- Aggiungere eventi:
- Sotto **Registrazione**:
  - Tutte le registrazioni sono state completate
  - La registrazione dei file di trascrizione è stata completata.
- Fare clic su **Fatto**
- Fare clic su **Validate** accanto all'URL dell'endpoint (dovrebbe apparire Validated).
- Fare clic su **Salva**

---

## Fatto! 

Il bot Botpress riceverà ora le trascrizioni per gli utenti Zoom autorizzati al termine delle registrazioni cloud. Assicurarsi che:

- Si **registri nel cloud**
- Si abbia un **piano Zoom a pagamento**
- Si siano aggiunti correttamente tutti gli `host_id` previsti