Códigos de error de CRM (mpbx-crm)
Los genera la integración con CRM en las rutas /api/v1/integrations/crm (W7-INT-01a). Los mensajes nunca contienen una credencial, una URL de solicitud ni la respuesta de un CRM; como máximo nombran ids, nombres de campos, reglas, códigos de estado y códigos de máquina. Guía: Plantillas de CRM.
| Código | HTTP | Significado | Qué hacer |
|---|---|---|---|
MPBX-CRM-NOT-FOUND | 404 | No existe esa integración en esta empresa (la integración de otra empresa es invisible). | Revise el id. |
MPBX-CRM-JOB-NOT-FOUND | 404 | No existe ese trabajo del diario en esta empresa, o se purgó (los trabajos terminados se guardan 7 días, los fallidos 30 días). | Revise el id. |
MPBX-CRM-TEMPLATE-INVALID | 400 | El texto de la plantilla no es válido. El mensaje enumera los primeros cinco problemas con su ubicación en el documento; POST /integrations/crm/validate enumera todos. | Corrija la plantilla; vea la guía. |
MPBX-CRM-NAME-TAKEN | 409 | Otra integración de la empresa tiene este nombre. | Elija otro nombre. |
MPBX-CRM-FIELD-INVALID | 400 | Un campo está fuera de rango: name (de 1 a 80 caracteres), una credencial que la plantilla no declara o cuyo valor está vacío, supera 4096 bytes o tiene caracteres de control, una variable de prueba que la operación no tiene o es de otro tipo, un number de búsqueda que no tiene de 3 a 20 dígitos (con un + inicial opcional), un query de búsqueda de 2 a 100 caracteres, o un limit fuera de 1 a 20. | Corrija el campo indicado. |
MPBX-CRM-CHANGED | 409 | La integración cambió entre su lectura y su escritura. | Léala de nuevo e intente otra vez con el nuevo ETag. |
MPBX-CRM-LIMIT-REACHED | 409 | La empresa ya tiene 10 integraciones. | Elimine una. |
MPBX-CRM-CREDENTIALS-REQUIRED | 400 | La plantilla nombra credenciales sin valor, y usted intentó activar la integración, o ejecutar una prueba real (no de simulación), o una llamada necesitaba una. También ocurre después de un cambio de plantilla que movió base_url a otra dirección: las credenciales guardadas se eliminan a propósito (las credenciales de solo escritura no deben poder enviarse a una dirección que su dueño no aprobó). | Defina las credenciales faltantes (PUT /integrations/crm/{id}/credentials). |
MPBX-CRM-CREDENTIALS-UNREADABLE | 500 | Las credenciales selladas no se pueden abrir (se reemplazó la clave maestra sin recifrar, o la fila se dañó). | Defina las credenciales de nuevo. |
MPBX-CRM-DISABLED | 409 | La integración está apagada (crear un contacto requiere que esté encendida). | Enciéndala. |
MPBX-CRM-OPERATION-UNSUPPORTED | 400 | La plantilla no tiene esa operación. | Agregue la operación a la plantilla o elija otra. |
MPBX-CRM-RATE-LIMITED | 429 | Más de 20 pruebas, o más de 600 búsquedas, consultas y creaciones de contacto, en un minuto para la empresa. | Espere un minuto (Retry-After: 60). |
MPBX-CRM-NOT-RETRYABLE | 409 | Solo un trabajo fallido puede reintentarse. | Espere a que termine un trabajo pendiente. |
MPBX-CRM-CALL-BLOCKED | 503 | El filtro de salida rechazó la dirección del CRM después de resolver el nombre: no es https, o es una dirección privada, de loopback, de enlace local (metadatos de la nube), de NAT de nivel operador, de documentación, de multidifusión o reservada (incluidas las formas IPv4-mapeada y NAT64), o un nombre interno. | Use una dirección https pública. |
MPBX-CRM-CALL-TIMEOUT | 503 | El CRM no respondió dentro del límite de tiempo de la operación. | Revise el CRM; aumente timeout_ms (de 500 a 15000) si está lento. |
MPBX-CRM-CALL-REFUSED | 503 | El CRM respondió con un estado de error; el mensaje indica el estado. | Revise las credenciales y la solicitud en la consola de pruebas (simulación). |
MPBX-CRM-CALL-BAD-RESPONSE | 503 | La respuesta del CRM no es JSON, o la plantilla no lee nada de ella. | Compare el mapeo de respuesta con la respuesta real. |
MPBX-CRM-CALL-FAILED | 503 | No se pudo llegar al CRM (resolución de nombre, conexión, TLS) o su respuesta superó 256 KiB. | Revise la dirección y la disponibilidad del CRM. |
El registro de llamadas (GET /integrations/crm/{id}/log) y los trabajos fallidos del diario llevan el código corto de máquina de una falla en lugar de un problema HTTP: blocked, dns, network, timeout, too_large, http_status, bad_response, template_error (la plantilla no pudo construir la solicitud) y credentials_missing.