La API de instalaciones locales dejará de estar disponible. Consulta nuestro documento Fin de la API de instalaciones locales para conocer los detalles y descubrir cómo migrar a nuestra nueva generación de API de la nube.
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 obtener información sobre la resolución de problemas relacionados con el registro insertado, consulta Errores en el 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 archivo multimedia del remitente. |
| El mensaje no se pudo enviar, porque se produjeron uno o más errores relacionados con el método de pago.
Revisa tu configuración de pagos en el administrador de WhatsApp y vuelve a intentarlo. |
| No se pudo enviar el mensaje, porque estuvo pendiente durante demasiado tiempo (más de 1 día). Es esperable que esto ocurra si el cliente de la API de WhatsApp Business permanece 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. |
| Ocurre cuando se envía un mensaje, pero el certificado del cliente de la empresa no está firmado correctamente con las claves de identidad del cliente. Esto probablemente indica que el cliente volvió a registrarse con claves de identidad nuevas, pero no realizó todo el proceso de creación del certificado. |
| El mensaje no se pudo enviar, porque pasaron más de 24 horas desde la última vez que el cliente respondió a este número. Usa una plantilla de mensaje para responder. |
| No se pudo enviar el mensaje porque hay restricciones relacionadas con la cantidad de mensajes que se pueden enviar desde este número de teléfono. Esto puede deberse a que se bloquearon demasiados mensajes anteriores o se marcaron como spam. Comprueba el estado de calidad en el administrador de WhatsApp. Consulta la documentación de límites de frecuencia basados en la calidad para obtener más información. |
| El mensaje no se pudo enviar, porque el número de teléfono del usuario es parte de un experimento. Omite el envío de mensajes a este usuario. |
| No se envió el mensaje porque el usuario al que pertenece este número de teléfono posiblemente cambió. |
| No se pudo enviar el mensaje debido a un error desconocido. Vuelve a intentarlo más tarde. |
| Los mensajes de documentos con descripciones no se admiten en estos momentos. |
| |
| La longitud del mensaje supera los 4.096 caracteres. |
| Tipos de destinatarios válidos:
|
| Hay un posible conflicto de UUID para una solicitud de subida de contenido multimedia o ya existe contenido multimedia con ese UUID. |
|
|
| No se encontró el archivo o el recurso |
| El destinatario no figura en la lista de autorizados. |
| Falta un parámetro obligatorio. Si intentas enviar un mensaje de lista, es posible que hayas omitido la parte Si intentas enviar un mensaje de uno o varios productos, es posible que hayas omitido |
| El valor ingresado en un parámetro es del tipo incorrecto o existe otro problema. Si intentas enviar un mensaje de lista, verifica que el identificador de cada fila sea único. Si intentas enviar un mensaje de producto individual, es posible que hayas enviado el Si intentas enviar un mensaje de productos múltiples, verifica que tu |
| Contiene un parámetro que no es necesario. |
| |
| |
|
|
| Se alcanzó el límite de frecuencia del cliente |
| Si el sistema tiene mucha carga, se devuelve este error para permitir que el sistema se recupere de la carga. |
| Se produce este error cuando una solicitud solo para nodos maestros, como establecer configuración, obtener configuración, importar, exportar, solicitar código, registrarse, etc., se envía a un nodo que no es un nodo maestro principal. Esto puede ocurrir cuando el cliente de la API de WhatsApp Business no se configura correctamente o se producen errores internos. Se debería solucionar este error si reintentas la solicitud. De lo contrario, ponte en contacto con el servicio de asistencia. |
| Este error se produce cuando se envían solicitudes a un nodo de la app principal que no es el propietario del fragmento o no se encuentra en proceso de convertirse en el propietario del fragmento. Es posible que se muestre este error si conmutamos fragmentos por error en la configuración de conexión múltiple. Se debería resolver este error en la mayoría de los casos si reintentas la solicitud. De lo contrario, ponte en contacto con el servicio de asistencia. |
| Este error se produce cuando te envías un mensaje a ti mismo. |
| Este error se produce si no configuraste el formato de los webhooks de la API de REST. |
| |
| Debes cambiar la contraseña. |
| La solicitud no es válida. |
| El mensaje no se puede enviar. Consulta "¿Por qué mi índice de entregas no es 100%?" Preguntas frecuentes. |
| Enviaste un mensaje a un usuario de WhatsApp que posiblemente cambió, y se te envió una notificación de sistema |
| Se bloqueó tu cuenta, y no puedes enviar mensajes debido a una infracción de la política de integridad. Para obtener información, consulta Aplicación de la política de la plataforma de WhatsApp Business. |
| La cantidad de parámetros proporcionados no coincide con la cantidad de parámetros prevista. |
| El estado de la plantilla no es activo, o bien no existe la plantilla de un idioma y una configuración regional. |
| El receptor no pudo descargar la plantilla. |
| No existen plantillas para un idioma o una región específicos. |
| Longitud de parámetro excesiva |
| El texto traducido es demasiado largo. |
| Se infringió la política de espacios en blanco. |
| Se incumplió la política de caracteres de formato. |
| El formato de archivo multimedia no es compatible. |
| Falta un componente obligatorio de la plantilla. |
| La URL del componente del botón no es válida. |
| El número de teléfono del componente del botón no es válido. |
| El formato de parámetro no coincide con el formato de la plantilla creada. |
| El receptor no admite estos botones. |
| Este error se produce cuando aún no se ha descargado un paquete de idioma de mensaje de plantilla. |
| La solicitud de mensaje contiene una cantidad de secciones menor al mínimo o superior al máximo. Consulta el objeto Es necesario que tengas, al menos, un objeto |
| Hay una cantidad no válida de filas. Para los mensajes de lista, debe haber, al menos, un objeto |
| Se incumplió con la política de caracteres de formato. |
| El objeto de sección no tiene productos o el conteo de productos totales excedió el número máximo permitido. |
| El identificador de catálogo que proporcionaste no existe o no pertenece a tu cuenta de WhatsApp Business (WABA). |
| El identificador de catálogo que proporcionaste no está conectado al número de teléfono que estás usando para enviar un mensaje. |
| Algunos productos proporcionados en tu solicitud no se encontraron en el catálogo. |
| No se encontraron productos en el catálogo que proporcionaste. |
| Solo está disponible para las empresas de la India. Se devuelve este error cuando una empresa envía un mensaje de productos individuales con información faltante o incompleta relativa a los requisitos que se deben cumplir en el comercio electrónico. |
| Solo está disponible para las empresas de la India. Se devuelve este error cuando una empresa envía un mensaje de productos múltiples con información faltante o incompleta relativa a los requisitos que se deben cumplir en el comercio electrónico. |
| Solo está disponible para las empresas de la India. Se devuelve este error cuando una empresa envía un mensaje de productos múltiples, en el que se combinan productos no válidos y otros que no incluyen información relativa al cumplimiento de los requisitos. |
| Se devuelve cuando la estructura del objeto |
| Solo está disponible para las empresas de la India. Se devuelve este error cuando una empresa no proporcionó la información relativa al cumplimiento de los requisitos. Consulta el punto de conexión sobre cumplimiento de los requisitos. |
| 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 en tu cuenta de WhatsApp Business (WABA) o no pertenece a ella, o su estado es no válido. |
| El proceso se encuentra en estado bloqueado. Este error también se puede devolver si el proceso utiliza un punto de conexión y la configuración obligatoria no está completa; por ejemplo, si la clave pública no se subió o caducó. Consulta Implementar punto de conexión para procesos. |
| El proceso está limitado y en la última hora ya se enviaron 10 mensajes que usan este proceso. |
Para obtener información sobre los códigos de error del administrador de ventas específicos de empresas indias, consulta el servicio de ayuda para empresas.
Códigos de estado HTTP
Estos son códigos de estado HTTP que puede utilizar el cliente de la API de WhatsApp Business.
| Código HTTP | Descripción |
|---|---|
| Correcto |
| Correcto (Aceptar) |
| Se creó correctamente (para solicitudes POST) |
| Se encontró |
| Errores de cliente |
| La solicitud no era válida |
| No autorizado |
| Prohibido |
| No se encontró |
| Método no permitido |
| No se cumplió la condición previa |
| El mensaje tiene una frecuencia limitada |
| Demasiadas solicitudes |
| Errores de servidor |
| Error de servidor interno |
| Tiempo de espera |