Insumos de Zoom Phone para la integración
Lo que Ocular necesita de la cuenta de Zoom Phone del local para atender las llamadas fuera de horario, medirlas y comparar contra el asistente anterior. Complete esta lista con su administrador de Zoom y envíela a su contacto de Customer Success de Ocular.
No envíe credenciales, tokens ni claves por correo ni por chat. Los accesos de API se otorgan desde la cuenta de Zoom con un usuario administrador, por el canal seguro que indique Customer Success.
1. Cuenta y accesos
| Insumo | Detalle | Obligatorio |
|---|---|---|
| Administrador de Zoom Phone | Nombre y correo de quien puede cambiar la configuración de números, colas y horarios | Sí |
| Plan de Zoom Phone | Tipo de plan y región de la cuenta (determina si el desvío externo y la API están habilitados) | Sí |
| Acceso de API de Zoom Phone | Una app Server-to-Server OAuth creada por su administrador en su propia cuenta de Zoom, con permisos de lectura sobre registros de llamadas, grabaciones y transcripciones, usuarios y colas. No requiere instalar ninguna app del Marketplace ni revisión de Zoom. Instrucciones en la sección 1.1. Se usa para medir, comparar y cargar la base de conocimiento. | Sí para la comparación |
| Permisos de escritura (opcional) | Si se quiere que Ocular actualice el desvío o la ruta fuera de horario desde la plataforma, permiso de escritura sobre la configuración de números y colas | No |
1.1 Cómo crear la app Server-to-Server OAuth (lo hace su administrador de Zoom)
Es un tipo de app interno de su cuenta: no se publica en el Marketplace ni pasa por revisión de Zoom. Costo: cero. Tiempo: minutos.
- Ingrese a marketplace.zoom.us con un usuario administrador de la cuenta de Zoom del local.
- Arriba a la derecha, Develop → Build App.
- Elija el tipo Server-to-Server OAuth y pulse Create. Nombre sugerido:
Ocular - <nombre del local>. - En Information, complete el nombre de la app, la empresa y un contacto. En Feature no active nada.
- En Scopes → Add Scopes, busque Phone y marque solo los permisos de lectura (
View): registros de llamadas (call logs), grabaciones (recordings) y sus transcripciones, usuarios y colas (call queues). No agregue permisos de escritura ni de otros productos. - En Activation, pulse Activate your app.
- En App Credentials verá el Account ID, el Client ID y el Client Secret. Entréguelos a Ocular solo por el canal seguro que le indique Customer Success, nunca por correo ni chat.
Tenga en cuenta:
- La app solo da acceso a los datos de esa cuenta de Zoom. Si tiene varias cuentas, se repite el paso en cada una.
- Zoom recomienda una app por servicio integrado, para auditar permisos y uso por separado. No reutilice una app de otro proveedor.
- Los permisos que puede asignar dependen del rol de quien crea la app; si no ve los de Phone, debe hacerlo un administrador con rol completo de Zoom Phone.
- Para que Ocular lea grabaciones y transcripciones, la grabación automática debe estar habilitada en la política de Zoom Phone del número o de la cola.
- Puede revocar el acceso en cualquier momento desactivando la app desde el mismo panel.
2. Números y rutas actuales
| Insumo | Detalle |
|---|---|
| Número principal del local | E.164 (por ejemplo, +56 2 XXXX XXXX) y a qué objeto de Zoom está asignado: recepcionista automática, cola o usuario |
| Números adicionales | Líneas directas, números de delivery o de gerencia, con su asignación |
| Identificador de la cola del local | Nombre e identificador de la cola a la que hoy llegan las llamadas urgentes; usuarios o extensiones que la atienden |
| Buzón de voz | A qué extensión o cola pertenece y quién lo revisa |
| Recepcionista automática | Si existe, su configuración actual: menú, opciones y a dónde lleva cada una |
| Horarios configurados en Zoom | Horario de atención, horario cerrado y feriados de cada número, cola o recepcionista, con zona horaria |
| Ruta actual fuera de horario | Qué pasa hoy cuando el local está cerrado: asistente de voz, buzón, desvío, mensaje |
3. Punto de entrada a Ocular
Zoom Phone entrega las llamadas a Ocular por una de estas vías. Indique cuál prefiere:
| Vía | Qué debe configurarse en Zoom Phone | Qué entrega Ocular |
|---|---|---|
| Desvío fuera de horario a un número de Ocular (recomendada para arrancar) | En la recepcionista automática o en la cola, la ruta de "horario cerrado" apunta a un número externo provisto por Ocular. El desvío externo debe estar habilitado en el plan. | Un número +56 (o del país del local) dedicado al local |
| Desvío condicional | Igual que la anterior, pero solo cuando la cola no contesta en N segundos o está llena (desborde) | El mismo número de Ocular |
| SIP | Si la cuenta usa su propio carrier o un SBC (BYOC/premise peering), el carrier entrega la llamada a Ocular por SIP con el número original y la identidad del llamante | URI SIP y requisitos de red (ver SIP URI forwarding hacia Ocular) |
Confirme además:
- Identidad del llamante en el desvío. Que Zoom Phone conserve el número de quien llama al desviar a Ocular (y no reemplace por el número del local). Es lo que permite reconocer empleados y registrar reclamos con número de contacto.
- Número marcado. Que Ocular reciba el número del local al que llamaron, para atender varios locales con una sola integración.
4. Retorno de la llamada a Zoom
Para que Ocular transfiera a la cola del local con resumen y retome la llamada si nadie contesta:
| Insumo | Detalle |
|---|---|
| Número directo o extensión de la cola del local | Al que Ocular transfiere los asuntos urgentes; debe aceptar llamadas externas |
| Número del encargado o gerente | Para avisos y transferencias fuera de horario, con horario en que acepta llamadas |
| Número de emergencia | Destino de la regla de emergencia |
| Tiempo máximo de timbrado | Segundos que Ocular espera antes de retomar la llamada y tomar el recado |
| Identidad a presentar | Qué número debe ver el local cuando Ocular le transfiere: el del cliente, el del local o el de Ocular |
5. Asistente actual y base de conocimiento
| Insumo | Detalle |
|---|---|
| Export del asistente de voz de Zoom | Archivo JSON exportado desde la configuración del asistente (prompt, skills, destinos, ajustes de voz) |
| Base de conocimiento | Contenido completo (documentos, preguntas y respuestas, URLs) o acceso de lectura a la base conectada al asistente |
| Reglas de atención vigentes | Lo que el asistente hoy debe y no debe hacer (por ejemplo, no dar indicaciones de ruta) |
| Grabaciones y transcripciones | Acceso por API o export de un periodo representativo, para la prueba de laboratorio y la línea base de la comparación |
6. Empleados y destinos
| Insumo | Detalle |
|---|---|
| Lista de empleados para verificación | Nombre, número de celular registrado (+56 9 XXXX XXXX) o código asignado; se usa solo para verificar la identidad en llamadas de turno y urgencia |
| Encargados por turno | Quién recibe avisos de turno y ausencia, y por qué canal (plataforma, email, SMS, WhatsApp) |
| Responsable de reclamos | Nombre, canal y plazo de respuesta |
| Agregadores de delivery | Cuáles operan con el local y sus enlaces o números de soporte |
7. Pruebas y comparación
| Insumo | Detalle |
|---|---|
| Número de prueba | Un número del local (o uno nuevo en Zoom Phone) para probar sin afectar la operación |
| Ventanas de prueba | Fechas y horas con el administrador de Zoom disponible |
| Mecanismo de división para la fase en paralelo | Por horario, por día o por porcentaje; se configura en la ruta fuera de horario de Zoom |
| Criterio de aceptación | Qué debe cumplirse para dar por cerrada la comparación |
8. Cumplimiento
| Insumo | Detalle |
|---|---|
| Aviso de grabación y de agente de IA | Texto a reproducir, según la normativa de Chile |
| Política de retención | Cuánto tiempo conservar grabaciones y transcripciones |
| Lista de no contactar | Si aplica para avisos o devoluciones de llamada |
Cómo enviarlo
Envíe esta lista a su contacto de Customer Success. Lo que no sepa, márquelo como "pendiente". Customer Success le devolverá, por el canal seguro, el número o URI de Ocular para el desvío, la aplicación a autorizar en el Marketplace de Zoom y la fecha de la primera prueba. El formulario general de telefonía está en Insumos que necesitamos del cliente.