# Integración de transcripciones Zoom Reciba y automatice fácilmente transcripciones de reuniones de Zoom en Botpress para reuniones organizadas por usuarios específicos de Zoom. ## Cómo funciona 1. **La reunión de Zoom termina** → Zoom envía un webhook cuando la transcripción está lista. 2. **Filtros de integración `host_id`** → Sólo permite eventos de usuario(s) de Zoom especificado(s). 3. **La transcripción se obtiene y se limpia** → Se descarga de Zoom y se convierte a texto sin formato. 4. 4. **Evento emitido** → Un evento `transcriptReceived` con `meetingUUID` y `transcript` está disponible para tus flujos. --- ## Uso - Activar flujos de trabajo** → Añadir una tarjeta "Escuchar evento" para `transcriptReceived`. - Usar `event.payload.meetingUUID` y `event.payload.transcript` en flujos. - Almacenar transcripciones** → Guardar en tablas para análisis o informes posteriores. --- ## Requisitos previos Usted debe ser: - Un **propietario de cuenta**, **administrador** de Zoom, o tener el rol **"Zoom para Desarrolladores "** para poder crear la aplicación Zoom OAuth. - En un **plan premium de Zoom** (el nivel gratuito no soporta grabaciones en la nube) --- ## Configuración Paso a Paso ### 1. Crear una aplicación Zoom OAuth - Visita: [https://marketplace.zoom.us/](https://marketplace.zoom.us/) - Vaya a **Desarrollar > Crea App** → Elija **Servidor a servidor OAuth** → Asigne un nombre a su app. - En la página **Credenciales de la aplicación**, copie: - ID de cuenta - ID de cliente - Secreto del cliente Las utilizarás más adelante en la configuración de tu integración Botpress . - En **Información**, rellena la información necesaria sobre ti y la aplicación. - En **Features**, copia el **Secret Token**. - En **Scopes**, añade: cloud_recording:read:list_user_recordings:admin cloud_recording:read:list_recording_files:admin cloud_recording:read:recording:admin - Active la aplicación en la pestaña **Activación**. ### 2. Obtener Zoom `host_id` Puedes encontrar tu `host_id` de Zoom directamente desde el portal web de Zoom. #### Pasos: 1. Inicie sesión en su cuenta de Zoom y navegue a: **Panel de administración de Zoom > Gestión de usuarios > Usuarios**. 2. Haga clic en el nombre del usuario del que desea obtener el `host_id`. 3. Mira la URL en la barra de direcciones de tu navegador. Tendrá este formato: https://yourdomain.zoom.us/user/xxxxxxxxxxxxx/profile quieres copiar el xxxxxxxxxxxxx ya que ese es tu host_id --- ### 3. Configurar la integración Botpress - Instala esta integración en tu Bot - Pega - `Zoom Client ID` - Secreto de cliente de Zoom - ID de cuenta de Zoom - Token secreto - Pegue su `host_id` (puede incluir varios) Haga clic en **Guardar configuración**. --- ### 4. Configurar Webhook en Zoom Vuelve a tu Zoom OAuth App: - Ve a **Características** → Habilitar **Suscripciones a Eventos**. - Name: `Transcript Received` (También puede elegir un nombre diferente) - Método: Webhook - URL del punto final: utilice la **URL de integración de Botpress . - Añadir Eventos: - En **Grabación**: - Todas las grabaciones han finalizado - Grabación de los archivos de transcripción se han completado - Haga clic en **Hecho**. - Haga clic en **Validar** junto a la URL del punto final (debería ver Validado) - Haga clic en **Guardar**. --- ## ¡Hecho! Su bot Botpress ahora recibirá transcripciones para los usuarios de Zoom permitidos cuando se completen las grabaciones en la nube. Asegúrese de que: - Grabas en la nube - Tienes un **plan de pago de Zoom**. - Has añadido correctamente todos los `host_id`s previstos
