Zoom
En lugar de seguir estos pasos manualmente, puedes usar el Asistente de Credenciales con IA — describe lo que quieres conectar y la IA te guiara paso a paso, adaptado a tu cuenta.
Descripcion General
Conecta tu cuenta de Zoom a Nirvai para gestionar reuniones, grabaciones y datos de usuario programaticamente a traves de autenticacion OAuth2.
Metodos de Autenticacion Soportados
- OAuth2 - Recomendado para acceso seguro y autorizado por el usuario a los servicios de Zoom
Requisitos Previos
- Una cuenta de Zoom (gratis o de pago)
- Acceso al Zoom App Marketplace
- Permisos de desarrollador para crear y gestionar apps OAuth
Instrucciones de Configuracion
Crear una App OAuth
- Inicia sesion en el Zoom App Marketplace
- Haz clic en Develop en la navegacion superior y selecciona Build App
- Elige OAuth como tipo de app
- Haz clic en Create
- Ingresa un App Name (ej., "Integracion Nirvai")
- Selecciona User-managed app
- Desactiva Would you like to publish this app on Zoom App Marketplace? (para uso interno)
- Haz clic en Create
Configurar Ajustes OAuth
- En la seccion App Credentials, anota tu:
- Client ID
- Client Secret
- Agrega la URI de redireccion de Nirvai en Redirect URL for OAuth:
https://api.nirvai.com/oauth/zoom/callback
- Agrega la misma URL a Add Allow Lists (lista blanca)
Configurar Scopes
En la seccion Scopes, agrega los siguientes permisos:
| Scope | Proposito |
|---|---|
user:read | Leer informacion del perfil de usuario |
user:read:admin | Leer info de usuario (nivel admin) |
meeting:read | Ver detalles de reuniones |
meeting:read:admin | Ver reuniones (nivel admin) |
meeting:write | Crear y gestionar reuniones |
meeting:write:admin | Gestionar reuniones (nivel admin) |
recording:read | Acceder a grabaciones de reuniones |
recording:read:admin | Acceder a grabaciones (nivel admin) |
recording:write:admin | Gestionar grabaciones (nivel admin) |
Completar Configuracion en Nirvai
- En Nirvai, navega a Credenciales
- Haz clic en Agregar Credencial y selecciona Zoom OAuth2
- Haz clic en Conectar con Zoom
- Autoriza la app cuando se te solicite
- Tu credencial se guardara automaticamente
Operaciones de API Disponibles
Con tu credencial OAuth2 de Zoom, puedes:
- Crear, actualizar y eliminar reuniones
- Listar y ver reuniones programadas
- Acceder y gestionar grabaciones de reuniones
- Obtener informacion del perfil de usuario
- Gestionar participantes de reuniones
- Configurar ajustes de reuniones
Solucion de Problemas
Problemas Comunes
- 401 Unauthorized: El token ha expirado. Nirvai actualizara automaticamente los tokens cuando sea posible.
- 403 Forbidden: Faltan scopes requeridos o permisos insuficientes.
- 404 Not Found: La reunion o recurso no existe o fue eliminado.
- Limites de Rate: La API de Zoom tiene limites de rate; contacta a Zoom para limites aumentados si es necesario.
Actualizacion de Token
Los tokens OAuth expiran despues de 1 hora. Nirvai maneja la actualizacion de tokens automaticamente usando el refresh token. Si encuentras problemas de autenticacion persistentes:
- Revoca la credencial existente en Nirvai
- Reconecta tu cuenta de Zoom
- Re-autoriza los scopes requeridos
Activacion de App
Para uso en produccion:
- Completa todos los campos requeridos en la configuracion de la app de Zoom
- Agrega informacion de la app (descripcion, iconos, etc.)
- Envia para activacion (las apps internas pueden activarse instantaneamente)
Limitaciones por Plan
Algunas caracteristicas de API requieren planes especificos de Zoom:
| Caracteristica | Plan Requerido |
|---|---|
| Reuniones basicas | Todos los planes |
| Grabaciones en la nube | Pro o superior |
| Reportes de reuniones | Business o superior |
| Reuniones grandes | Add-on Large Meeting |
| Webinars | Add-on Webinar |
Mejores Practicas de Seguridad
- Mantén tu Client ID y Client Secret confidenciales
- Usa los scopes minimos requeridos para tu caso de uso
- Revisa regularmente las aplicaciones conectadas en la configuracion de Zoom
- Monitorea el uso de API a traves del dashboard del Zoom App Marketplace
Recursos Relacionados
Adaptado para la plataforma Nirvai
Siguientes Pasos
Usa el Creador de Herramientas con IA para convertir esta credencial en herramientas usables por el agente. Describe lo que tu agente deberia poder hacer y la IA investiga la API, configura los endpoints y te entrega un toolkit revisable antes de guardar nada.