Códigos de error de buzón de voz (mpbx-voicemail)

Los generan las rutas de buzón de voz y el menú telefónico (W3-TEL-08). Los mensajes nunca contienen PIN, hashes de PIN, números de quien llama ni el contenido de un mensaje; como máximo nombran ids y nombres de campos. Los códigos que describen una falla de correo (MPBX-VM-EMAIL-*) se guardan como email_error_code del mensaje en lugar de devolverse. Guía: Buzón de voz.

Código	Tipo	Significado	Qué hacer
MPBX-VM-MAILBOX-NOT-FOUND	not_found	No existe ese buzón en esta empresa (el buzón de otra empresa es invisible).	Revise el id.
MPBX-VM-MESSAGE-NOT-FOUND	not_found	No existe ese mensaje en esta empresa, o fue eliminado.	Revise el id.
MPBX-VM-GREETING-NOT-FOUND	not_found	El buzón no tiene un saludo de ese tipo.	Se reproduce el saludo estándar del sistema; grabe o suba uno.
MPBX-VM-NO-MAILBOX	not_found	La extensión no tiene buzón, así que quienes llaman no pueden dejar un mensaje.	Cree el buzón (POST /api/v1/voicemail/mailboxes).
MPBX-VM-EXTENSION-INVALID	invalid_argument	La extensión no existe en esta empresa o no es una extensión de usuario.	Use el id de una extensión de usuario.
MPBX-VM-MAILBOX-EXISTS	conflict	La extensión ya tiene un buzón.	Actualice el existente.
MPBX-VM-MAILBOX-DISABLED	conflict	El buzón está apagado y no recibe mensajes.	Enciéndalo (enabled: true).
MPBX-VM-MAILBOX-FULL	conflict	El buzón tiene tantos mensajes como permite max_messages. Un mensaje que llegó mientras el buzón se llenaba fue rechazado y su audio se eliminó.	Elimine mensajes o aumente max_messages.
MPBX-VM-PIN-NOT-SET	conflict	El buzón todavía no tiene PIN; su dueño debe definir uno primero. No hay PIN predeterminado.	El dueño define un PIN (PUT /api/v1/voicemail/mailboxes/{id}/pin) o desde el teléfono del propio buzón.
MPBX-VM-PIN-WEAK	invalid_argument	El nuevo PIN no es aceptable: no son dígitos, está fuera de los límites de longitud (4 a 10 dígitos por defecto), un dígito repetido, una secuencia (1234), un bloque repetido (1212), el número de la extensión o un PIN común.	Elija otro PIN.
MPBX-VM-PIN-WRONG	permission_denied	El PIN indicado es incorrecto, o se requiere el PIN actual y no se envió. Cada PIN incorrecto cuenta hacia el bloqueo.	Envíe el PIN correcto; si lo olvidó, pida a un administrador un restablecimiento.
MPBX-VM-PIN-THROTTLED	rate limited (429)	Se ingresó un PIN incorrecto hace un momento; no se verificó nada. La espera se duplica con cada PIN incorrecto (2, 4, 8, 16 segundos por defecto, como máximo 60). El encabezado Retry-After indica cuánto.	Espere y vuelva a intentarlo.
MPBX-VM-MAILBOX-LOCKED	permission_denied	Cinco PIN incorrectos seguidos bloquearon el buzón. Ni siquiera el PIN correcto lo abre.	Un administrador lo desbloquea (POST /api/v1/voicemail/mailboxes/{id}/unlock) o restablece el PIN.
MPBX-VM-AUDIO-INVALID	invalid_argument	El saludo no es un archivo WAV que el sistema pueda reproducir (PCM de 16 bits o G.711 de 8 kHz, mono o estéreo, de 8 o 16 kHz), dura menos de 0.3 segundos, más de 2 minutos, o pesa más de 5 MiB.	Convierta a WAV, o grabe en el navegador.
MPBX-VM-OBJECT-INVALID	invalid_argument	El objeto de audio que reportó el motor no está donde espera este buzón (su empresa, buzón y ids de mensaje en la clave). No se registra ni se toca.	Un error o una referencia alterada; repórtelo.
MPBX-VM-SETTINGS-INVALID	invalid_argument	Una configuración está fuera de rango o mal formada (retention_days de 1 a 3650, max_messages de 1 a 1000, notify_email debe parecer una dirección, folder es new, old o saved).	Corrija el campo indicado.
MPBX-VM-CHANGED	conflict	El buzón cambió entre su lectura y su escritura (If-Match desactualizado).	Léalo de nuevo e intente otra vez con el nuevo ETag.
MPBX-VM-EMAIL-NOT-CONFIGURED	n/a (email_error_code del mensaje)	El buzón a correo está activado, pero la instalación todavía no tiene proveedor de correo (ADM-UI-008). El correo se registra como skipped; el mensaje permanece en el buzón.	Configure el proveedor de correo; los correos de mensajes llegados antes no se envían después.
MPBX-VM-EMAIL-REJECTED	n/a (email_error_code del mensaje)	El proveedor de correo rechazó el correo de forma definitiva (dirección incorrecta, bloqueado, adjunto demasiado grande), o no se pudo leer el audio. No se reintenta.	Corrija la dirección en notify_email o en la cuenta del dueño.
MPBX-VM-EMAIL-UNAVAILABLE	n/a (email_error_code del mensaje)	No se pudo contactar al proveedor de correo; se agotaron todos los intentos (5, con esperas que se duplican desde 60 segundos).	Revise el proveedor de correo; el mensaje permanece en el buzón.
MPBX-VM-EMAIL-NO-ADDRESS	n/a (email_error_code del mensaje)	El buzón no tiene notify_email y su dueño no tiene dirección. El correo queda como skipped.	Defina notify_email.
MPBX-VM-SHARED-EXTENSION-INVALID	invalid_argument	Un buzón compartido está en una cola, grupo de timbrado u otra extensión que no es de usuario de esta empresa; la extensión no existe o es una extensión de usuario.	Use el id de una extensión de cola o de grupo de timbrado (el buzón propio de un usuario no es compartido).
MPBX-VM-NOT-SHARED	invalid_argument	Los miembros y las reclamaciones solo existen en buzones compartidos.	Use un buzón compartido.
MPBX-VM-NOT-MEMBER	permission_denied	Quien llama no es miembro del buzón compartido. Solo los miembros lo abren; voicemail:read y extensions:write no bastan.	Pida a un administrador que lo agregue como miembro.
MPBX-VM-MEMBER-NOT-FOUND	not_found	El usuario no es miembro del buzón.	Primero liste los miembros.
MPBX-VM-MEMBER-USER-INVALID	invalid_argument	El usuario que se va a agregar no existe en esta empresa.	Use el id de un usuario de esta empresa.
MPBX-VM-MEMBER-ROLE-INVALID	invalid_argument	El rol no es member ni supervisor, o el buzón es de una cola, cuyos miembros son todos supervisores.	Use supervisor para el buzón de una cola.
MPBX-VM-ALREADY-CLAIMED	conflict	Otro miembro tiene el mensaje. La respuesta no indica quién; la lista de mensajes sí.	Pida al poseedor o a un supervisor que lo libere.
MPBX-VM-NOT-CLAIMED	conflict	No hay nada que liberar: nadie tiene el mensaje, o un miembro común intentó liberar la reclamación de otro miembro.	Recargue la lista; un supervisor puede quitar una reclamación.
MPBX-VM-PROMPT-MISSING	unavailable	Falta un aviso del sistema del paquete de idioma del buzón de voz (prompts/{locale}/vm-*.wav en el almacén de toda la instalación), así que no se puede reproducir el menú telefónico ni el saludo.	Instale el paquete de avisos del buzón de voz para el idioma (docs/guides/voicemail.md, "Prompts").