Funciones de supervisor en la app MonoPhone
Determinadas personas pueden supervisar desde la app MonoPhone en su teléfono, tableta o computadora (macOS y Windows) sin abrir la consola web. La app muestra el área Supervisor solo a quien tiene al menos un permiso de supervisor a través de un rol. Nadie más la ve, y el servidor comprueba el mismo permiso en cada solicitud que hace el área, por lo que ocultar una pantalla nunca es la única protección.
Qué ofrece el área Supervisor
| En la app | Qué hace | Permiso que necesita |
|---|---|---|
| Colas | Las colas que supervisa, con las personas que llaman en espera, cada agente y su estado (disponible, en llamada, en pausa, cierre de llamada, sin sesión). Inicie o cierre la sesión de un agente en sus colas, pause y reanude a un agente. Escuche, susurre o intervenga en una llamada contestada de una cola: primero suena su propio teléfono y usted oye la llamada cuando contesta. | queues:monitor para el departamento de la cola |
| Tablero | Personas que llaman en espera, la espera más larga, agentes con sesión iniciada y el nivel de servicio (SLA) del día de cada cola que supervisa, con color según qué tan cerca está la cola de su objetivo. | queues:monitor (el nivel de servicio también necesita reports:read) |
| Llamadas en curso | Las llamadas en curso de la empresa o del departamento: quién habla y desde hace cuánto. Cuelgue o transfiera a una de las partes de una llamada atascada. Las llamadas de emergencia se listan, pero nunca se controlan. | calls:control para el departamento de una de las partes de la llamada |
| Bandejas del equipo | Las conversaciones de los canales de bandeja a los que tiene acceso (SMS, WhatsApp, Telegram, chat en vivo), las que nadie ha tomado primero. Responder abre el hilo, Asignar lo entrega a una persona, Cerrar lo archiva. | messaging:write; el servidor limita por el departamento del canal |
| Buzón de voz compartido | Los buzones compartidos (buzón de voz de colas y de grupos de timbrado) que puede leer, cada uno con sus mensajes más recientes y si cada uno está en espera o en atención. Un miembro de un buzón puede tomar un mensaje o devolverlo. Escuchar sigue en la pestaña Buzón de voz de la app. | voicemail:read (tomar y devolver requieren ser miembro del buzón) |
| Alertas | Una troncal se cayó, terminó una campaña del marcador, una campaña del marcador se detuvo al llegar a su hora de fin: los últimos 7 días y el conteo de las últimas 24 horas. | trunks:read para alertas de troncales, queues:read para alertas de campañas (a nivel de empresa); solo ve los tipos que tiene |
| Grabaciones | Las grabaciones de llamadas del equipo, de la más reciente a la más antigua, y una búsqueda sobre lo que se dijo (las transcripciones). Reproduzca una grabación mediante un enlace firmado de corta duración. Cada búsqueda se audita (transcript.search, nunca las palabras) y cada reproducción se audita (recording.downloaded, con quién la solicitó). Una grabación bajo retención legal aparece marcada. | recordings:read, para el departamento de una de las partes de la llamada |
| Control del equipo | Cambie el estado de un colega (disponible, no molestar, ausente, etc., cada uno con sus propias reglas de desvío), y fuerce el estado de horario de oficina de una programación a abierto o cerrado durante una hora, o devuélvalo a su horario semanal. | Un estado requiere users:write para el departamento de esa persona; una anulación requiere calls:control para el departamento de la programación. Una sección que no puede usar se oculta. |
| Hoy | Reportes de un vistazo: llamadas ofrecidas, contestadas y abandonadas del día, tasa de respuesta, espera y tiempo de conversación promedio, y el nivel de servicio, con una línea por cola. | reports:read (el nivel de servicio también lo necesita) |
| Campañas | Avance en vivo de las campañas de voz (marcador) y de mensajes: estado, barra de progreso, cuántos se han completado y (en mensajes) cuántos fallaron. Con el permiso de control: Iniciar, Pausar, Reanudar y Detener (Detener pregunta antes y no se puede deshacer). Sin él, la pestaña es solo de consulta. | Voz: ver queues:read, controlar queues:write. Mensajes: ver messaging:read, controlar messaging:write. |
| Devoluciones de llamada | Las devoluciones de llamada que solicitaron las personas que llaman. Rechace una pendiente, o apruebe una fallida para que se intente de nuevo (se aplican las mismas reglas contra fraude telefónico que a los intentos del propio motor). | queues:write para el departamento de la cola |
El área se abre para quien tiene un permiso de al menos una pestaña (queues:monitor, calls:control, messaging:write, voicemail:read, recordings:read, reports:read, queues:read, queues:write, messaging:read, users:write o trunks:read), y muestra solo las pestañas para las que tiene permiso. Un rol Usuario común no tiene ninguno, así que nunca ve el área. Quien solo tiene calls:control ve Llamadas en curso (y las pestañas que abren sus otros permisos); con solo queues:monitor, Colas y Tablero. En un teléfono, los destinos están en una barra inferior; en una tableta o ventana de escritorio, en un riel lateral.
Todo lo que hace la app es la misma acción que en la consola web y se registra en el registro de auditoría de la misma manera (supervisor.* para la supervisión de colas, call.control_* para llamadas en curso), también cuando el servidor la rechaza.
Alcance: toda la empresa o un departamento
Ambos permisos pueden otorgarse para toda la empresa o para departamentos seleccionados. Un supervisor de Ventas ve y actúa sobre las colas de Ventas y las llamadas que tienen una parte en Ventas, y nada más. Una llamada o una cola fuera de ese alcance se responde como si no existiera. Iniciar o cerrar la sesión de un agente cambia todas las colas de ese agente, por lo que requiere el permiso para cada una de ellas.
Roles predefinidos
Cada empresa tiene cuatro roles predefinidos. Son roles personalizados comunes: cambie sus permisos, cámbieles el nombre o elimínelos en la página Roles como cualquier rol que usted haya creado. Una empresa que ya tiene un rol con la misma clave conserva su propio rol.
| Rol | Para | Incluye |
|---|---|---|
| Supervisor de colas | La persona que vigila las colas en vivo | Directorio y contactos, users:read, extensions:read, queues:read, queues:monitor, calls:control, call_history:read, reports:read |
| Líder de equipo | Un líder de equipo | Todo lo que incluye Supervisor de colas, más recordings:read, voicemail:read, call_notes:read_team, messaging:read y messaging:write |
| Supervisor de campañas | La persona que da seguimiento a las campañas salientes | Directorio y contactos, queues:read, call_history:read, reports:read (sin escuchar llamadas ni controlarlas) |
| Gerente de solo lectura | Un gerente que mira y nunca toca | Permisos de lectura de usuarios, departamentos, roles, extensiones, dispositivos, colas, grupos de timbrado, historial, grabaciones, buzón de voz, reportes, mensajería, fax, flujos de llamadas, troncales, planes de marcación y configuración. Sin permisos de escritura, sin queues:monitor, sin calls:control |
Asígnelos en la página de un usuario (Usuarios, abra el usuario, Asignar rol) para toda la empresa o para un departamento. Se aplica la misma regla que a todos los roles: solo puede otorgar permisos que usted mismo tenga.
Alertas por rol
El servidor detecta una troncal que deja de responder (después de haber estado activa), una campaña del marcador que se queda sin contactos y una campaña del marcador detenida por su hora de fin. Guarda una alerta para la pestaña Alertas y envía una notificación push a los dispositivos de las personas que tienen el permiso de ese tipo a nivel de empresa (un rol otorgado solo para un departamento no recibe alertas de toda la empresa). La notificación indica que ocurrió algo y no incluye detalles: la pestaña Alertas muestra qué. Las alertas se conservan 30 días. Aprobar devoluciones de llamada requiere queues:write, que ninguno de los cuatro roles predefinidos tiene (también permite cambiar la configuración de una cola): otórguelo mediante un rol personalizado o un rol de Administrador de departamento o Gerente. Una alerta de cuota o de licencia, y una alerta de nivel de servicio de cola, no forman parte de esta versión.
Quién tiene el área Supervisor
- La página Usuarios tiene una columna Funciones de la app: Supervisor para cada persona que tiene un permiso de supervisor a través de un rol (pase el cursor para ver los roles que lo otorgan), Ninguna para las demás. La columna lista a las personas que permite su propio alcance de
users:read. - La página Roles tiene la misma columna para los roles: muestra qué roles abren el área Supervisor.
GET /app-features/usersdevuelve la misma lista para integraciones.
Widgets y relojes
Una persona que puede supervisar puede colocar el widget Supervisor en la pantalla de inicio (iPhone, iPad y Android) o en la pantalla de bloqueo (iPhone), y obtener una complicación y un vistazo de Supervisor en un Apple Watch, y un mosaico y una complicación en un reloj Wear OS. Solo muestran conteos: personas en espera y la espera más larga, llamadas en curso, campañas en ejecución y alertas de las últimas 24 horas. Al tocar uno, se abre la pestaña correspondiente del área Supervisor.
- Los mismos permisos que la app. Una sección aparece solo cuando la persona tiene el permiso de la pestaña correspondiente. Sin ningún permiso de supervisor, el widget indica que las funciones no están disponibles y no muestra ningún número; los relojes no muestran nada.
- Cómo se actualizan. El widget consulta al servidor por sí mismo (
GET /me/supervisor-summary) cada 15 minutos en iOS y aproximadamente cada 30 minutos en Android (lo mínimo que permiten esos sistemas), y la app envía cifras nuevas cada vez que se ejecuta o cambian sus permisos. Los relojes obtienen las cifras del teléfono (Wear OS) o consultan ellos mismos al servidor (Apple Watch). Cuando se retira un rol, las cifras desaparecen en la siguiente actualización. - Token del widget. El widget usa el token de widget de corta duración existente (siete días, almacenado en el Llavero de iOS o en el Keystore de Android, nunca en un archivo simple, revocado al cerrar sesión). Lo aceptan el resumen, el cambio de estado de la propia persona y su propia revocación, y nada más, y el servidor sigue aplicando los roles de la persona en cada solicitud. Cada uso se audita (
auth.widget_token_used). - Idiomas. Los textos provienen del idioma de la app (nueve idiomas), en la apariencia clara u oscura del dispositivo.
Los cambios se aplican de inmediato
Cuando usted asigna un rol a alguien, se lo retira, o cambia los permisos de un rol que esa persona tiene, el servidor avisa de inmediato a la app de esa persona y la app vuelve a leer sus permisos. El área Supervisor aparece, o una pestaña desaparece, en un instante: nadie tiene que cerrar sesión ni reiniciar la app. La app también vuelve a leer sus permisos cada vez que se reconecta al servidor. Una acción que la persona intenta justo después de perder un permiso es rechazada por el servidor (403, MPBX-RBAC-FORBIDDEN), exactamente como en la consola. Una escucha, un susurro o una intervención en curso termina cuando su supervisor pierde queues:monitor para esa cola.
Mientras la app no haya leído sus permisos (por ejemplo, cuando inicia sin conexión), el área Supervisor permanece oculta en lugar de suponerse. Un teléfono configurado con un código QR o un enlace no tiene sesión de API y no muestra el área.
Límites
- Escuchar, susurrar e intervenir funcionan en llamadas contestadas de colas. Una llamada que no es de una cola se rechaza con
MPBX-SUP-NOT-QUEUE-CALL. - La supervisión requiere un usuario con sesión iniciada. Una clave de API no puede escuchar llamadas.
- El pitido de aviso (si el agente y quien llama oyen un tono corto cuando se une un supervisor) es una configuración de la empresa en Colas, no una configuración de la app.