Codigos de error
Last update: 4 days ago by Irais Aguirre
Códigos de error devueltos por la API de WhatsApp, con sus títulos y descripciones.
| Código (errorCode) | Título | Descripción |
|---|---|---|
| 400 | Error de descarga del archivo multimedia | Internal error, please retry. If the problem persist, please contact support |
| 402 | Elegibilidad de la empresa: problema de pago | Account error, please contact support |
| 404 | Ruta no encontrada | Url path specified is not valid |
| 408 | El mensaje no es válido | Internal error, please retry. If the problem persist, please contact support |
| 410 | Mensaje caducado | Invalid request |
| 429 | Se alcanzó el límite de frecuencia | Internal error, please retry. If the problem persist, please contact support |
| 430 | Certificado no firmado | Internal error, please contact support |
| 432 | El identificador del certificado no concuerda | Internal error, please contact support |
| 433 | Firma del certificado no válida | Internal error, please contact support |
| 470 | Mensajes de nueva interacción | The message could not be sent because more than 24 hours have passed since the last time the customer responded to this number. Use a message template to reply. |
| 471 | Se alcanzó el límite de frecuencia de spam | Account error, please contact support |
| 472 | El número del usuario es parte de un experimento | Invalid request |
| 480 | Usuario potencialmente cambiado | The message was not sent because the user this phone number belongs to possibly changed. |
| 500 | Error genérico | Internal error, please retry. If the problem persist, please contact support |
| 501 | Error interno, vuelve a intentarlo | Internal error, please retry. If the problem persist, please contact support |
| 502 | Error interno, contacta a soporte | Internal error, please contact support |
| 503 | Error de cuenta | Account error, please contact support |
| 504 | Error de Api Graph | Api Graph error, please contact support |
| 1000 | Error genérico | The server encountered an unexpected condition which prevented it from fulfilling the request |
| 1001 | Mensaje demasiado largo | The length of the message exceeds 4096 characters. |
| 1101 | Mensaje demasiado largo | Message too long |
| 1108 | Falta un parámetro necesario | Required parameter is missing |
| 1002 | Tipo de destinatario no válido | Invalid request |
| 1004 | El recurso ya existe | Internal error, please retry. If the problem persist, please contact support |
| 1005 | Acceso denegado | Internal error, please retry. If the problem persist, please contact support |
| 1006 | No se encontró el recurso | File or resource not found |
| 1008 | Falta un parámetro necesario | A required parameter is missing |
| 1009 | Valor de parámetro no válido | Parameter value is not valid |
| 1010 | Parámetro no necesario | Contains a parameter that is not required. |
| 1011 | El servicio no está listo | Internal error, please retry. If the problem persist, please contact support |
| 1013 | Usuario no válido | Invalid request |
| 1014 | Error interno | Internal error, please retry. If the problem persist, please contact support |
| 1015 | Demasiadas solicitudes | Account error, please contact support |
| 1016 | Sistema sobrecargado | Internal error, please contact support |
| 1017 | No es el nodo maestro principal | The server encountered an unexpected condition which prevented it from fulfilling the request |
| 1018 | No es una app principal primaria | The server encountered an unexpected condition which prevented it from fulfilling the request |
| 1021 | Usuario incorrecto | Invalid request |
| 1022 | La URL de los webhooks no está configurada | The server encountered an unexpected condition which prevented it from fulfilling the request |
| 1023 | Se produjo un error en la base de datos | The server encountered an unexpected condition which prevented it from fulfilling the request |
| 1024 | Es necesario cambiar la contraseña | Account error, please contact support |
| 1025 | Solicitud no válida | Invalid request |
| 1148 | El valor del campo "category" es diferente a "utility" | Param category must be 'utility' |
| 1149 | El nombre del template no cumple el patrón | Invalid direct_send_config.template_name: lowercase alphanumeric/underscore only, max 512 chars, and only valid with category 'utility' |
| 1150 | El objeto direct_send_config se envía vacío | Param direct_send_config.template_name is required when direct_send_config is sent |
| 1151 | El campo "ttl_seconds" tiene un valor inválido o se envió sin el campo "category" | Invalid ttl_seconds: requires category and must be between 30 and 43200 for 'utility' |
| 1120 | No se encontró el número de teléfono de la WABA | WABA phone number not found |
| 1124 | Formato de URL no válido | Invalid url format |
| 1125 | Solicitud no válida | Invalid request, please verify |
| 1126 | Tipo de mensaje no válido | Invalid message type |
| 1127 | La cuenta de sistema ya existe | System Account already exists |
| 1128 | Nombre de rol reservado | Reserved role name |
| 1129 | Nombre de rol no válido | Invalid role name |
| 1130 | No se encontró la cuenta | Account not found |
| 1131 | No se encontró el certificado | Certificate not found |
| 1132 | Tamaño de archivo no válido | Invalid file size |
| 1133 | Longitud no válida | Invalid length |
| 1134 | La cuenta de Embedded Onboarding ya existe | Embedded Onboarding Account already exists |
| 1135 | Número de teléfono no registrado | The provided phone number is not registered |
| 1136 | No se encontró la WABA | WABA not found. |
| 1137 | El webhook del número de teléfono ya existe | The provided phone number already has a webhook configured. Please contact the operations team to update or replace the existing webhook. |
| 1138 | No se encontró el token del negocio | Business token not found. Please retry the Embedded Signup process to obtain it. |
| 1139 | Tipo de sincronización no válido | The provided sync type does not exist. Valid values are: 'history', 'contacts' |
| 1140 | No se encontró el ID del negocio | Business ID not found |
| 1141 | Falló el onboarding de MM Lite | Error onboarding business for mm lite |
| 1142 | Acción de llamada no válida | Call action not valid, this are the valid values: connect, pre_accept, accept, reject, terminate |
| 1143 | Código de moneda no válido | Currency must be a valid ISO 4217 currency code |
| 1144 | URI de enlace de pago no válido | Parameter uri in payment_link must start with https:// or upi:// |
| 1145 | recipient_type no válido | Invalid recipient_type, valid values are: 'individual', 'group' |
| 1146 | recipient_type 'group' no admitido | recipient_type 'group' is not supported for this message type |
| 1147 | pin.type no válido | Invalid pin.type, valid values are: 'pin', 'unpin' |
| 1152 | Falló la actualización de visibilidad de precio máximo | Error updating max price visibility |
| 2000 | El número de parámetros no coincide | Number of parameters does not match the expected number of params. |
| 2005 | Texto traducido demasiado largo | Translated text too long |
| 2015 | Número de secciones no válido | Invalid number of sections |
| 2016 | Número de filas no válido | Invalid number of rows. |
| 2017 | Política de caracteres infringida | Character policy violated. |
| 2023 | Número de productos no válido | Invalid number of products |
| 2101 | No se encontró la plantilla | Template not found |
| 2102 | Plantilla pendiente de aprobación | The template is still being reviewed by Meta |
| 2103 | Plantilla rechazada | The template was reviewed by Meta and not approved |
| 2104 | La plantilla ya existe | Template already exists |
| 2105 | La plantilla tiene un estado desconocido | Template has an unknown status |
| 2106 | Formato de plantilla no válido | Invalid template format, please verify |
| 2107 | El ID de país no existe | Country ID not exists |
| 2108 | Formato de teléfono no válido | Parameter 'to' is not valid |
| 3000 | Falta el Token de Autenticación | Authorization Bearer missing |
| 3001 | Falta el parametro Api-Key | Api-Key is missing |
| 3002 | Falta el parámetro Api-Token | Api-Token is missing |
| 3003 | El Api-Key es invalido | Api-Key invalid |
| 3004 | El Api-Key está inactivo | Api-Key inactive |
| 3005 | El Api-Token es invalido | Api-Token invalid |
| 3006 | Error al generar el Token de Autenticación | Error to generate JWT token |
| 3007 | Error al validar el Token de Autenticación | Error to validate JWT token |
| 3008 | El Token de Autenticación es invalido | JWT token invalid |
| 3009 | El Token de Autenticación ha caducado | JWT token expired |
| 3010 | El número de teléfono es invalido | Invalid From Phone number |
| 3011 | No se encontró la cuenta | Account not found |
| 3012 | Usuario o contraseña no válidos | Invalid username or password |
| 3013 | La cuenta ha sido deshabilitada | The account has been disabled |
| 3014 | No estás autorizado para usar esta función | You are not authorized to use this feature |
| 3015 | Error al validar la información de Meta | Error validating Meta info |
| 4001 | Error del cliente de la API de WhatsApp | Whatsapp API client error, possibly instance hasn't been built |
| 4002 | Conflicto del cliente de la API de WhatsApp | Whatsapp API client has been previously configured |
| 4003 | El cliente de la API de WhatsApp ya está registrado | Whatsapp API client it's already registered for the phone number requested |
| 4004 | El cliente de la API de WhatsApp no está verificado | Whatsapp API client hasn't been verified, please contact support |
Códigos de Meta Cloud API: los webhooks de estatus y los rechazos de envío también pueden incluir códigos de error provenientes directamente de la Graph API de Meta (p. ej. 100, 190, familia 131xxx). Para esos códigos, consulta la referencia de errores de la WhatsApp Business Platform. Los códigos 400–1025 listados arriba corresponden al catálogo legacy on-prem.