Коды ошибок омниканальных входящих (mpbx-channels)

Возникают в маршрутах входящих и в вебхуке провайдера (W10-OMNI-01, W10-OMNI-05). Сообщения никогда не содержат текст сообщений, имена контактов или учётные данные; в лучшем случае они называют идентификаторы и имена полей. Идентификатор другой компании обрабатывается так же, как несуществующий. Руководство: Омниканальные входящие.

Код	Вид	Значение	Что делать
MPBX-INBOX-CHANNEL-NOT-FOUND	not_found	В вашей компании нет канала с таким идентификатором.	Проверьте идентификатор.
MPBX-INBOX-CONVERSATION-NOT-FOUND	not_found	В вашей компании нет беседы с таким идентификатором.	Проверьте идентификатор.
MPBX-INBOX-KIND-UNSUPPORTED	invalid_argument	В этой установке пока нет коннектора для этого вида канала.	Используйте одно из значений available_kinds из GET /inbox/channels.
MPBX-INBOX-INVALID	invalid_argument	Поле пустое, слишком длинное, содержит управляющие символы, либо курсор или отметка времени некорректны.	Исправьте названное поле. Сообщение содержит до 4096 символов, название канала — до 80.
MPBX-INBOX-CREDENTIALS-INVALID	invalid_argument	Учётные данные не имеют вида, который нужен каналу (Telegram: {"bot_token": "<bot id>:<secret>"} и ничего больше).	Вставьте токен точно таким, каким его показывает @BotFather.
MPBX-INBOX-CREDENTIALS-REJECTED	invalid_argument	Провайдер отклонил учётные данные (Telegram getMe ответил 401/404, либо токен не принадлежит боту).	Создайте новый токен у @BotFather (/token).
MPBX-INBOX-CREDENTIALS-UNREADABLE	config	Сохранённые учётные данные нельзя открыть (неверный главный ключ или повреждённая строка).	Переподключите канал с новыми учётными данными.
MPBX-INBOX-CHANNEL-NAME-TAKEN	conflict	Другой канал вашей компании имеет такое название (без учёта регистра).	Выберите другое название.
MPBX-INBOX-CHANNEL-IN-USE	conflict	В канале ещё есть беседы.	Вместо удаления отключите канал.
MPBX-INBOX-ROUTE-INVALID	invalid_argument	Маршрут некорректен (цель без вида или вид без цели), у перевода нет цели, либо цель не существует в вашей компании.	Укажите существующую очередь, группу вызова, внутренний номер или активного пользователя.
MPBX-INBOX-ALREADY-TAKEN	conflict	Беседу уже взял другой агент.	Попросите его передать беседу или назначьте её себе.
MPBX-INBOX-CONVERSATION-ARCHIVED	conflict	Беседа в архиве; ничего в ней больше не меняется.	Следующее сообщение контакта откроет новую беседу.
MPBX-INBOX-USER-UNKNOWN	invalid_argument	Исполнитель не является активным пользователем вашей компании.	Проверьте идентификатор пользователя.
MPBX-INBOX-NOT-A-USER	permission_denied	Для взятия беседы и ответа нужен вход пользователя; у ключа API нет места во входящих.	Войдите как пользователь.
MPBX-INBOX-VERSION-MISMATCH	conflict	Беседа изменилась после вашего чтения (If-Match).	Прочитайте беседу заново и повторите попытку.
MPBX-INBOX-WEBHOOK-NOT-FOUND	not_found	Нет включённого канала такого вида по этому адресу вебхука.	Скопируйте webhook_path из канала или зарегистрируйте вебхук заново.
MPBX-INBOX-WEBHOOK-UNAUTHORIZED	unauthenticated	Запрос вебхука не содержал секретного токена канала.	Зарегистрируйте вебхук заново (POST /inbox/channels/{id}/webhook).
MPBX-INBOX-WEBHOOK-PAYLOAD-INVALID	invalid_argument	Тело вебхука не соответствует тому, что отправляет провайдер.	Ничего делать не нужно; провайдер повторяет корректные обновления.
MPBX-INBOX-PROVIDER-FAILED	invalid_argument	Провайдер отклонил исходящее сообщение или регистрацию вебхука (например, контакт заблокировал бота).	См. error_code в сообщении; возможно, первым должен написать контакт.
MPBX-INBOX-PROVIDER-UNAVAILABLE	unavailable	Провайдер не был доступен или ограничил частоту запросов.	Повторите попытку позже.
MPBX-INBOX-PUBLIC-URL-MISSING	config	У установки нет публичного адреса https ([setup] fqdn или http.base_domain), поэтому провайдеры не могут обращаться к её вебхукам.	Укажите адрес и сделайте его доступным по HTTPS из интернета.
MPBX-INBOX-TEMPLATE-NOT-FOUND	not_found	В вашей компании нет шаблона ответа или быстрого ответа с таким идентификатором.	Проверьте идентификатор.
MPBX-INBOX-TEMPLATE-SHORTCUT-TAKEN	conflict	Другой шаблон или быстрый ответ того же вида уже использует этот сокращённый вызов.	Выберите другое сокращение.
MPBX-INBOX-WINDOW-CLOSED	conflict	Свободный текст сейчас не разрешён: последнее сообщение контакта старше окна ответа канала (WhatsApp и Messenger — 24 часа; Messenger — до 7 дней с тегом human-agent). Ничего не сохранено и не отправлено.	WhatsApp: отправьте утверждённый шаблон ({"template": {...}}). В остальных случаях дождитесь сообщения от контакта. См. meta-byok-setup.md.
MPBX-INBOX-TEMPLATES-UNSUPPORTED	invalid_argument	Канал не отправляет шаблонные сообщения (это умеет только WhatsApp).	Отвечайте текстом.
MPBX-INBOX-WEBHOOK-MANUAL	conflict	Вебхук канала WhatsApp или Messenger не может зарегистрировать MonoPbx, потому что в учётных данных нет app_id.	Укажите URL обратного вызова и токен проверки в панели приложения Meta либо подключите канал заново с app_id.
MPBX-INBOX-WIDGET-INVALID	invalid_argument	Настройка виджета чата или поле посетителя неприемлемы (цвет не #rrggbb, источник не https://host[:port], адрес не IPv4 или IPv6, адрес электронной почты некорректен, текст слишком длинный, тело не JSON).	Исправьте поле, названное в описании.
MPBX-INBOX-WIDGET-FIELD-REQUIRED	invalid_argument	Обязательное поле до начала чата осталось пустым, либо офлайн-сообщение пришло без адреса электронной почты или телефона для ответа.	Запросите у посетителя это поле.
MPBX-INBOX-WIDGET-ORIGIN-NOT-ALLOWED	permission_denied (403)	Страница, которая встраивает виджет, отсутствует в allowed_origins канала (или не передала Origin). Ответ не содержит заголовков CORS, поэтому браузеры его блокируют.	Добавьте источник сайта (https://www.example.com) в разделе Чат на сайте > Разрешённые сайты.
MPBX-INBOX-WIDGET-BANNED	permission_denied (403)	Адрес посетителя находится в списке заблокированных адресов виджета.	Если адрес добавлен по ошибке, удалите его в разделе Чат на сайте > Заблокированные адреса посетителей.
MPBX-INBOX-WIDGET-NOT-LIVE-CHAT	invalid_argument	Настройки виджета запрошены для канала, который не является каналом live_chat.	Используйте идентификатор канала чата на сайте.