Коды ошибок голосовой почты (mpbx-voicemail)

Возвращаются маршрутами голосовой почты и телефонным меню (W3-TEL-08). Сообщения никогда не содержат PIN-коды, их хеши, номера звонящих или содержимое сообщения; в них указываются не более чем идентификаторы и имена полей. Коды, описывающие сбой отправки письма (MPBX-VM-EMAIL-*), сохраняются как email_error_code сообщения и не возвращаются. Руководство: Голосовая почта.

Код	Вид	Значение	Что делать
MPBX-VM-MAILBOX-NOT-FOUND	not_found	В этой компании нет такого почтового ящика (почтовый ящик другой компании не виден).	Проверьте идентификатор.
MPBX-VM-MESSAGE-NOT-FOUND	not_found	В этой компании нет такого сообщения либо оно удалено.	Проверьте идентификатор.
MPBX-VM-GREETING-NOT-FOUND	not_found	У почтового ящика нет приветствия такого вида.	Воспроизводится стандартное системное приветствие; запишите или загрузите своё.
MPBX-VM-NO-MAILBOX	not_found	У внутреннего номера нет почтового ящика, поэтому звонящие не могут оставить сообщение.	Создайте почтовый ящик (POST /api/v1/voicemail/mailboxes).
MPBX-VM-EXTENSION-INVALID	invalid_argument	Внутреннего номера нет в этой компании либо он не является пользовательским.	Используйте идентификатор пользовательского внутреннего номера.
MPBX-VM-MAILBOX-EXISTS	conflict	У внутреннего номера уже есть почтовый ящик.	Обновите существующий.
MPBX-VM-MAILBOX-DISABLED	conflict	Почтовый ящик выключен и не принимает сообщения.	Включите его (enabled: true).
MPBX-VM-MAILBOX-FULL	conflict	В почтовом ящике столько сообщений, сколько разрешает max_messages. Сообщение, пришедшее, когда ящик заполнился, было отклонено, а его аудио удалено.	Удалите сообщения или увеличьте max_messages.
MPBX-VM-PIN-NOT-SET	conflict	У почтового ящика ещё нет PIN-кода; его владелец должен сначала задать PIN. PIN по умолчанию не предусмотрен.	Владелец задаёт PIN (PUT /api/v1/voicemail/mailboxes/{id}/pin) или с телефона самого почтового ящика.
MPBX-VM-PIN-WEAK	invalid_argument	Новый PIN не подходит: содержит не только цифры, выходит за пределы длины (по умолчанию от 4 до 10 цифр), повторяет одну цифру, образует последовательность (1234), повторяет блок (1212), совпадает с номером внутреннего номера или является распространённым PIN.	Выберите другой PIN.
MPBX-VM-PIN-WRONG	permission_denied	Указан неверный PIN либо требуется текущий PIN, а он не передан. Каждый неверный PIN учитывается в блокировке.	Введите правильный PIN; если он забыт, попросите администратора сбросить его.
MPBX-VM-PIN-THROTTLED	ограничение частоты (429)	Неверный PIN был введён только что; ничего не проверялось. Ожидание удваивается после каждого неверного PIN (по умолчанию 2, 4, 8, 16 секунд, не более 60). Заголовок Retry-After указывает, сколько ждать.	Подождите и попробуйте снова.
MPBX-VM-MAILBOX-LOCKED	permission_denied	Пять неверных PIN подряд заблокировали почтовый ящик. Даже правильный PIN его не открывает.	Администратор разблокирует его (POST /api/v1/voicemail/mailboxes/{id}/unlock) или сбрасывает PIN.
MPBX-VM-AUDIO-INVALID	invalid_argument	Приветствие не является файлом WAV, который система может воспроизвести (16-битный PCM или G.711 8 кГц, моно или стерео, 8 или 16 кГц), короче 0,3 секунды, длиннее 2 минут или больше 5 МиБ.	Преобразуйте в WAV или запишите в браузере.
MPBX-VM-OBJECT-INVALID	invalid_argument	Аудиообъект, о котором сообщил движок, находится не там, где ожидает этот почтовый ящик (его идентификаторы компании, почтового ящика и сообщения в ключе). Он не регистрируется и не изменяется.	Ошибка или подменённая ссылка; сообщите об этом.
MPBX-VM-SETTINGS-INVALID	invalid_argument	Настройка вне диапазона или имеет неверный формат (retention_days от 1 до 3650, max_messages от 1 до 1000, notify_email должен быть похож на адрес, folder — new, old или saved).	Исправьте указанное поле.
MPBX-VM-CHANGED	conflict	Почтовый ящик изменился между вашим чтением и записью (устаревший If-Match).	Прочитайте его снова и повторите запрос с новым ETag.
MPBX-VM-EMAIL-NOT-CONFIGURED	н/д (email_error_code сообщения)	Пересылка голосовых сообщений на почту включена для почтового ящика, но в установке ещё нет поставщика электронной почты (ADM-UI-008). Письмо записывается со статусом skipped; сообщение остаётся в почтовом ящике.	Настройте поставщика электронной почты; письма о сообщениях, пришедших раньше, позже не отправляются.
MPBX-VM-EMAIL-REJECTED	н/д (email_error_code сообщения)	Поставщик электронной почты окончательно отклонил письмо (неверный адрес, блокировка, вложение слишком большое) либо аудио не удалось прочитать. Не повторяется.	Исправьте адрес в notify_email или в учётной записи владельца.
MPBX-VM-EMAIL-UNAVAILABLE	н/д (email_error_code сообщения)	До поставщика электронной почты не удалось достучаться; все попытки (5, с удвоением задержки начиная с 60 секунд) исчерпаны.	Проверьте поставщика электронной почты; сообщение остаётся в почтовом ящике.
MPBX-VM-EMAIL-NO-ADDRESS	н/д (email_error_code сообщения)	У почтового ящика нет notify_email, а у владельца нет адреса. Письмо получает статус skipped.	Укажите notify_email.
MPBX-VM-SHARED-EXTENSION-INVALID	invalid_argument	Общий почтовый ящик привязан к очереди, группе вызова или другому не пользовательскому внутреннему номеру этой компании; внутреннего номера нет либо он пользовательский.	Используйте идентификатор внутреннего номера очереди или группы вызова (личный почтовый ящик пользователя не бывает общим).
MPBX-VM-NOT-SHARED	invalid_argument	Участники и захваты существуют только у общих почтовых ящиков.	Используйте общий почтовый ящик.
MPBX-VM-NOT-MEMBER	permission_denied	Вызывающий не является участником общего почтового ящика. Открывают его только участники; voicemail:read и extensions:write этого не дают.	Попросите администратора добавить вас участником.
MPBX-VM-MEMBER-NOT-FOUND	not_found	Пользователь не является участником почтового ящика.	Сначала запросите список участников.
MPBX-VM-MEMBER-USER-INVALID	invalid_argument	Пользователя, которого нужно добавить, нет в этой компании.	Используйте идентификатор пользователя этой компании.
MPBX-VM-MEMBER-ROLE-INVALID	invalid_argument	Роль не member и не supervisor либо почтовый ящик принадлежит очереди, все участники которой — супервайзеры.	Для почтового ящика очереди используйте supervisor.
MPBX-VM-ALREADY-CLAIMED	conflict	Сообщение удерживает другой участник. Ответ не содержит сведений о том, кто это; их даёт список сообщений.	Попросите владельца захвата или супервайзера освободить сообщение.
MPBX-VM-NOT-CLAIMED	conflict	Освобождать нечего: сообщение никем не удерживается либо обычный участник пытается освободить захват другого участника.	Перезагрузите список; супервайзер может снять захват.
MPBX-VM-PROMPT-MISSING	unavailable	Системное голосовое сообщение пакета языка голосовой почты (prompts/{locale}/vm-*.wav в хранилище установки) не установлено, поэтому телефонное меню или приветствие не могут быть воспроизведены.	Установите пакет голосовых сообщений для языка (docs/guides/voicemail.md, раздел «Prompts»).