Saltar al contenido principal

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​

InsumoDetalleObligatorio
Administrador de Zoom PhoneNombre y correo de quien puede cambiar la configuración de números, colas y horariosSí
Plan de Zoom PhoneTipo 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 PhoneUna 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 colasNo

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.

  1. Ingrese a marketplace.zoom.us con un usuario administrador de la cuenta de Zoom del local.
  2. Arriba a la derecha, Develop → Build App.
  3. Elija el tipo Server-to-Server OAuth y pulse Create. Nombre sugerido: Ocular - <nombre del local>.
  4. En Information, complete el nombre de la app, la empresa y un contacto. En Feature no active nada.
  5. 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.
  6. En Activation, pulse Activate your app.
  7. 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​

InsumoDetalle
Número principal del localE.164 (por ejemplo, +56 2 XXXX XXXX) y a qué objeto de Zoom está asignado: recepcionista automática, cola o usuario
Números adicionalesLíneas directas, números de delivery o de gerencia, con su asignación
Identificador de la cola del localNombre e identificador de la cola a la que hoy llegan las llamadas urgentes; usuarios o extensiones que la atienden
Buzón de vozA qué extensión o cola pertenece y quién lo revisa
Recepcionista automáticaSi existe, su configuración actual: menú, opciones y a dónde lleva cada una
Horarios configurados en ZoomHorario de atención, horario cerrado y feriados de cada número, cola o recepcionista, con zona horaria
Ruta actual fuera de horarioQué 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íaQué debe configurarse en Zoom PhoneQué 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 condicionalIgual que la anterior, pero solo cuando la cola no contesta en N segundos o está llena (desborde)El mismo número de Ocular
SIPSi 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 llamanteURI 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:

InsumoDetalle
Número directo o extensión de la cola del localAl que Ocular transfiere los asuntos urgentes; debe aceptar llamadas externas
Número del encargado o gerentePara avisos y transferencias fuera de horario, con horario en que acepta llamadas
Número de emergenciaDestino de la regla de emergencia
Tiempo máximo de timbradoSegundos que Ocular espera antes de retomar la llamada y tomar el recado
Identidad a presentarQué 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​

InsumoDetalle
Export del asistente de voz de ZoomArchivo JSON exportado desde la configuración del asistente (prompt, skills, destinos, ajustes de voz)
Base de conocimientoContenido completo (documentos, preguntas y respuestas, URLs) o acceso de lectura a la base conectada al asistente
Reglas de atención vigentesLo que el asistente hoy debe y no debe hacer (por ejemplo, no dar indicaciones de ruta)
Grabaciones y transcripcionesAcceso 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​

InsumoDetalle
Lista de empleados para verificaciónNombre, 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 turnoQuién recibe avisos de turno y ausencia, y por qué canal (plataforma, email, SMS, WhatsApp)
Responsable de reclamosNombre, canal y plazo de respuesta
Agregadores de deliveryCuáles operan con el local y sus enlaces o números de soporte

7. Pruebas y comparación​

InsumoDetalle
Número de pruebaUn número del local (o uno nuevo en Zoom Phone) para probar sin afectar la operación
Ventanas de pruebaFechas y horas con el administrador de Zoom disponible
Mecanismo de división para la fase en paraleloPor horario, por día o por porcentaje; se configura en la ruta fuera de horario de Zoom
Criterio de aceptaciónQué debe cumplirse para dar por cerrada la comparación

8. Cumplimiento​

InsumoDetalle
Aviso de grabación y de agente de IATexto a reproducir, según la normativa de Chile
Política de retenciónCuánto tiempo conservar grabaciones y transcripciones
Lista de no contactarSi 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.