Integrar Zoom en Booknetic SaaS

Booknetic SaaS admite Zoom como integración de videoconferencias por inquilino. Cuando se reserva la cita de un inquilino, Booknetic crea automáticamente una reunión de Zoom y expone el enlace de acceso a las notificaciones de workflow mediante el shortcode orientado al cliente {zoom_meeting_url} y el shortcode orientado al personal {zoom_meeting_host_url}.

Hay dos métodos de integración admitidos en Booknetic SaaS:

Importante: Booknetic ya no admite aplicaciones Zoom JWT. Zoom dejará de funcionar las aplicaciones JWT el 1 de septiembre de 2023. Si tiene una instalación de Booknetic SaaS anterior configurada para JWT, cambie a OAuth o Server-to-Server siguiendo las instrucciones a continuación.

Antes de que cualquiera de los métodos funcione:

1. el zoom La capacidad del plan debe estar habilitada en cada plan de inquilino que debe tener acceso a Zoom (Booknetic SaaS → Plans → editar un plan → alternar zoom encendido).
2. Cada inquilino debe conectar una cuenta Zoom con cada miembro del personal que debe usar Zoom (panel de inquilino → Staff → editar un personal → conectar Zoom).
3. Cada inquilino debe alternar "Activar Zoom para el servicio" en cada servicio que deba crear automáticamente una reunión Zoom (panel de inquilino → Servicios → editar un servicio).

Método OAuth: configure la aplicación Zoom para toda la plataforma

Utilice esta ruta cuando desee una aplicación Zoom OAuth para todo el SaaS, con cada inquilino iniciando sesión en su propia cuenta Zoom a través de esa aplicación compartida.

Paso 1: abra la consola de desarrollador de Zoom Marketplace.

1. Regístrate en https://marketplace.zoom.us con la cuenta Zoom que será propietaria de la aplicación.
2. Haga clic Desarrollar → Crear aplicación.
3. elegir Aplicación OAuth (Zoom también puede llamar a esto Aplicación OAuth (nivel de cuenta) dependiendo de UI rev).

Paso 2: complete los conceptos básicos de la aplicación.

• Nombre de la aplicación — nombre de la aplicación pública; los clientes ven esto en la pantalla de consentimiento Zoom.
• Tipo de aplicación - elegir Aplicación administrada por el usuario por lo que cada inquilino conecta su propia cuenta de usuario Zoom.
• icono de la aplicación — cargue el logotipo de su marca (se recomienda 300×300 PNG).

Paso 3: Copie el redireccionamiento URI de Booknetic a Zoom.

1. En Booknetic SaaS → Settings → Integrations → Zoom, establezca el método de integración = OAuth. La pantalla ahora muestra un mensaje de solo lectura. Devolución de llamada URI (también llamado Redirigir URI en UI de Zoom).
2. Copia ese URI exactamente.
3. De vuelta en Zoom Marketplace → su aplicación → Credenciales de la aplicación, pegue el URI en ambos Redirigir URL para OAuth y Agregar listas permitidas.

Paso 4: Pegue las credenciales de Zoom en Booknetic.

1. En Zoom Marketplace → Credenciales de aplicación, copie Cliente ID (desarrollo) y Secreto del cliente (desarrollo).
2. En Booknetic SaaS → Settings → Integrations → Zoom, péguelos en Cliente ID y Secreto del cliente.
3. Guardar.

Paso 5: Establecer los valores predeterminados del tema y la descripción de la reunión (del lado del inquilino).

Cada inquilino puede editarlos más tarde en su propio panel, pero es útil establecer valores predeterminados sensatos:

• Tema de la reunión — título de la reunión Zoom. Códigos cortos como {service_name}, {staff_name}, {customer_full_name} son compatibles.
• Descripción de la reunión — cuerpo de la agenda (máximo 2000 caracteres).
• Establecer contraseña aleatoria — alterne ON si desea que Zoom genere automáticamente una contraseña de reunión de 6 dígitos.

Paso 6: complete la información de la aplicación.

Zoom requiere información de la aplicación para su revisión: descripción breve, descripción larga, categorías, contacto de empresa/soporte, política de privacidad URL y términos de servicio URL en su plataforma.

Paso 7: elija visores.

Booknetic necesita como mínimo:

• meeting:write:admin — crear / actualizar reuniones.
• user:read:admin — leer el perfil del usuario conectado.

Agregue cualquier alcance adicional que el UI de Zoom requiera para su tipo y nivel de aplicación.

Paso 8: enviar para revisión.

Las credenciales de producción estarán disponibles solo después de que Zoom apruebe la aplicación. La revisión suele tardar entre 5 y 10 días laborables. Zoom es estricto sobre la revisión de evidencia; en la sección "Cuenta de prueba y credenciales", registre un inquilino de demostración privada en su SaaS y proporcione las credenciales de los revisores del Zoom para que puedan ver el flujo de creación automática de la reunión Zoom de principio a fin.

Mientras la revisión está pendiente, puede utilizar el credenciales de desarrollo Zoom se muestra en la pantalla Credenciales de la aplicación. Booknetic acepta credenciales de desarrollo para que pueda finalizar las pruebas.

Paso 9: Después de la aprobación, cambie a las credenciales de producción.

Cuando reciba el correo electrónico de aprobación de Zoom:

1. Abra su aplicación Zoom → Credenciales de la aplicación.
2. Copiar Producción Cliente ID y secreto de cliente.
3. Pégalos en Booknetic SaaS → Settings → Integrations → Zoom (reemplazando los value de desarrollo).
4. Guardar.

Método Server-to-Server: credenciales Zoom por inquilino

Utilice esta ruta cuando desee que cada inquilino traiga sus propias credenciales Zoom sin necesidad de registrar una aplicación OAuth.

Paso 1: Cambiar el método de integración.

En Booknetic SaaS → Settings → Integrations → Zoom, establezca Método de integración = Server-to-Server. Los campos Cliente ID / Secreto de cliente / Cuenta ID mueven el alcance: ahora inquilinos llénelos dentro de su propio panel.

Paso 2: Tenants registra una aplicación Server-to-Server en Zoom Marketplace.

Cada inquilino inicia sesión en Marketplace.zoom.us con su propia cuenta Zoom y luego:

1. Desarrollar → Crear aplicación → Aplicación Server-to-Server OAuth.
2. Complete los conceptos básicos de la aplicación → Active la aplicación.
3. Copiar Cuenta ID, Cliente ID, Secreto del cliente.

Paso 3: Tenants pegue las credenciales en su panel de inquilinos.

Panel de inquilino → Settings → Integrations → Zoom →

• Cuenta ID
• Cliente ID
• Secreto del cliente

Guardar.

Paso 4: Vincular al personal de Tenants con Zoom.

Panel de inquilinos → Staff → editar un personal → sección Zoom → Usuario Zoom menú desplegable → elija el usuario Zoom en el que este miembro del personal debe organizar reuniones.

Bloqueadores de configuración comunes

Cambio desde JWT (instalaciones heredadas)

Si su instalación de Booknetic SaaS se configuró con Zoom JWT antes de septiembre de 2023:

1. La aplicación JWT en su cuenta Zoom ya no autoriza solicitudes: Zoom rechazará llamadas.
2. Vuelva a crear su integración usando OAuth (el primer método de esta guía) o Server-to-Server (arriba).
3. Solicite a cada inquilino que vuelva a conectar su cuenta Zoom una vez que las nuevas credenciales estén en su lugar.
4. Las reuniones existentes de Zoom ya creadas permanecen en Zoom; solo las reservas nuevas necesitan la nueva ruta de autenticación.