Códigos de error de la bandeja omnicanal (mpbx-channels)

Se generan en las rutas de la bandeja y en el webhook de los proveedores (W10-OMNI-01, W10-OMNI-05). Los mensajes nunca contienen el texto de los mensajes, nombres de contactos ni credenciales; como máximo indican ids y nombres de campos. Un id de otra empresa recibe exactamente la misma respuesta que uno que no existe. Guía: Bandeja omnicanal.

Código	Tipo	Significado	Qué hacer
MPBX-INBOX-CHANNEL-NOT-FOUND	not_found	No hay un canal con este id en su empresa.	Revise el id.
MPBX-INBOX-CONVERSATION-NOT-FOUND	not_found	No hay una conversación con este id en su empresa.	Revise el id.
MPBX-INBOX-KIND-UNSUPPORTED	invalid_argument	La instalación todavía no tiene un conector para este tipo de canal.	Use uno de available_kinds de GET /inbox/channels.
MPBX-INBOX-INVALID	invalid_argument	Un campo está vacío, es demasiado largo, tiene caracteres de control, o un cursor o una marca de tiempo está mal formado.	Corrija el campo indicado. Un mensaje admite hasta 4096 caracteres, un nombre de canal hasta 80.
MPBX-INBOX-CREDENTIALS-INVALID	invalid_argument	Las credenciales no tienen la forma que necesita el canal (Telegram: {"bot_token": "<id del bot>:<secreto>"} y nada más).	Pegue el token exactamente como lo muestra @BotFather.
MPBX-INBOX-CREDENTIALS-REJECTED	invalid_argument	El proveedor rechazó las credenciales (Telegram getMe respondió 401/404, o el token no es de un bot).	Cree un token nuevo con @BotFather (/token).
MPBX-INBOX-CREDENTIALS-UNREADABLE	config	No se pueden abrir las credenciales guardadas (clave maestra incorrecta o un registro dañado).	Vuelva a conectar el canal con credenciales nuevas.
MPBX-INBOX-CHANNEL-NAME-TAKEN	conflict	Otro canal de su empresa tiene este nombre (sin distinguir mayúsculas).	Elija otro nombre.
MPBX-INBOX-CHANNEL-IN-USE	conflict	El canal todavía tiene conversaciones.	Desactívelo en su lugar.
MPBX-INBOX-ROUTE-INVALID	invalid_argument	La ruta está mal formada (un destino sin tipo o al revés), una transferencia no tiene destino, o el destino no existe en su empresa.	Indique una cola, grupo de timbrado, extensión o usuario activo existente.
MPBX-INBOX-ALREADY-TAKEN	conflict	Otro agente tiene la conversación.	Pídale que la transfiera, o haga que se le asigne a usted.
MPBX-INBOX-CONVERSATION-ARCHIVED	conflict	La conversación está archivada; ya nada la cambia.	El siguiente mensaje del contacto abre una conversación nueva.
MPBX-INBOX-USER-UNKNOWN	invalid_argument	El responsable no es un usuario activo de su empresa.	Revise el id del usuario.
MPBX-INBOX-NOT-A-USER	permission_denied	Tomar una conversación y responder requieren un usuario que inició sesión; una clave de API no tiene un puesto en la bandeja.	Inicie sesión como usuario.
MPBX-INBOX-VERSION-MISMATCH	conflict	La conversación cambió desde que la leyó (If-Match).	Vuelva a leerla y reintente.
MPBX-INBOX-WEBHOOK-NOT-FOUND	not_found	No hay un canal habilitado de este tipo en esta dirección de webhook.	Copie webhook_path del canal, o registre el webhook de nuevo.
MPBX-INBOX-WEBHOOK-UNAUTHORIZED	unauthenticated	La llamada al webhook no llevó el token secreto del canal.	Registre el webhook de nuevo (POST /inbox/channels/{id}/webhook).
MPBX-INBOX-WEBHOOK-PAYLOAD-INVALID	invalid_argument	El cuerpo del webhook no es lo que envía el proveedor.	Nada; el proveedor reintenta las actualizaciones válidas.
MPBX-INBOX-PROVIDER-FAILED	invalid_argument	El proveedor rechazó un mensaje saliente o el registro de un webhook (por ejemplo, el contacto bloqueó al bot).	Revise el error_code del mensaje; es posible que el contacto tenga que escribir primero.
MPBX-INBOX-PROVIDER-UNAVAILABLE	unavailable	No se pudo contactar al proveedor, o limitó la llamada por exceso de solicitudes.	Reintente más tarde.
MPBX-INBOX-PUBLIC-URL-MISSING	config	La instalación no tiene una dirección https pública ([setup] fqdn o http.base_domain), así que los proveedores no pueden llegar a sus webhooks.	Defina la dirección y haga que sea accesible por HTTPS desde internet.
MPBX-INBOX-TEMPLATE-NOT-FOUND	not_found	No hay una plantilla de respuesta ni una respuesta rápida con este id en su empresa.	Revise el id.
MPBX-INBOX-TEMPLATE-SHORTCUT-TAKEN	conflict	Otra plantilla o respuesta rápida del mismo tipo tiene este atajo.	Elija otro atajo.
MPBX-INBOX-WINDOW-CLOSED	conflict	No se permite texto libre en este momento: el último mensaje del contacto es más antiguo que la ventana de respuesta del canal (WhatsApp y Messenger 24 horas; Messenger hasta 7 días con la etiqueta de agente humano). No se guardó ni se envió nada.	WhatsApp: envíe una plantilla aprobada ({"template": {...}}). De lo contrario, espere a que el contacto escriba. Vea meta-byok-setup.md.
MPBX-INBOX-TEMPLATES-UNSUPPORTED	invalid_argument	El canal no envía mensajes de plantilla (solo WhatsApp lo hace).	Responda con texto.
MPBX-INBOX-WEBHOOK-MANUAL	conflict	MonoPbx no puede registrar el webhook de un canal de WhatsApp o Messenger porque las credenciales no tienen app_id.	Configure la URL de devolución de llamada y el token de verificación en el panel de la aplicación de Meta, o conecte el canal de nuevo con app_id.
MPBX-INBOX-WIDGET-INVALID	invalid_argument	Una configuración del widget de chat en vivo o un campo del visitante no es aceptable (color que no es #rrggbb, un origen que no es https://host[:puerto], una dirección que no es IPv4 ni IPv6, un correo que no es válido, un texto demasiado largo, un cuerpo que no es JSON).	Corrija el campo indicado en el detalle.
MPBX-INBOX-WIDGET-FIELD-REQUIRED	invalid_argument	Se dejó vacío un campo previo al chat que el widget exige, o un mensaje fuera de horario llegó sin correo ni número de teléfono para responder.	Pida al visitante el campo.
MPBX-INBOX-WIDGET-ORIGIN-NOT-ALLOWED	permission_denied (403)	La página que incrusta el widget no está en los allowed_origins del canal (o no envió Origin). La respuesta no lleva encabezados CORS, así que los navegadores la bloquean.	Agregue el origen del sitio (https://www.example.com) en Chat en vivo > Sitios permitidos.
MPBX-INBOX-WIDGET-BANNED	permission_denied (403)	La dirección del visitante está en la lista de bloqueados del widget.	Quítela de Chat en vivo > Direcciones bloqueadas si se agregó por error.
MPBX-INBOX-WIDGET-NOT-LIVE-CHAT	invalid_argument	Se pidió la configuración del widget para un canal que no es de tipo live_chat.	Use el id de un canal de chat en vivo.