Inicio rápido del administrador

Esta página lleva a una empresa nueva desde una instalación vacía hasta una primera llamada funcionando: el asistente de configuración, una troncal, un número (DID), una ruta de entrada, un IVR, los usuarios y la incorporación del softphone. Cada paso indica la página de la consola. La API correspondiente está en Introducción a la API, y la referencia completa está en /api/docs.

Antes de empezar, termine una instalación: Docker Compose, VM de Ubuntu o Kubernetes. Tenga a la mano la clave de recuperación y los datos de alta de su operadora.

:::info Estado Todo lo de esta página existe en la rama principal. Lo que todavía no está construido se marca como disponible en Alpha. MonoPbx no verifica la configuración de la operadora: las plantillas de troncal son puntos de partida de buena fe que usted debe comparar con los documentos de la operadora. :::

1. Asistente de configuración

Abra el enlace de configuración de un solo uso que imprimió el instalador. En una VM, sudo mpbx-ctl setup-url emite uno nuevo. El asistente:

1. crea al Propietario del sistema (correo, nombre y una contraseña de su elección);
2. registra la aplicación de autenticación del propietario (TOTP). Esto consume el enlace;
3. muestra los códigos de recuperación una sola vez. Guárdelos junto con la clave de recuperación;
4. define el nombre de la empresa y el idioma predeterminado, pide un certificado para la dirección de la instalación (ACME cuando está configurado, si no, una subida), muestra la troncal propuesta de [setup.trunk] e invita a los primeros usuarios.

Cada paso puede omitirse y terminarse después en la consola. El asistente lee las respuestas preparadas en mpbx.toml bajo [setup], así que usted solo las confirma. Vea la guía del asistente de configuración.

Los ajustes de toda la instalación (respaldos, certificados de la instalación) necesitan un código nuevo de su aplicación de autenticación. Abra Seguridad de la cuenta y luego Administración de toda la instalación.

2. Empresa, departamentos y roles

• Administración > Departamentos. Cada empresa tiene un departamento predeterminado. Cree más solo cuando necesite roles separados o enrutamiento de llamadas por grupo.
• Administración > Roles. Los usuarios nuevos reciben el rol integrado Usuario (sus propias llamadas, buzón de voz, directorio). Dé derechos adicionales por empresa o por departamento. La API decide cada solicitud; la consola solo muestra los botones que un usuario puede usar.
• Mantenga al menos dos personas con el rol de Propietario. El último Propietario no puede deshabilitarse ni perder el rol.

3. Troncal

Una troncal conecta la empresa con una operadora.

1. Administración > Troncales > Nueva troncal. Elija una plantilla de proveedor si alguna encaja, o la plantilla genérica de registro o de IP. Las plantillas no están verificadas: complete cada marcador de posición con el portal de la operadora.
2. Elija register (la PBX se registra con la operadora usando credenciales de digest) o ip (la operadora envía llamadas desde direcciones conocidas; configure la lista de permitidos).
3. Ingrese el host, el puerto, el transporte y las credenciales de la cuenta. Los secretos son solo de escritura: la consola nunca vuelve a mostrarlos.
4. Defina canales máximos con su límite de llamadas contratado, y el número principal (E.164) usado para el identificador de llamadas.
5. Revise el estado en vivo en la lista (up, registering, registration failed, etcétera). Una falla muestra el último error con palabras.

Cada campo está descrito en Troncales SIP.

4. Número (DID)

Administración > DID. Agregue cada número que contrató en formato E.164 (por ejemplo +525512345678) y asígnelo a la troncal por la que llega. Un número pertenece a una sola empresa. Un número que ya tiene otra empresa se rechaza (MPBX-TRUNK-DID-TAKEN).

5. Ruta de entrada

Administración > Enrutamiento > Entrada. Una ruta de entrada envía un DID a un destino:

• una extensión de usuario, un grupo de timbrado (Administración > Grupos de timbrado), una cola (Administración > Colas), un IVR (abajo) o reject;
• una ruta sin DID es el catch-all para los números sin ruta. El DID exacto en esa troncal tiene prioridad sobre el DID exacto en cualquier troncal, que tiene prioridad sobre el catch-all de la troncal, que tiene prioridad sobre el catch-all de la empresa.

Use Administración > Enrutamiento > Prueba (el probador de reglas) antes de recibir llamadas reales. Usa el mismo enrutador que las llamadas en vivo, así que muestra adónde iría una llamada desde un número dado a un DID dado.

Los números de emergencia se configuran en Administración > Emergencias. Revíselos antes de salir en vivo: la consola explica cuándo un cambio necesita aprobación.

6. Reglas de salida

Administración > Enrutamiento > Salida. Las reglas de salida deciden qué troncal transporta un número marcado, en qué orden, con conmutación por falla. Empiece con una regla para llamadas nacionales y otra para internacionales, y luego pruebe ambas en el probador de reglas. La guía del plan de marcación describe las reglas de seguridad contra el fraude telefónico; léalas antes de abrir destinos internacionales.

7. Menú IVR

Administración > Menús IVR. Un IVR es un menú: un saludo de hasta 16 indicaciones, hasta 12 teclas que llevan cada una a un destino, el número de intentos, la espera por una tecla y las indicaciones que se reproducen después de una tecla incorrecta o de no presionar ninguna. Publique el menú cuando esté correcto. Una versión publicada nunca cambia; una edición posterior crea un borrador nuevo.

Apunte una ruta de entrada al IVR para usarlo.

El horario laboral (Administración > Horarios, los días festivos en Administración > Horarios > Días festivos) puede enviar las llamadas a un destino distinto cuando la empresa está cerrada o en pausa. Los grupos de timbrado, las colas y los valores predeterminados de desvío se configuran en Administración > Grupos de timbrado, Administración > Colas y Administración > Valores de desvío predeterminados.

8. Extensiones, usuarios e invitaciones

1. Administración > Extensiones. Cada usuario tiene un número de extensión. Los buzones de voz pertenecen a las extensiones de usuario. Se crean automáticamente cuando la empresa activa la creación automática en sus valores predeterminados de buzón de voz (Administración > Sistema > Buzón de voz).
2. Administración > Usuarios > Nuevo usuario. Ingrese el nombre, el correo, el departamento y los roles. Deje la contraseña vacía y envíe la invitación. El usuario recibe un enlace de un solo uso por correo y elige una contraseña. Nunca se envía una contraseña por correo.
3. Los usuarios también se pueden importar desde CSV (hasta 2000 filas por archivo) en la página de Usuarios. La exportación usa el mismo formato.
4. Deshabilitar a un usuario termina sus sesiones de inmediato. Un administrador puede restablecer el registro de dos factores o la contraseña de un usuario.

La política de contraseñas exige al menos 12 caracteres. Cinco inicios de sesión fallidos bloquean la cuenta durante 15 minutos.

9. Dispositivos e incorporación del softphone

Cada dispositivo se registra con sus propias credenciales SIP. Nadie comparte la contraseña de la extensión.

• Teléfono en el navegador. No hay nada que instalar. Un usuario que inicia sesión en el cliente web recibe un dispositivo de navegador, y el panel del softphone lo registra.
• Teléfonos de escritorio. Administración > Teléfonos enumera las plantillas de teléfono para los modelos que usa. Asocie cada dispositivo a la extensión del usuario en Administración > Dispositivos, y luego siga las notas de aprovisionamiento de la plantilla.
• Aplicaciones móviles y de escritorio. El cliente web muestra un código QR para un dispositivo. El código es válido durante 10 minutos y funciona una sola vez. La aplicación lo escanea, recibe credenciales nuevas solo para ese dispositivo y las guarda en el llavero del dispositivo. El código QR en sí no contiene ninguna contraseña. Los detalles están en la guía de credenciales SIP.
• Notificaciones push para llamadas entrantes en móvil se configuran en Administración > Teléfonos > Push. Revise ahí el estado de las notificaciones push después de la configuración.

Rotar o revocar un dispositivo termina sus registros de inmediato.

10. Primera llamada de prueba

1. Inicie sesión como usuario de prueba en el teléfono del navegador y llame a otra extensión.
2. Llame a un DID desde un teléfono externo. Confirme la ruta de entrada, las indicaciones del IVR y el timbrado.
3. Revise Administración > Historial para ver las llamadas, y el Registro de auditoría de Administración para los cambios de configuración.
4. Ejecute sudo mpbx-ctl selftest (VM) o scripts/smoke.sh (Compose) cuando la primera troncal esté activa.

Cuando una llamada falla, el probador de reglas y el historial de llamadas muestran el motivo. Los códigos de error están listados en códigos de error.

Disponible en Alpha

• Actualización y reversión de una instalación en ejecución (mpbx upgrade). Mientras no exista, un paquete de otra versión se rechaza a menos que pase --force-bundle.
• Canales de descarga publicados para el instalador de VM. El dominio de descarga del comando de una línea es hoy un marcador de posición.