AiHummer
Español▾
Iniciar sesiónCuenta
v1.6.x▾
{ }Swagger

Códigos de error

v1.6.x · actualizada 2026-11-15

Cada error de la API de AiHummer lleva un código de máquina estable en la forma AIH-<DOMAIN>-<NNNN>. La forma del alambre es:

{ "error": { "code": "AIH-AUTH-0001",
             "message": "invalid login or password",
             "message_key": "err.auth.invalid_credentials",
             "details": { } } }

code es estable (nunca reutilizado ni renumerado); message es una cadena humana en inglés; message_key es la clave i18n que los clientes usan para localizar; details es un contexto estructurado opcional.

Los errores de facturación / derechos del plan (la superficie 402 “actualización requerida”) son no enumerado aquí — ver Licencias y facturación.

COMÚN

Errores transversales compartidos por todos los servicios (forma de la solicitud, método, autenticación, fallos internos). Se prefiere un código específico del dominio cuando se ajusta uno.

Código HTTP Significado clave i18n Causa típica
AIH-COMMON-0001 405 Método no permitido err.common.method_not_allowed El método HTTP no está permitido para esta ruta.
AIH-COMMON-0002 400 Cuerpo de solicitud no válido err.common.invalid_body Entrada de solicitud malformada, incompleta o inválida.
AIH-COMMON-0003 400 Falta un campo obligatorio err.common.missing_field Entrada de solicitud malformada, incompleta o inválida.
AIH-COMMON-0004 500 Error interno err.common.internal Un fallo interno inesperado.
AIH-COMMON-0005 404 No encontrado err.common.not_found El objeto referenciado no existe o está fuera de alcance.
AIH-COMMON-0006 403 prohibida err.common.forbidden El recurso pertenece a otro inquilino/propietario/sesión.
AIH-COMMON-0007 501 Función no habilitada err.common.not_enabled La función/integración está desactivada o no configurada.
AIH-COMMON-0008 401 No autorizado err.common.unauthorized Credenciales faltantes o inválidas.
AIH-COMMON-0009 400 Validación fallida err.common.validation Entrada de solicitud malformada, incompleta o inválida.
AIH-COMMON-0010 409 Conflicto err.common.conflict Conflictos con el estado actual.
AIH-COMMON-0011 429 Límite de velocidad excedido err.common.rate_limited Demasiadas solicitudes / sobre el presupuesto configurado.
AIH-COMMON-0012 502 Error ascendente err.common.upstream Una llamada al proveedor/ascendente falló.

AUT

Admin autenticación local: inicio de sesión, sesiones, cambio de contraseña, gestión de usuarios, 2FA.

Código HTTP Significado clave i18n Causa típica
AIH-AUTH-0001 401 Inicio de sesión o contraseña no válidos err.auth.invalid_credentials Credenciales faltantes o inválidas.
AIH-AUTH-0002 429 Demasiados intentos, inténtalo de nuevo más tarde err.auth.too_many_attempts Demasiadas solicitudes / sobre el presupuesto configurado.
AIH-AUTH-0003 401 No autenticado err.auth.not_authenticated Credenciales faltantes o inválidas.
AIH-AUTH-0004 501 Autenticación local no habilitada err.auth.local_disabled La función/integración está desactivada o no configurada.
AIH-AUTH-0005 403 La contraseña actual es incorrecta err.auth.wrong_current_password El recurso pertenece a otro inquilino/propietario/sesión.
AIH-AUTH-0006 409 No puedes eliminar tu propia cuenta err.auth.cannot_delete_self Conflictos con el estado actual.
AIH-AUTH-0007 500 No se pudo crear la sesión err.auth.session_failed Un fallo interno inesperado.
AIH-AUTH-0008 501 Autenticación de dos factores no habilitada err.auth.twofa_disabled La función/integración está desactivada o no configurada.
AIH-AUTH-0009 401 El desafío ha expirado — inicia sesión de nuevo err.auth.twofa_challenge_expired Credenciales faltantes o inválidas.
AIH-AUTH-0010 401 Código inválido err.auth.twofa_invalid_code Credenciales faltantes o inválidas.
AIH-AUTH-0011 401 Código de recuperación no válido err.auth.twofa_invalid_recovery Credenciales faltantes o inválidas.
AIH-AUTH-0012 401 La verificación de segundo factor falló err.auth.twofa_verify_failed Credenciales faltantes o inválidas.
AIH-AUTH-0013 400 No hay un segundo factor registrado que coincida err.auth.twofa_not_enrolled Entrada de solicitud malformada, incompleta o inválida.
AIH-AUTH-0014 400 Token de restablecimiento inválido o expirado err.auth.reset_token_invalid Entrada de solicitud malformada, incompleta o inválida.
AIH-AUTH-0015 403 Primero establezca su propia contraseña err.auth.password_change_required —
AIH-AUTH-0016 400 La nueva contraseña debe ser distinta de la actual err.auth.password_unchanged —

AGENTE

CRUD de empleado IA (agente), versiones, clon y el perfil de sistema por agente.

Código HTTP Significado clave i18n Causa típica
AIH-AGENT-0001 501 Agentes no habilitados err.agent.not_enabled La función/integración está desactivada o no configurada.
AIH-AGENT-0002 404 Agente no encontrado err.agent.not_found El objeto referenciado no existe o está fuera de alcance.
AIH-AGENT-0003 403 No tu agente err.agent.forbidden El recurso pertenece a otro inquilino/propietario/sesión.
AIH-AGENT-0004 501 Perfiles de agentes no habilitados err.agent.profile_not_enabled La función/integración está desactivada o no configurada.
AIH-AGENT-0005 404 Sección compartida no encontrada err.agent.section_not_found El objeto referenciado no existe o está fuera de alcance.
AIH-AGENT-0006 403 No es tu sección compartida err.agent.section_forbidden El recurso pertenece a otro inquilino/propietario/sesión.
AIH-AGENT-0007 400 Tipo de sección desconocido err.agent.unknown_section_kind Entrada de solicitud malformada, incompleta o inválida.
AIH-AGENT-0008 403 Herramienta no permitida para este agente err.agent.tool_not_permitted El recurso pertenece a otro inquilino/propietario/sesión.
AIH-AGENT-0009 403 Límite de profundidad del subagente alcanzado err.agent.subagent_depth_exceeded El recurso pertenece a otro inquilino/propietario/sesión.
AIH-AGENT-0010 403 Transferencia no disponible aquí err.agent.handoff_unavailable El recurso pertenece a otro inquilino/propietario/sesión.
AIH-AGENT-0011 500 Llamada a la herramienta fallida err.agent.tool_failed Un fallo interno inesperado.
AIH-AGENT-0012 400 La transferencia requiere ‘agente’ y ‘tarea’ err.agent.handoff_invalid_args Entrada de solicitud malformada, incompleta o inválida.
AIH-AGENT-0013 404 No hay ningún agente con ese nombre err.agent.handoff_target_not_found El objeto referenciado no existe o está fuera de alcance.
AIH-AGENT-0014 400 No se proporcionaron tareas err.agent.subagent_no_tasks Entrada de solicitud malformada, incompleta o inválida.
AIH-AGENT-0015 403 Herramienta no disponible en esta instancia administrada de AiHummer Cloud err.agent.tool_cloud_restricted —
AIH-AGENT-0016 409 Este empleado de IA se modificó en otro lugar después de que abrieras la ficha. Vuelve a abrir la ficha y guarda de nuevo. err.agent.revision_conflict —
AIH-AGENT-0017 400 Ningún proveedor de modelos activo ofrece este modelo. Elige uno de la lista o activa su proveedor en la página Modelos. err.agent.model_not_served —
AIH-AGENT-0018 400 Las reglas de acceso mencionan a una persona o un agente que no existe en este espacio de trabajo. err.agent.interaction_unknown_grant —
AIH-AGENT-0019 400 Las prohibiciones para subagentes nombran una herramienta que esta instancia no tiene. err.agent.interaction_unknown_tool —
AIH-AGENT-0020 400 El proveedor elegido está desactivado, eliminado o no ofrece este modelo. Elige otro proveedor o «Cualquier proveedor». err.agent.model_provider_invalid —
AIH-AGENT-0021 400 Un agente puede tener como máximo 8 modelos de respaldo propios. Quita uno antes de añadir otro. err.agent.too_many_spares —

CLAVEAPI

Claves API para el acceso programático a la pasarela: el subsistema de claves no está configurado.

Código HTTP Significado clave i18n Causa típica
AIH-APIKEY-0001 501 Claves de API no configuradas err.apikey.not_configured La función/integración está desactivada o no configurada.

APROBACIÓN

Cola de aprobación con intervención humana: la función de aprobación está desactivada.

Código HTTP Significado clave i18n Causa típica
AIH-APPROVAL-0001 501 Aprobaciones no habilitadas err.approval.not_enabled La función/integración está desactivada o no configurada.
AIH-APPROVAL-0002 409 La solicitud ha caducado: nadie decidió a tiempo, así que la llamada ya fue rechazada. El agente volverá a pedirlo si todavía lo necesita. err.approval.expired —

ARTEFACTO

Artefactos de conversación (documentos + código ejecutable): ejecución de código desactivada, artefacto/versión faltante, tipo incorrecto o salida del ejecutor incorrecta.

Código HTTP Significado clave i18n Causa típica
AIH-ARTIFACT-0001 501 Ejecución de código no habilitada err.artifact.exec_disabled La función/integración está desactivada o no configurada.
AIH-ARTIFACT-0002 404 Artefacto no encontrado err.artifact.not_found El objeto referenciado no existe o está fuera de alcance.
AIH-ARTIFACT-0003 404 Versión del artefacto no encontrada err.artifact.version_not_found El objeto referenciado no existe o está fuera de alcance.
AIH-ARTIFACT-0004 400 El artefacto no es código err.artifact.not_code Entrada de solicitud malformada, incompleta o inválida.
AIH-ARTIFACT-0005 500 Salida de corredor deficiente err.artifact.bad_runner_output Un fallo interno inesperado.
AIH-ARTIFACT-0006 400 El tipo debe ser documento o código err.artifact.invalid_kind Entrada de solicitud malformada, incompleta o inválida.

COPIA DE SEGURIDAD

Copia de seguridad de la base de datos desde la superficie de administración.

Código HTTP Significado clave i18n Causa típica
AIH-BACKUP-0001 501 URL de la base de datos no configurada para la copia de seguridad err.backup.not_configured La función/integración está desactivada o no configurada.
AIH-BACKUP-0002 500 Copia de seguridad fallida err.backup.failed Un fallo interno inesperado.

LOTE

Procesamiento de solicitudes por lote.

Código HTTP Significado clave i18n Causa típica
AIH-BATCH-0001 501 Lotes no habilitados err.batch.not_enabled La función/integración está desactivada o no configurada.
AIH-BATCH-0002 404 Lote no encontrado err.batch.not_found El objeto referenciado no existe o está fuera de alcance.

PRESUPUESTO

Medición de uso y presupuestos de gasto por modelo.

Código HTTP Significado clave i18n Causa típica
AIH-BUDGET-0001 501 Medición de uso no habilitada err.budget.usage_not_enabled La función/integración está desactivada o no configurada.
AIH-BUDGET-0002 501 Presupuestos no habilitados err.budget.not_enabled La función/integración está desactivada o no configurada.

Trae tu propia clave

Traiga su propia clave: claves del proveedor de modelos proporcionadas por el inquilino.

Código HTTP Significado clave i18n Causa típica
AIH-BYOK-0001 501 BYOK no configurado err.byok.not_configured La función/integración está desactivada o no configurada.

CAMBIAR

Registros de cambios y el flujo de trabajo de aprobación de cambios.

Código HTTP Significado clave i18n Causa típica
AIH-CHANGE-0001 404 Cambio no encontrado err.change.not_found El objeto referenciado no existe o está fuera de alcance.
AIH-CHANGE-0002 403 Aprobación propia no permitida: se requiere un aprobador diferente err.change.self_approval_forbidden El recurso pertenece a otro inquilino/propietario/sesión.

CHAT

Punto de conexión de chat-completions compatible con OpenAI. La forma del cable se mantiene compatible con OpenAI mientras se agrega un código estable.

Código HTTP Significado clave i18n Causa típica
AIH-CHAT-0001 501 Punto de enlace compatible con OpenAI deshabilitado err.chat.disabled La función/integración está desactivada o no configurada.
AIH-CHAT-0002 401 Clave de API no válida err.chat.invalid_key Credenciales faltantes o inválidas.
AIH-CHAT-0003 400 Solicitud de chat no válida err.chat.invalid_request Entrada de solicitud malformada, incompleta o inválida.
AIH-CHAT-0004 429 Límite de tarifa o presupuesto excedido err.chat.rate_limited Demasiadas solicitudes / sobre el presupuesto configurado.
AIH-CHAT-0005 502 Fallo en el turno del chat err.chat.turn_failed Una llamada al proveedor/ascendente falló.
AIH-CHAT-0006 500 La finalización del chat falló err.chat.internal Un fallo interno inesperado.
AIH-CHAT-0007 503 Aún no hay ningún proveedor de modelo de IA configurado; agregue uno en la sección Modelos err.chat.no_llm_provider —

CONEXIÓN

Integración de conexiones OAuth: conectar tickets, pasos de autorización e intercambio de tokens.

Código HTTP Significado clave i18n Causa típica
AIH-CONNECTION-0001 400 Boleto de conexión inválido o vencido err.connection.ticket_invalid Entrada de solicitud malformada, incompleta o inválida.
AIH-CONNECTION-0002 400 El complemento no declara un flujo de OAuth err.connection.no_oauth_flow Entrada de solicitud malformada, incompleta o inválida.
AIH-CONNECTION-0003 400 Cliente OAuth no configurado para este complemento err.connection.oauth_client_not_configured Entrada de solicitud malformada, incompleta o inválida.
AIH-CONNECTION-0004 400 Autorización denegada err.connection.auth_denied Entrada de solicitud malformada, incompleta o inválida.
AIH-CONNECTION-0005 400 Código o estado faltante err.connection.missing_code_or_state Entrada de solicitud malformada, incompleta o inválida.
AIH-CONNECTION-0006 400 Estado inválido o expirado err.connection.state_invalid Entrada de solicitud malformada, incompleta o inválida.
AIH-CONNECTION-0007 400 Configuración de OAuth del complemento no disponible err.connection.oauth_config_unavailable Entrada de solicitud malformada, incompleta o inválida.
AIH-CONNECTION-0008 502 Intercambio de token fallido err.connection.token_exchange_failed Una llamada al proveedor/ascendente falló.
AIH-CONNECTION-0009 500 No se pudo almacenar el token err.connection.store_token_failed Un fallo interno inesperado.

CREDENCIAL

Operaciones del almacén de credenciales por usuario.

Código HTTP Significado clave i18n Causa típica
AIH-CREDENTIAL-0001 501 Bóveda de credenciales no habilitada err.credential.vault_not_enabled La función/integración está desactivada o no configurada.
AIH-CREDENTIAL-0002 400 La operación de credenciales falló err.credential.vault_error Entrada de solicitud malformada, incompleta o inválida.

DISPOSITIVO

El dispositivo se conecta a la aplicación complementaria en el dispositivo.

Código HTTP Significado clave i18n Causa típica
AIH-DEVICE-0001 503 Servicio del dispositivo no disponible err.device.service_unavailable Un servicio dependiente no está disponible temporalmente.

EVENTOS

El flujo de eventos del servidor (SSE) para la interfaz de administración y los clientes.

Código HTTP Significado clave i18n Causa típica
AIH-EVENTS-0001 500 Transmisión no compatible err.events.streaming_unsupported Un fallo interno inesperado.

HECHO

Hechos de memoria a largo plazo sobre los usuarios.

Código HTTP Significado clave i18n Causa típica
AIH-FACT-0001 404 Hecho no encontrado err.fact.not_found El objeto referenciado no existe o está fuera de alcance.
AIH-FACT-0002 403 No es un hecho del usuario err.fact.not_user_fact El recurso pertenece a otro inquilino/propietario/sesión.
AIH-FACT-0003 409 El estado del hecho no permite esta decisión: solo se puede aprobar un candidato y solo se puede rechazar un candidato o un hecho aprobado. Actualice la lista. err.fact.status_conflict —

gráfica

Gráficos de agentes: orquestación declarativa de múltiples agentes.

Código HTTP Significado clave i18n Causa típica
AIH-GRAPH-0001 501 Gráficos de agente no habilitados err.graph.not_enabled La función/integración está desactivada o no configurada.
AIH-GRAPH-0002 404 Gráfico no encontrado err.graph.not_found El objeto referenciado no existe o está fuera de alcance.
AIH-GRAPH-0003 403 No es tu gráfico err.graph.forbidden El recurso pertenece a otro inquilino/propietario/sesión.
AIH-GRAPH-0004 501 Ejecución de gráficos no disponible en esta implementación err.graph.exec_unavailable La función/integración está desactivada o no configurada.

Barrera de seguridad

Reglas de límites de contenido/conducta para agentes.

Código HTTP Significado clave i18n Causa típica
AIH-GUARDRAIL-0001 501 Barandillas no configuradas err.guardrail.not_configured La función/integración está desactivada o no configurada.

ENTRANTE

Puntos finales genéricos de webhook/ingestión entrante: ingestión de mensajes de canal→puerta de enlace.

Código HTTP Significado clave i18n Causa típica
AIH-INBOUND-0001 401 No autorizado err.inbound.unauthorized Credenciales faltantes o inválidas.
AIH-INBOUND-0002 400 Carga útil entrante no válida err.inbound.invalid_payload Entrada de solicitud malformada, incompleta o inválida.
AIH-INBOUND-0003 500 El envío entrante falló err.inbound.dispatch_failed Un fallo interno inesperado.
AIH-INBOUND-0004 503 El servidor está ocupado: el mensaje está guardado, pero aún no se ha procesado. Reintenta con el mismo ID de mensaje. err.inbound.server_busy —

IPALLOW

Listas de IP permitidas con acceso de administrador.

Código HTTP Significado clave i18n Causa típica
AIH-IPALLOW-0001 501 Lista de permitidos de IP no configurada err.ipallow.not_configured La función/integración está desactivada o no configurada.

KB

Conectores de base de conocimientos: función RAG desactivada, configuración del conector almacenada corrupta o un archivo subido incorrecto.

Código HTTP Significado clave i18n Causa típica
AIH-KB-0001 501 Base de conocimientos no habilitada err.kb.not_enabled La función/integración está desactivada o no configurada.
AIH-KB-0002 500 Configuración almacenada corrupta err.kb.config_corrupt Un fallo interno inesperado.
AIH-KB-0003 400 Archivo de conocimientos no válido err.kb.invalid_archive Entrada de solicitud malformada, incompleta o inválida.
AIH-KB-0004 413 El archivo adjunto excede el máximo permitido tamaño err.session.attachment_too_large —
AIH-KB-0005 413 El archivo adjunto excede el máximo permitido tamaño err.session.attachment_too_large —

LICENCIA

Licenciamiento de instancia: aplicando la licencia firmada.

Código HTTP Significado clave i18n Causa típica
AIH-LICENSE-0001 501 Licencia no habilitada err.license.not_enabled La función/integración está desactivada o no configurada.
AIH-LICENSE-0002 400 Licencia inválida err.license.invalid Entrada de solicitud malformada, incompleta o inválida.
AIH-LICENSE-0003 409 Esta licencia requiere una autorización de instalación firmada. Solicite al proveedor un paquete de licencia actualizado. err.license.grant_required —

LLM

Flujo de autorización de dispositivo ‘Connect Codex (suscripción a ChatGPT)’ dentro del producto.

Código HTTP Significado clave i18n Causa típica
AIH-LLM-0001 501 Codex connect no está disponible: la bóveda de secretos (AIHUMMER_MASTER_KEY) no está configurada err.llm.codex_connect_disabled La función/integración está desactivada o no configurada.
AIH-LLM-0002 502 No se pudo iniciar el flujo de autorización del dispositivo Codex err.llm.codex_connect_start_failed Una llamada al proveedor/ascendente falló.
AIH-LLM-0003 500 No se pudo borrar la conexión de Codex almacenada err.llm.codex_disconnect_failed Un fallo interno inesperado.
AIH-LLM-0004 501 No hay proveedores de modelo configurados err.llm.providers_not_configured —
AIH-LLM-0005 404 Proveedor de modelo no encontrado err.llm.provider_not_found —
AIH-LLM-0006 400 Configuración de proveedor de modelo no válida err.llm.provider_invalid —
AIH-LLM-0007 502 La prueba del proveedor falló err.llm.provider_test_failed —
AIH-LLM-0008 501 La prueba del proveedor no está disponible err.llm.provider_test_unavailable —
AIH-LLM-0009 502 OpenAI no está disponible en la región del servidor; se requiere un proxy saliente en una región permitida. Póngase en contacto con el soporte. err.llm.region_blocked —
AIH-LLM-0010 501 La conexión de la suscripción Claude no está disponible en esta instancia err.llm.claude_connect_disabled —
AIH-LLM-0011 502 No se pudo conectar la suscripción Claude err.llm.claude_connect_failed —
AIH-LLM-0012 500 No se pudo borrar la conexión almacenada de la suscripción Claude err.llm.claude_disconnect_failed —
AIH-LLM-0013 400 Esta cuenta no ofrece este modelo: elija un modelo de la lista de la cuenta. err.llm.provider_model_not_in_catalog —

MERCADO

Ruta de instalación del mercado de complementos: el identificador se valida contra el catálogo antes del despliegue asincrónico.

Código HTTP Significado clave i18n Causa típica
AIH-MARKETPLACE-0001 404 Módulo desconocido: no está en el catálogo err.marketplace.unknown_module El objeto referenciado no existe o está fuera de alcance.

MEDIOS

Puntos de acceso para obtener/transmitir blobs de medios: acceso a medios con token firmado.

Código HTTP Significado clave i18n Causa típica
AIH-MEDIA-0001 404 Medios no encontrados err.media.not_found El objeto referenciado no existe o está fuera de alcance.
AIH-MEDIA-0002 403 Token de medios no válido o vencido err.media.token_invalid El recurso pertenece a otro inquilino/propietario/sesión.
AIH-MEDIA-0003 503 Comprensión de video no configurada err.media.video_not_configured Un servicio dependiente no está disponible temporalmente.

MEMORIA

Memoria a largo plazo (Einstein) superficie de administración: el backend de memoria no está conectado.

Código HTTP Significado clave i18n Causa típica
AIH-MEMORY-0001 501 Memoria no configurada err.memory.not_configured La función/integración está desactivada o no configurada.
AIH-MEMORY-0002 404 No se encontró esta contradicción: actualice la lista. err.memory.contradiction_not_found —
AIH-MEMORY-0003 409 Esta contradicción ya se resolvió o se reabrió: actualice la lista. err.memory.contradiction_conflict —
AIH-MEMORY-0004 409 Ya hay una comprobación de la memoria en curso. Espere a que termine. err.memory.quality_busy —
AIH-MEMORY-0005 404 Esta corrección ya no existe: actualice la página. err.memory.quality_fix_not_found —
AIH-MEMORY-0006 409 No se puede deshacer esta corrección: ya se deshizo o los hechos cambiaron después. err.memory.quality_fix_conflict —

ACCESOMODELO

Reglas de acceso a modelos (qué modelos están disponibles para qué usuarios/agentes).

Código HTTP Significado clave i18n Causa típica
AIH-MODELACCESS-0001 501 Acceso al modelo no configurado err.modelaccess.not_configured La función/integración está desactivada o no configurada.

MÓDULO

Superficie de control del mercado de plugins/módulos: función desactivada, fuente/instalación faltante, propiedad, o una carga lateral malformada.

Código HTTP Significado clave i18n Causa típica
AIH-MODULE-0001 501 Mercado no habilitado err.module.not_enabled La función/integración está desactivada o no configurada.
AIH-MODULE-0002 404 Fuente no encontrada err.module.source_not_found El objeto referenciado no existe o está fuera de alcance.
AIH-MODULE-0003 404 Instalación no encontrada err.module.installation_not_found El objeto referenciado no existe o está fuera de alcance.
AIH-MODULE-0004 403 No es tu instalación err.module.installation_forbidden El recurso pertenece a otro inquilino/propietario/sesión.
AIH-MODULE-0005 501 Carga de complemento deshabilitada (sin almacenamiento de blobs) err.module.upload_disabled La función/integración está desactivada o no configurada.
AIH-MODULE-0006 400 Paquete de carga de complemento no válido err.module.invalid_bundle Entrada de solicitud malformada, incompleta o inválida.
AIH-MODULE-0007 403 La fuente del catálogo oficial no puede ser desactivado o eliminado err.module.source_protected —
AIH-MODULE-0008 403 Este módulo es una parte integrada del producto y no se puede eliminar ni detener err.module.builtin_protected —
AIH-MODULE-0009 409 Este complemento solicita permisos que debe revisar y aprobar antes de instalar err.module.consent_required —
AIH-MODULE-0010 400 El complemento solicita acceso que no declaró en su manifiesto de capacidad err.module.capability_violation —
AIH-MODULE-0011 410 Este módulo se ha retirado: su función está integrada en el núcleo del producto, por lo que ya no se puede instalar err.module.retired —

EMPAREJAMIENTO

Emparejamiento de dispositivo (rescate de QR), validación de sesión del dispositivo, estado de vinculación.

Código HTTP Significado clave i18n Causa típica
AIH-PAIRING-0001 400 Código de emparejamiento requerido err.pairing.code_required Entrada de solicitud malformada, incompleta o inválida.
AIH-PAIRING-0002 401 Código de emparejamiento inválido o caducado err.pairing.invalid_code Credenciales faltantes o inválidas.
AIH-PAIRING-0003 401 Secreto interno malo err.pairing.bad_inbound_secret Credenciales faltantes o inválidas.
AIH-PAIRING-0004 400 Falta un campo obligatorio err.pairing.field_required Entrada de solicitud malformada, incompleta o inválida.
AIH-PAIRING-0005 401 Sesión inválida o caducada err.pairing.session_invalid Credenciales faltantes o inválidas.
AIH-PAIRING-0006 400 Token requerido err.pairing.token_required Entrada de solicitud malformada, incompleta o inválida.
AIH-PAIRING-0007 401 El código de emparejamiento ha caducado: genere un código QR nuevo y escanéelo nuevamente. err.pairing.code_expired —
AIH-PAIRING-0008 401 Este código de emparejamiento ya se usó: genere un código QR nuevo. err.pairing.code_used —
AIH-PAIRING-0009 403 Este enlace de dispositivo está desactivado: vuelva a habilitarlo en la interfaz de usuario de administración de AiHummer e inténtelo de nuevo. err.pairing.binding_inactive —

PARQUE INFANTIL

El espacio de prueba de indicaciones/modelo.

Código HTTP Significado clave i18n Causa típica
AIH-PLAYGROUND-0001 501 Patio de recreo no habilitado err.playground.not_enabled La función/integración está desactivada o no configurada.

INDICACIÓN

La biblioteca de prompts/plantillas.

Código HTTP Significado clave i18n Causa típica
AIH-PROMPT-0001 501 Biblioteca de prompts no configurada err.prompt.not_configured La función/integración está desactivada o no configurada.
AIH-PROMPT-0002 404 Plantilla no encontrada err.prompt.template_not_found El objeto referenciado no existe o está fuera de alcance.

EMPUJAR

Notificaciones push móviles a través del relé de push del proveedor (la instancia no posee credenciales del proveedor).

Código HTTP Significado clave i18n Causa típica
AIH-PUSH-0001 503 Relevo de notificación push no disponible (servicio de notificación push del proveedor no disponible / instancia no registrada) err.push.relay_unavailable Un servicio dependiente no está disponible temporalmente.
AIH-PUSH-0002 502 Fallo en la entrega del relé de empuje err.push.relay_failed Una llamada al proveedor/ascendente falló.

REGEN

Regeneración de respuesta (regenerar).

Código HTTP Significado clave i18n Causa típica
AIH-REGEN-0001 501 Regenerar no habilitado err.regen.not_enabled La función/integración está desactivada o no configurada.

SAML

Inicio de sesión único SAML.

Código HTTP Significado clave i18n Causa típica
AIH-SAML-0001 501 SAML no disponible err.saml.not_available La función/integración está desactivada o no configurada.
AIH-SAML-0002 400 Aserción sin sujeto err.saml.assertion_invalid Entrada de solicitud malformada, incompleta o inválida.

HORARIO

Envíos de mensajes programados/diferidos.

Código HTTP Significado clave i18n Causa típica
AIH-SCHEDULE-0001 404 Horario no encontrado err.schedule.not_found El objeto referenciado no existe o está fuera de alcance.
AIH-SCHEDULE-0002 409 La programación aún no se puede activar: no se cumplen algunas condiciones err.schedule.blocked —
AIH-SCHEDULE-0003 409 El bloqueo se quita con la acción «Quitar bloqueo», no editando los datos err.schedule.unblock_required —
AIH-SCHEDULE-0004 400 Elija un destinatario: la programación tiene un canal de entrega, pero ningún chat err.schedule.recipient_required —
AIH-SCHEDULE-0006 409 Los comandos en el servidor en las programaciones están desactivados. El propietario o un administrador puede activarlos en Sistema y configuración → Programaciones. err.schedule.commands_off —
AIH-SCHEDULE-0007 409 Este comando exacto no está entre los comandos permitidos. El propietario o un administrador puede añadirlo en Sistema y configuración → Programaciones. err.schedule.command_not_allowed —
AIH-SCHEDULE-0008 400 Este chat no puede recibir mensajes programados: los chats web y las conversaciones por API no tienen entrega saliente. Elija un chat de mensajería. err.schedule.recipient_undeliverable —

SCIM

Aprovisionamiento de usuarios SCIM.

Código HTTP Significado clave i18n Causa típica
AIH-SCIM-0001 501 SCIM no habilitado err.scim.not_enabled La función/integración está desactivada o no configurada.

secreta

Bóveda secreta por inquilino: la clave maestra está ausente, o el secreto nombrado no existe.

Código HTTP Significado clave i18n Causa típica
AIH-SECRET-0001 501 Secretos no configurados err.secret.not_configured La función/integración está desactivada o no configurada.
AIH-SECRET-0002 404 Secreto no encontrado err.secret.not_found El objeto referenciado no existe o está fuera de alcance.

SENTIMIENTO

Analítica de conversaciones: sentimiento y calidad.

Código HTTP Significado clave i18n Causa típica
AIH-SENTIMENT-0001 501 Análisis de conversación no habilitado err.sentiment.not_enabled La función/integración está desactivada o no configurada.
AIH-SENTIMENT-0002 404 Aún no analizado err.sentiment.not_analyzed El objeto referenciado no existe o está fuera de alcance.
AIH-SENTIMENT-0003 422 No se pudo analizar la conversación err.sentiment.unprocessable La solicitud es válida pero el contenido no pudo ser procesado.

SESION

Superficie de administración de conversación/sesión + mensaje: función desactivada, o la conversación/mensaje no pertenece al llamante.

Código HTTP Significado clave i18n Causa típica
AIH-SESSION-0001 501 Conversaciones no habilitadas err.session.not_enabled La función/integración está desactivada o no configurada.
AIH-SESSION-0002 403 No es tu conversación err.session.conversation_forbidden El recurso pertenece a otro inquilino/propietario/sesión.
AIH-SESSION-0003 403 No es tu mensaje err.session.message_forbidden El recurso pertenece a otro inquilino/propietario/sesión.
AIH-SESSION-0004 413 El archivo adjunto excede el máximo permitido tamaño err.session.attachment_too_large —
AIH-SESSION-0005 404 Adjunto no encontrado err.session.attachment_not_found —
AIH-SESSION-0006 502 El mensaje no llegó al canal err.session.operator_reply_undelivered —
AIH-SESSION-0007 409 Este mensaje no es una respuesta del agente en un chat de la aplicación err.session.not_app_reply —
AIH-SESSION-0008 503 La entrega a la aplicación no está disponible en esta instancia err.session.app_delivery_unavailable —
AIH-SESSION-0009 503 El módulo «Aplicación AiHummer» no está en ejecución: inícielo en la página Complementos y vuelva a entregar err.session.app_module_not_running —

Habilidad

Habilidades del agente: biblioteca y propiedad.

Código HTTP Significado clave i18n Causa típica
AIH-SKILL-0001 501 Habilidades no habilitadas err.skill.not_enabled La función/integración está desactivada o no configurada.
AIH-SKILL-0002 404 Habilidad no encontrada err.skill.not_found El objeto referenciado no existe o está fuera de alcance.
AIH-SKILL-0003 403 No es tu habilidad err.skill.forbidden El recurso pertenece a otro inquilino/propietario/sesión.

HABILIDAD

El optimizador de habilidades: propuestas de mejora de habilidades.

Código HTTP Significado clave i18n Causa típica
AIH-SKILLOPT-0001 501 Optimizador de habilidades no habilitado err.skillopt.not_enabled La función/integración está desactivada o no configurada.
AIH-SKILLOPT-0002 404 Propuesta no encontrada err.skillopt.proposal_not_found El objeto referenciado no existe o está fuera de alcance.
AIH-SKILLOPT-0003 403 No es tu propuesta err.skillopt.proposal_forbidden El recurso pertenece a otro inquilino/propietario/sesión.

SISTEMA

Operaciones del sistema anfitrión: registros y autoactualización.

Código HTTP Significado clave i18n Causa típica
AIH-SYSTEM-0001 501 Registros no disponibles en este host err.system.logs_unavailable La función/integración está desactivada o no configurada.
AIH-SYSTEM-0002 501 Autoactualización no configurada; ejecute sudo aihummer update en el anfitrión err.system.update_not_configured La función/integración está desactivada o no configurada.
AIH-SYSTEM-0003 501 La instalación del sidecar no está disponible en este host: ejecute el instalador firmado con --sidecar &lt;nombre&gt;. err.system.sidecar_not_configured —
AIH-SYSTEM-0004 501 Este servidor no puede reiniciarse solo desde el panel. El valor guardado se aplicará la próxima vez que se reinicie el servidor: pídaselo a quien se ocupa del servidor o reinícielo desde el panel de control de su proveedor de alojamiento. err.system.restart_not_configured —

usuaria

Gestión de usuarios y roles del espacio de trabajo.

Código HTTP Significado clave i18n Causa típica
AIH-USER-0001 409 No puedes cambiar tus propios roles err.user.cannot_change_own_roles Conflictos con el estado actual.
AIH-USER-0002 409 No se puede eliminar al último propietario err.user.cannot_remove_last_owner Conflictos con el estado actual.

VOZ

Punto final de giro de voz (/v1/voice/turn): la superficie de giro de audio del puente SIP → puerta de enlace.

Código HTTP Significado clave i18n Causa típica
AIH-VOICE-0001 502 No se pudo resolver la conversación err.voice.resolve_failed Una llamada al proveedor/ascendente falló.
AIH-VOICE-0002 502 Cambio de voz fallido err.voice.turn_failed Una llamada al proveedor/ascendente falló.

WEBCONN

Backend de Admin Sessions: sesión del navegador y chat mediante SSE. Los eventos de error del flujo SSE no forman parte de este formato de error.

Código HTTP Significado Clave i18n Causa habitual
AIH-WEBCONN-0001 403 La conversación no pertenece a tu sesión err.webconn.forbidden El recurso pertenece a otro inquilino, propietario o sesión.
AIH-WEBCONN-0002 500 La transmisión no es compatible err.webconn.streaming_unsupported Se produjo un fallo inesperado.
AIH-WEBCONN-0003 409 La configuración de la aplicación de este empleado de IA está dañada. El propietario puede corregirla en el perfil del agente: «Contexto y comportamiento» → «Aplicación AiHummer». err.webconn.app_policy_invalid —
AIH-WEBCONN-0004 404 No encontrado err.common.not_found —

WEBHOOK

Webhooks salientes para eventos de instancia.

Código HTTP Significado clave i18n Causa típica
AIH-WEBHOOK-0001 501 Webhooks no habilitados err.webhook.not_enabled La función/integración está desactivada o no configurada.
AIH-WEBHOOK-0002 404 Webhook no encontrado err.webhook.not_found El objeto referenciado no existe o está fuera de alcance.

ESPACIO DE TRABAJO

Propiedad/alcance del espacio de trabajo: el inquilino actuante actuó sobre un espacio de trabajo que no posee.

Código HTTP Significado clave i18n Causa típica
AIH-WORKSPACE-0001 403 No es tu espacio de trabajo err.workspace.forbidden El recurso pertenece a otro inquilino/propietario/sesión.
AIH-WORKSPACE-0002 404 Espacio de trabajo no encontrado err.workspace.not_found —
AIH-WORKSPACE-0003 409 No se puede eliminar el último espacio de trabajo err.workspace.cannot_delete_last —

ZAPIER

El disparador de entrada del conector de Zapier.

Código HTTP Significado clave i18n Causa típica
AIH-ZAPIER-0001 501 Disparador de entrada no configurado err.zapier.not_configured La función/integración está desactivada o no configurada.
AIH-ZAPIER-0002 401 Firma de activación o token no válidos err.zapier.invalid_signature Credenciales faltantes o inválidas.

ANALYSIS

Código HTTP Significado clave i18n Causa típica
AIH-ANALYSIS-0001 503 El acceso actual a la fuente no está disponible. El análisis general o la vinculación de registros no otorga derechos sobre los datos originales. businessResults.sourceUnavailable —

BINDING

Código HTTP Significado clave i18n Causa típica
AIH-BINDING-0001 400 La regla vinculante no es válida: elija un canal, un alcance y exactamente un objetivo: un agente o «no responder». err.binding.invalid_rule —
AIH-BINDING-0002 409 Ya existe un enlace para este objetivo; elimine o edite el existente. err.binding.overlap —
AIH-BINDING-0003 404 Enlace no encontrado. err.binding.not_found —
AIH-BINDING-0004 400 @handle no es el identificador que envía el canal: añada a la persona por el id numérico del canal. err.binding.handle_not_identity —
AIH-BINDING-0005 409 Este grupo o canal ya está conectado a otra organización en este servidor: aquí no se puede vincular a un agente. err.binding.chat_taken —

BROWSER

Código HTTP Significado clave i18n Causa típica
AIH-BROWSER-0001 503 El servicio de perfiles del navegador no está en marcha. Se inicia junto con el navegador. err.browserprofile.service_unavailable —
AIH-BROWSER-0002 409 Este agente ya tiene un perfil del navegador. Primero desvincula el agente de ese perfil. err.browserprofile.agent_taken —
AIH-BROWSER-0003 409 El perfil está ocupado: alguien está iniciando sesión en él. Inténtalo de nuevo en unos minutos. err.browserprofile.busy —
AIH-BROWSER-0004 409 El perfil sigue abierto en el navegador: un agente está terminando una acción en él. Inténtalo de nuevo en un minuto. err.browserprofile.in_use —

CLAIM

Código HTTP Significado clave i18n Causa típica
AIH-CLAIM-0001 409 La ventana de identificación está cerrada: ábrala de nuevo. err.claim.window_closed —
AIH-CLAIM-0002 404 Este remitente no escribió mientras la ventana estaba abierta. err.claim.candidate_unknown —

DATA

Código HTTP Significado clave i18n Causa típica
AIH-DATA-0001 503 No se pudieron verificar las reglas de procesamiento de origen actuales. dataPolicy.errorUnavailable —
AIH-DATA-0002 409 La ruta de procesamiento seleccionada no está permitida para esta fuente. Seleccione una ruta compatible ya permitida o verifique la regla fuente. dataPolicy.errorIncompatible —
AIH-DATA-0003 503 No hay ninguna ruta compatible verificada configurada para esta operación. Especifique la ubicación de procesamiento y el perfil de almacenamiento de datos. dataPolicy.errorUnconfigured —
AIH-DATA-0004 409 La ruta de procesamiento de datos cambió durante esta operación. Revisa la ruta actual antes de enviar una nueva solicitud explícita. dataPolicy.errorChanged —
AIH-DATA-0005 409 Los primeros datos no tienen una clasificación de fuente verificada. El lugar del procesamiento no se asume automáticamente. Utilice un nuevo contexto o verifique la clasificación del material fuente. dataPolicy.errorProvenanceUnknown —
AIH-DATA-0006 409 No se pudieron verificar los bytes de origen del archivo adjunto para esta solicitud. Abra el archivo adjunto existente antes de volver a intentarlo. dataPolicy.errorFingerprintUnavailable —
AIH-DATA-0007 409 La configuración de procesamiento ha cambiado. Vuelva a leer la versión actual antes de guardar. dataPolicy.errorConfigurationChanged —

DELEGATION

Código HTTP Significado clave i18n Causa típica
AIH-DELEGATION-0001 403 Esta conexión externa no está asignada actualmente a este usuario y agente. enterpriseConnections.errorDenied —
AIH-DELEGATION-0002 409 La identidad, conexión o autoridad externa ha cambiado. Reinicie su conexión actual. enterpriseConnections.errorChanged —
AIH-DELEGATION-0003 503 El emisor configurado, la versión del proveedor o el perfil de delegación no están disponibles o son incompatibles. enterpriseConnections.errorUnavailable —
AIH-DELEGATION-0004 409 Una solicitud anterior de emisión de token externo no tiene un resultado confirmado. Comprueba su estado real con el proveedor antes de volver a intentarlo. enterpriseConnections.errorReconcile —
AIH-DELEGATION-0005 409 La configuración de las conexiones corporativas ha cambiado. Descargue la edición actual antes de guardarla. enterpriseConnections.errorConfigurationChanged —

DEMO

Código HTTP Significado clave i18n Causa típica
AIH-DEMO-0001 403 Esta acción está deshabilitada en el estand de demostración público err.demo.restricted —
AIH-DEMO-0002 403 Esto forma parte del propio estand de demostración y no se puede eliminar ni detener err.demo.protected —
AIH-DEMO-0003 403 Las notificaciones por correo están desactivadas en el estand de demostración público y no se pueden activar err.demo.email_disabled —

IMPORT

Código HTTP Significado clave i18n Causa típica
AIH-IMPORT-0001 409 La parte no continúa la subida; se reanuda desde donde llegó el servidor err.import.upload_offset —
AIH-IMPORT-0002 422 El archivo subido difiere del de su equipo. Súbalo de nuevo err.import.upload_checksum —
AIH-IMPORT-0003 413 La exportación es mayor de lo que permite la importación err.import.too_large —
AIH-IMPORT-0004 507 No hay espacio suficiente en el servidor para la exportación y su descompresión err.import.no_space —
AIH-IMPORT-0005 422 El archivo comprimido contiene rutas fuera de sí mismo y no se descomprimió err.import.unsafe_archive —
AIH-IMPORT-0006 422 Ninguna fuente de importación reconoce esta exportación err.import.not_recognized —
AIH-IMPORT-0007 409 La subida aún no ha terminado err.import.upload_incomplete —
AIH-IMPORT-0008 424 La copia de seguridad de la base antes de importar falló, así que no se aplicó nada. Compruebe que pg_dump está instalado en el servidor err.import.backup_failed —

NOTIFY

Código HTTP Significado clave i18n Causa típica
AIH-NOTIFY-0001 501 Las notificaciones no están habilitadas err.notify.not_enabled —
AIH-NOTIFY-0002 400 Preferencia de notificación no válida err.notify.invalid_pref —
AIH-NOTIFY-0003 503 La vinculación de Telegram no está disponible err.notify.telegram_unavailable —
AIH-NOTIFY-0004 502 Error al comprobar el estado de Telegram; inténtalo de nuevo err.notify.telegram_transient —

ONBOARDING

Código HTTP Significado clave i18n Causa típica
AIH-ONBOARDING-0001 503 No hay conexión con los servidores de aihummer.ru. Compruebe la conexión a internet para continuar el registro de la instancia. err.onboarding.awaiting_fleet —
AIH-ONBOARDING-0002 400 El identificador del propietario debe ser un UUID err.onboarding.invalid_owner —

PLAN

Código HTTP Significado clave i18n Causa típica
AIH-PLAN-0001 402 Este empleado de IA está fuera del límite del plan actual. Renueve la suscripción para recuperarlo. err.plan.agent_over_limit —

ROLE

Código HTTP Significado clave i18n Causa típica
AIH-ROLE-0001 400 Definición de rol no válida err.role.invalid —
AIH-ROLE-0002 409 Ya existe un rol con este nombre err.role.exists —
AIH-ROLE-0003 404 Rol no encontrado err.role.not_found —
AIH-ROLE-0004 400 Los roles integrados son de solo lectura err.role.builtin_readonly —
AIH-ROLE-0005 409 El rol aún está asignado a los usuarios; revocarlo primero err.role.in_use —

SETTINGS

Código HTTP Significado clave i18n Causa típica
AIH-SETTINGS-0001 403 Esta configuración está administrada por AiHummer Cloud y no se puede cambiar err.settings.cloud_locked —
AIH-SETTINGS-0002 400 La ejecución de código no se estableció en «Solo en zona de pruebas»: la zona de pruebas del sistema operativo (bubblewrap) no arranca en este servidor y no hay ninguna imagen de contenedor. Instale bubblewrap o elija «En este servidor». err.settings.code_exec_sandbox_unavailable —

SUPPORT

Código HTTP Significado clave i18n Causa típica
AIH-SUPPORT-0001 503 No hay conexión con el proveedor: el autobús de la flota está fuera de línea. Vuelva a intentarlo más tarde. err.support.unavailable —
AIH-SUPPORT-0002 400 El servicio de soporte rechazó la solicitud err.support.rejected —

TURN

Código HTTP Significado clave i18n Causa típica
AIH-TURN-0001 502 El proveedor del modelo rechazó sus credenciales err.turn.provider_auth —
AIH-TURN-0002 429 La solicitud fue limitada por el proveedor o la política de presupuesto err.turn.rate_limited —
AIH-TURN-0003 502 Un servicio requerido no está disponible temporalmente err.turn.upstream_unavailable —
AIH-TURN-0004 502 Una herramienta requerida por este turno falló err.turn.tool_failed —
AIH-TURN-0005 502 La tarea no cupo en el límite de pasos de un turno err.turn.step_limit —
AIH-TURN-0006 502 La conversación ya no cabe en la ventana de contexto del modelo err.turn.context_overflow —
AIH-TURN-0007 503 El turno programado se interrumpió por un reinicio del servidor err.turn.interrupted_restart —
AIH-TURN-0008 503 El servidor está ocupado con otras respuestas: el mensaje no se procesó. Envíalo de nuevo. err.turn.server_busy —
AIH-TURN-0009 409 La etapa de la tarea se ha detenido. Comprueba el estado actual de la tarea. err.turn.task_stopped —