Estamos retirando la API local. Consulta nuestro documento Retirada de la API local para obtener más información y aprender a migrar a nuestra API de nube de nueva generación.
Mensajes de error y de estado
Este documento proporciona más información sobre los siguientes tipos de mensajes de error y de estado:
Para solucionar problemas del registro insertado, consulta Errores del proceso de registro insertado.
Códigos de error del cliente de la API de WhatsApp Business
| Código de error | Descripción |
|---|---|
| No se pudo descargar el contenido multimedia del remitente. |
| El mensaje no se pudo enviar debido a uno o varios errores relacionados con tu método de pago.
Comprueba la configuración de pago en el administrador de WhatsApp y vuelve a intentarlo. |
| El mensaje no se pudo enviar porque estuvo pendiente durante demasiado tiempo (p. ej., más de un día). Es el comportamiento esperado si el cliente de la API de WhatsApp Business está inactivo durante más de un día y, luego, se reinicia. Vuelve a enviar el mensaje. |
| No se pudo enviar el mensaje durante su tiempo de vida (TTL). |
|
|
| El mensaje no se pudo enviar porque se produjo un error relacionado con el certificado. Descarga un nuevo certificado del Administrador de WhatsApp y vuelve a registrarte. |
| El mensaje no se pudo enviar porque se produjo un error relacionado con el certificado. Descarga un nuevo certificado del Administrador de WhatsApp y vuelve a registrarte. |
| Se produce cuando se envía un mensaje, pero el certificado del cliente empresarial no se ha firmado correctamente mediante las claves de identidad del cliente. Probablemente esto indica que el cliente se volvió a registrar con las nuevas claves de identidad, pero no realizó el proceso completo de creación del certificado. |
| El mensaje no se pudo enviar porque transcurrieron más de 24 horas desde que el cliente respondió por última vez a este número. Utiliza una plantilla de mensaje para responder. |
| El mensaje no se pudo enviar porque hay restricciones respecto al número de mensajes que se pueden enviar desde este número de teléfono. Esto se puede deber a que muchos mensajes anteriores se bloquearon o se marcaron como spam. Comprueba el estado de calidad en el Administrador de WhatsApp. Consulta la documentación sobre las limitaciones de frecuencia basadas en la calidad para obtener más información. |
| No se pudo enviar un mensaje porque el número de teléfono de este usuario forma parte de un experimento. Omite el envío de mensajes a este usuario. |
| El mensaje no se pudo enviar porque es posible que haya cambiado el usuario con este número de teléfono. |
| El mensaje no se pudo enviar debido a un error desconocido. Vuelve a intentarlo más tarde. |
| En este momento, no se admiten los mensajes de documento con textos. |
| |
| El mensaje tiene más de 4096 caracteres de longitud. |
| Tipos de destinatarios válidos:
|
| Quizás existe un conflicto de UUID de la solicitud de carga multimedia o el contenido multimedia con este UUID ya existe. |
|
|
| El archivo o el recurso no se encuentran. |
| El destinatario no se encuentra en la lista de autorizados. |
| Falta un parámetro necesario. Si intentas enviar un mensaje de lista, es posible que te falte incluir la parte Si intentas enviar un mensaje sobre un solo producto o un mensaje sobre varios productos, es posible que te hayas saltado el valor de |
| El valor introducido para un parámetro es de un tipo incorrecto o existe otro problema. Si intentas enviar un mensaje de lista, comprueba si el identificador de cada fila es único. Si intentas enviar un mensaje sobre un solo producto, es posible que hayas enviado un valor de Si estás intentando enviar un mensaje sobre varios productos, comprueba que el valor de |
| Contiene un parámetro que no es necesario. |
| |
| |
|
|
| Se ha alcanzado la limitación de frecuencia en el lado del cliente. |
| Si el sistema está sometido a una carga elevada, se devuelve este error para permitir que el sistema se recupere. |
| Este error se produce cuando se envía una solicitud solo de objeto maestro, como las de definición u obtención de configuración, importación, exportación, solicitud de código, registro, etc., a un nodo que no es el objeto maestro principal. Esto puede suceder si el cliente de la API de WhatsApp Business no está configurado correctamente o hay errores internos. Este error se debería solucionar al volver a realizar la solicitud. De lo contrario, ponte en contacto con el equipo de asistencia. |
| Este error se produce cuando se envían solicitudes a un nodo de la aplicación principal que no es el propietario de la partición o que está en proceso de convertirse en dicho propietario. Es posible que veas este error si realizas la conmutación por error de la partición en la configuración de conexión múltiple. La mayoría de las veces este error se debería solucionar al volver a realizar la solicitud. De lo contrario, ponte en contacto con el equipo de asistencia. |
| Este error se produce cuando te envías un mensaje a ti mismo. |
| Este error se produce si no has configurado el formato de Webhooks de la API REST. |
| |
| Debes cambiar la contraseña. |
| La solicitud no es válida. |
| El mensaje no se puede entregar. Consulta “¿Por qué no tengo una frecuencia de entrega del 100 %?” en Preguntas frecuentes. |
| Has enviado un mensaje a un usuario de WhatsApp que puede que haya cambiado y se te ha enviado una notificación |
| Se ha bloqueado el envío de mensajes desde tu cuenta debido a una infracción de la política de integridad. Consulta Aplicación de la política de la plataforma de WhatsApp Business para obtener más información. |
| El número de parámetros proporcionado no coincide con el esperado. |
| El estado de la plantilla no es “Activa” o la plantilla no existe para un idioma y una configuración regional. |
| El destinatario no pudo descargar la plantilla. |
| No existe ninguna plantilla para un idioma y una configuración regional específicos. |
| La longitud de los parámetros es excesiva. |
| El texto traducido es demasiado largo. |
| Se infringió la política de espacios en blanco. |
| Se infringió la política de caracteres de formato. |
| No se admite el formato de contenido multimedia utilizado. |
| Falta el componente obligatorio de la plantilla. |
| La URL del componente de botón no es válida. |
| El número de teléfono del componente de botón no es válido. |
| El formato del parámetro no coincide con el de la plantilla creada. |
| El destinatario no admite los botones. |
| Este error se produce cuando todavía no se ha descargado ningún paquete de idioma del mensaje de la plantilla. |
| La solicitud del mensaje contiene un número de secciones inferior al mínimo o superior al máximo. Consulta el objeto Necesitas tener como mínimo un objeto |
| Hay un número de filas que no es válido. Para los mensajes de lista, debe haber como mínimo un objeto |
| Se ha infringido la política de caracteres de formato. |
| El objeto de la sección no tiene productos o el recuento total de productos ha superado el número máximo permitido. |
| El identificador del catálogo que has proporcionado no existe o no pertenece a tu cuenta de WhatsApp Business (WABA). |
| El identificador del catálogo que has proporcionado no está conectado al número de teléfono que utilizas para enviar un mensaje. |
| Algunos productos proporcionados en tu solicitud no se han encontrado en el catálogo. |
| No se han encontrado productos en el catálogo que has proporcionado. |
| Disponible solo para negocios de la India. Este error se devuelve cuando un negocio envía un mensaje sobre un solo producto en el que falta información sobre el cumplimiento del comercio electrónico o está incompleta. |
| Disponible solo para negocios de la India. Este error se devuelve cuando un negocio envía un mensaje sobre varios productos en el que falta información sobre el cumplimiento del comercio electrónico o está incompleta. |
| Disponible solo para negocios de la India. Este error se devuelve cuando un negocio envía un mensaje sobre varios productos en el que hay una combinación de productos no válidos y productos para los que falta información sobre el cumplimiento. |
| Se devuelve cuando la estructura del objeto |
| Disponible solo para negocios de la India. Este error se devuelve cuando un negocio no ha proporcionado información sobre el cumplimiento. Consulta el extremo Información de cumplimiento del negocio. |
| El estado de la plantilla es |
| El estado de la plantilla es |
| El estado de la plantilla es |
| El proceso con el identificador especificado no existe o no pertenece a tu cuenta de WhatsApp Business (WABA), o se encuentra en un estado no válido. |
| La versión del mensaje de Flows no es válida. Consulta las versiones de mensajes admitidas actualmente en el registro de cambios de Flows. |
| Se devuelve cuando el proceso en estado |
| No se ha podido enviar el proceso en modo |
| El proceso se encuentra en un estado bloqueado. Este error también se puede devolver si el proceso utiliza un extremo y la configuración necesaria no está completa (por ejemplo, si la clave pública no se ha subido o ha dejado de ser válida). Consulta Implementar el extremo para Flows. |
| El proceso se encuentra en un estado limitado y ya se han enviado diez mensajes con dicho proceso en la última hora. |
| La versión del proceso no es válida o ha caducado. Consulta las versiones admitidas actualmente en el registro de cambios de Flows |
Para los códigos de error de Commerce Manager específicos de empresas indias, consulta el Servicio de ayuda para empresas.
Códigos de estado HTTP
Son códigos de estado HTTP que podría usar el cliente de la API de WhatsApp Business.
| Código HTTP | Descripción |
|---|---|
| Correcto |
| Correcto (Aceptar) |
| Creado correctamente (para solicitudes POST) |
| Encontrado |
| Errores de cliente |
| La solicitud no era válida |
| No autorizado |
| Prohibido |
| No encontrado |
| Método no permitido. |
| Error de condición previa |
| Mensaje con limitación de frecuencia |
| Demasiadas solicitudes |
| Errores de servidor |
| Error interno del servidor. |
| Tiempo de espera agotado |