title: "Documentación de errores de mensajes de WhatsApp: API en la nube" revisado: true revisor: "Maria Rampanelli" autor:
- "Leticia Benedet" data_revisao: "2025-03-17" faq: "Quais são as mensagens de erro que podem ocorrer no meu WhatsApp?; O que significa o erro Business eligibility - Payment issue? O que fazer quando aparece a mensagem 'Unknown error' no OPA?"
Documentación de errores de la API de la nube de WhatsApp
Introducción
Esta documentación proporciona una lista completa de códigos de error de la API de WhatsApp Cloud. Estos códigos son particularmente relevantes para los usuarios que utilizan el registro integrado firmado.
Categorías de errores
Los errores de la API de WhatsApp Cloud se clasifican en las siguientes secciones:
- Errores de autorización
- Errores de limitación de velocidad
- Errores de integridad
- Otros errores
Cómo comprobar el tipo de error
Cuando ocurre un error al enviar un mensaje, coloque el cursor del mouse sobre el ícono o texto que indica el error. Esto mostrará el motivo de la falta de envío. Después de identificar el motivo, consulte la lista de errores disponibles para comprender la causa y encontrar la solución adecuada.
Lista de errores
| Error | Descripción | Solución |
|---|---|---|
| El token de acceso ha caducado | Su token de acceso ha caducado. | Obtenga un nuevo token de acceso. |
| Método API | Problema de capacidad o permisos. | Utilice el depurador de token de acceso para comprobar los permisos de la aplicación. |
| Permiso API | Permiso no concedido o eliminado. | Verifique los permisos de la aplicación utilizando el depurador de token de acceso. |
| Excepción de autenticación | Meta no puede autenticar al usuario de la aplicación. | Obtenga un nuevo token de acceso de usuario a la aplicación. |
| Demasiadas llamadas API | La aplicación ha alcanzado su límite de tasa de llamadas API. | Inténtelo de nuevo más tarde o reduzca la frecuencia de las consultas de API. |
| Problemas con límites de tarifas | La cuenta WhatsApp Business ha alcanzado su límite de tarifa de solicitud. | Consulte Límites de tarifas de cuentas comerciales de WhatsApp. Inténtelo de nuevo más tarde o reduzca la frecuencia de las consultas de API. |
| Límite de tasa alcanzado | Se alcanzó el límite de rendimiento de la API de la nube. | Inténtelo de nuevo más tarde o reduzca la frecuencia de envío de mensajes. |
| Límite de tasa de spam alcanzado | Muchos mensajes anteriores fueron bloqueados o marcados como spam. | Verifique su estado de calidad en WhatsApp Manager. |
| Límite de tasa de par alcanzado (Cuenta comercial y Cuenta de consumidor) | Muchos mensajes enviados desde el mismo remitente al mismo destinatario en un corto período de tiempo. | Espera y vuelve a intentar la operación con el mismo número de teléfono. |
| Acceso denegado | Permiso no concedido o eliminado. | Verifique los permisos de la aplicación utilizando el depurador de token de acceso. |
| La cuenta ha sido bloqueada | La cuenta empresarial de WhatsApp ha sido restringida o inhabilitada debido a una infracción de la política o Meta no puede verificar los datos de la solicitud. | Comuníquese con el equipo de soporte de ¡Hola! Suite para obtener más información. |
| API desconocida | Solicitud no válida o error del servidor. | Verifique el estado de la API en la página Estado de la plataforma de comercio de WhatsApp. |
| Elegibilidad empresarial: problema de pago | El envío del mensaje falló debido a errores relacionados con el método de pago. | Verifique que su configuración de facturación sea correcta. |
| No se pudo enviar un mensaje porque el número de teléfono de este usuario es parte de un experimento | Mensaje no enviado como parte de un experimento. | No envíe mensajes de la categoría Marketing a este usuario. |
| Error de usuario genérico | El mensaje no se pudo enviar debido a un error desconocido con los parámetros de su solicitud. | Consulte la referencia del punto final para determinar si está consultando el punto final utilizando la sintaxis correcta. Comuníquese con el servicio de atención al cliente si continúa recibiendo este código de error como respuesta. |
| Baja incompleta | Un intento anterior de cancelar el registro falló. | Anule el registro del número nuevamente antes de registrarse. |
| Certificado incorrecto | El mensaje no se pudo enviar debido a un error en el registro del número de teléfono. | Registre el número de teléfono antes de volver a intentarlo. |
| Error de descarga de medios | El tipo de medio subido por el usuario de WhatsApp no es compatible. | Verifique los tipos de medios admitidos y recomiende al usuario que reenvíe el mensaje utilizando un formato admitido. |
| El parámetro no es válido | La solicitud incluía parámetros no admitidos o mal escritos. | Consulte la referencia del punto final para determinar qué parámetros se admiten. |
| El valor del parámetro no es válido | No se admiten uno o más valores de parámetros. | Consulte la referencia del punto final para determinar qué valores se admiten para cada parámetro. |
| Número de teléfono no registrado | El número de teléfono no está registrado en la Plataforma Comercial WhatsApp. | Registre el número de teléfono antes de volver a intentarlo. |
| Se necesita volver a verificar el número de teléfono | El número de teléfono debe verificarse antes del registro. | Verifique el número de teléfono antes de registrarlo. |
| No se puede enviar el destinatario | Los números de teléfono del remitente y del destinatario son los mismos. | Enviar un mensaje a un número de teléfono diferente al del remitente. |
| El destinatario no puede recibir el mensaje | El destinatario está utilizando una versión de WhatsApp que no admite el contenido del mensaje. | Aconseje al destinatario que actualice a la última versión de WhatsApp. |
| Mensaje de reintegración | Han pasado más de 24 horas desde la última vez que el destinatario respondió. | Envíe un mensaje iniciado por la empresa utilizando una plantilla de mensaje. |
| Servidor no disponible temporalmente | El servidor no está disponible temporalmente. | Consulte la página Estado de la plataforma WhatsApp Business antes de volver a intentarlo. |
| Servicio no disponible | El servicio no está disponible temporalmente. | Consulte la página Estado de la plataforma WhatsApp Business antes de volver a intentarlo. |
| Algo salió mal | El mensaje no se pudo enviar debido a un error desconocido. | Por favor inténtalo de nuevo. Si el error persiste, contacta con el soporte de ¡Hola! Suite. |
| La plantilla no existe | La plantilla no existe en el idioma especificado o no ha sido aprobada. | Verifique que la plantilla esté aprobada y que el nombre y el idioma sean correctos. |
| Se infringe la política de caracteres de formato de plantilla | El contenido de la plantilla viola una política de WhatsApp. | Consulte los motivos de rechazo para determinar los posibles motivos de la infracción. |
| Texto hidratado de la plantilla demasiado largo | El texto traducido es demasiado largo. | Verifique en WhatsApp Manager si su plantilla se tradujo correctamente. |
| No coincide el recuento de parámetros de plantilla | La cantidad de valores de parámetros variables no coincide con la cantidad de parámetros definidos en el modelo. | Asegúrese de que la solicitud incluya todos los valores de parámetros variables definidos en la plantilla. |
| El formato del parámetro de plantilla no coincide | Los valores de los parámetros variables tienen un formato incorrecto. | Verifique que los valores de los parámetros variables utilicen el formato especificado en la plantilla. |
| Bloqueado temporalmente por infracciones de políticas | La cuenta de WhatsApp Business asociada a la aplicación ha sido restringida o inhabilitada por violar la política de la plataforma. | Comuníquese con el equipo de soporte de ¡Hola! Suite para obtener más información. |
| Demasiadas conjeturas sobre el PIN de verificación en dos pasos | Muchas adivinanzas sobre el PIN de verificación en dos pasos para este número de teléfono. | Inténtalo de nuevo después del tiempo especificado en la respuesta detallada. |
| PIN de verificación en dos pasos adivinado demasiado rápido | El PIN de verificación en dos pasos se ingresó muy rápidamente. | Verifique el valor de respuesta detallado antes de volver a intentarlo. |
| El PIN de verificación en dos pasos no coincide | PIN de verificación en dos pasos incorrecto. | Verifique que el PIN de verificación en dos pasos incluido en la solicitud sea correcto. |
| Tipo de mensaje no admitido | Tipo de mensaje no admitido. | Verifique los tipos de mensajes admitidos antes de volver a intentarlo. |