R
Por Ryan
Publicado el 11 feb 2026
Códigos de error de WhatsApp API: lista completa con causas y soluciones (2026)
¿WhatsApp API muestra errores? Consulta los códigos de error: más de 40 códigos relacionados con autenticación, límites de frecuencia, plantillas, contenido multimedia y flujos, con pasos para solucionar problemas.
Los códigos de error de WhatsApp API son códigos numéricos que permiten identificar y resolver los problemas que enfrentan los usuarios al interactuar con soluciones de WhatsApp API. Como WhatsApp API se basa en Graph API, se recomienda a los proveedores de soluciones o integradores de API que gestionen la lógica de errores mediante código y detalles para obtener información clara sobre el problema subyacente. Los códigos permiten a las empresas identificar el problema al enviar mensajes o conectarse a WhatsApp API y solucionar problemas.
A continuación, se incluye una lista completa de códigos de error de WhatsApp API, organizados en categorías relevantes y con pasos sugeridos para solucionar problemas. WhatsApp también enumera un conjunto de códigos de error técnicos para su servicio de API en la nube aquí.
a) Errores de autorización: Los errores de autenticación se producen cuando el sistema de WhatsApp API no puede verificar las credenciales o los permisos del usuario o la aplicación que realiza las solicitudes.
| Código | Descripción | Posible solución |
|
0 | AuthException Meta no puede autenticar al usuario de la aplicación: un token vencido o un cambio en el acceso a los datos podrían ser las causas . | Vuelve a verificar los permisos de la aplicación o genera el token de acceso aquí , o consulta con tu proveedor de soluciones los pasos que debes seguir. |
|
3 | Método de API Falta de los permisos necesarios para realizar la llamada a la API o una llamada a la API mal configurada | Revisa la configuración de la API o genera de nuevo el token de acceso. Si usas un proveedor de soluciones, ponte en contacto con él. |
|
10 | Permiso denegado No se han otorgado permisos suficientes a tu aplicación o se ha eliminado el acceso. Número de teléfono no aprobado: el número de teléfono no está aprobado ni figura entre los permitidos para la cuenta de WhatsApp API |
Vuelve a verificar el token de API para confirmar que tenga los permisos necesarios para la aplicación aquí. Si usas un proveedor de soluciones, consulta con él los pasos necesarios. Comprueba que el número de teléfono esté registrado y aprobado correctamente en tu cuenta de WhatsApp Business. Si tu proveedor de soluciones no lo hizo, completa el registro y la aprobación. |
|
190 | Permiso denegado El token de acceso venció y el acceso a la API está bloqueado | Obtén un nuevo token de acceso para la aplicación correspondiente y asegúrate de que tenga todos los permisos. Tu proveedor de soluciones puede guiarte en los pasos. |
|
200-299 | Errores de permisos de API Falta un permiso o se revocó: el acceso a funciones específicas de la API está restringido | Verifica el token de API para obtener los permisos necesarios para la aplicación aquí. Si usas la solución de un proveedor, consulta con él los pasos necesarios. |
b) Errores por límites de frecuencia: Se producen cuando tu aplicación supera el límite de frecuencia de llamadas a la API asignado a tu cuenta.
| Código | Descripción | Posible solución |
| 4 | Demasiadas llamadas a la API La aplicación ha superado el límite de frecuencia de llamadas a la API | Supervisa y optimiza de forma proactiva la frecuencia de las llamadas a la API. Planifica con anticipación cómo gestionar los límites de frecuencia de la API. |
| 80007 | Problemas con los límites de frecuencia La cuenta de WhatsApp API alcanzó su límite de frecuencia | Vuelve a intentarlo más tarde o reduce el número de llamadas a la API. |
| 130429 | Se alcanzó el límite de frecuencia Se superó el límite de volumen de mensajes. | Debes reducir la frecuencia con la que envías mensajes o volver a intentarlo más tarde. |
| 131048 | Se alcanzó el límite de frecuencia por spam Esto puede deberse a restricciones en el volumen de mensajes del número de teléfono de la cuenta de API. Podría ser consecuencia de un historial previo de reportes de spam y mensajes bloqueados por los destinatarios. | Comprueba el estado de calidad en WhatsApp Manager y reduce la frecuencia de los mensajes. |
| 131056 | Se alcanzó el límite de frecuencia entre pares Se envía una gran cantidad de mensajes en poco tiempo desde el número de teléfono del remitente a un destinatario con un número de teléfono específico. | Espera y vuelve a intentar enviar mensajes al número de teléfono del mismo destinatario. No hay restricciones para enviar mensajes a otros números de teléfono. |
| 133016 | Se superó el límite de registro o cancelación del registro de números de teléfono WhatsApp limita a 10 el número de intentos de registro o cancelación del registro en un período de 72 horas | Espera un momento y vuelve a intentarlo cuando termine el período de bloqueo de 72 horas. |
c) Errores de integridad: Se relacionan con una infracción de las políticas de WhatsApp Platform que restringió temporalmente ciertas acciones de la cuenta empresarial.
| Código | Descripción | Posible solución |
| 368 | Bloqueo temporal por infracciones de las políticas La cuenta de WhatsApp Business asociada está restringida o bloqueada por infringir una política de la plataforma. | Revisa las políticas de WhatsApp para comprender y resolver las infracciones, o consulta con tu proveedor de soluciones de WhatsApp. |
| 130497 | Restricciones de mensajería en algunos países: Se prohíbe que la cuenta de WhatsApp Business envíe mensajes a usuarios de determinados países debido a restricciones por categoría o a políticas locales | Consulta las restricciones geográficas y las políticas de WhatsApp sobre mensajería por país aquí. Para obtener más información, consulta con el soporte de WhatsApp o con tu proveedor de soluciones. |
| 131031 | Cuenta bloqueada La cuenta de WhatsApp Business está restringida o completamente deshabilitada por infringir las políticas de la plataforma o de comercio. Esto podría deberse a una verificación insuficiente del contenido de los mensajes o de los datos. | Consulta las pautas sobre el estado de la mensajería o las políticas de la plataforma relacionadas con la aplicación de medidas contra el spam. |
d) Errores de plantillas de mensajes: Problemas relacionados con las plantillas estructuradas de mensajes predefinidas, que pueden deberse a infracciones de políticas, contenido prohibido, límites de frecuencia o problemas de formato.
| Código | Descripción | Posible solución |
| 132000 | La cantidad de parámetros de la plantilla no coincide La cantidad de parámetros variables del mensaje no coincide con la variable definida en la plantilla aprobada | Revisa el mensaje y consulta las directrices para plantillas, asegurándote de que todos los parámetros variables estén definidos |
| 132001 | La plantilla no existe La plantilla no está aprobada o no existe en el idioma específico. | Asegúrate de que la plantilla del mensaje esté aprobada y de que el nombre del mensaje y la configuración regional del idioma sean correctos. Para obtener más información, consulta los detalles de la política de plantillas |
| 132005 | La plantilla traducida supera el límite de caracteres Las plantillas interactivas con todos los botones, respuestas rápidas y otros caracteres de texto superan los límites al traducirse. | Revisa el contenido de la plantilla, simplifícalo y reduce la cantidad de caracteres; de preferencia, usa contenido conciso. Consulta el estado de la plantilla para conocer otras acciones. |
| 132007 | Infracción de la política de formato de plantillas Este error ocurre si el contenido incluye caracteres no admitidos, formato incorrecto u otros elementos que no cumplen con las directrices de WhatsApp. | Revisa el motivo del rechazo y vuelve a editar el contenido de la plantilla. |
| 132012 | El formato de los parámetros de la plantilla no coincide Envío de parámetros incorrectos (como una imagen en lugar de un video) en el mensaje de plantilla, que no coinciden con el formato de la plantilla aprobada. | Asegúrate de que los parámetros de la plantilla coincidan con el formato aprobado. Si lo necesitas, solicita ayuda a tu proveedor de soluciones de WhatsApp. |
| 132015 | Plantilla pausada La plantilla se ha pausado debido a una calificación de calidad baja, y la cuenta de API no puede enviar este tipo de mensajes de plantilla a sus usuarios. | Edita la plantilla, mejora la calidad y luego intenta enviarla de nuevo. |
| 132016 | Plantilla deshabilitada Si la plantilla se ha pausado varias veces debido a su baja calidad, WhatsApp la ha desactivado. | Se recomienda crear una plantilla nueva, hacer cambios en el contenido y asegurarse de que sea de calidad. |
e) Error en la entrega del mensaje: Esto se relaciona con la falla en la entrega del mensaje al destinatario debido a problemas con el contenido, la configuración o el destinatario.
| Código | Descripción | Posible solución |
| 131026 | No se pudo entregar el mensaje Los motivos podrían ser -El destinatario no tiene un número válido de WhatsApp -El destinatario usa una versión anterior de la aplicación WhatsApp -El destinatario no ha aceptado los nuevos términos del servicio ni la política de privacidad de WhatsApp | El destinatario debe aceptar los T&C de WhatsApp, registrar una cuenta de WhatsApp o actualizar la versión de la aplicación. |
| 131047 | Mensaje para volver a interactuar Han pasado más de 24 horas desde la última respuesta del destinatario. | Usa una plantilla de mensaje iniciado por la empresa para volver a iniciar una conversación con el usuario. |
| 131049 | Meta no entregó el mensaje Meta decidió no entregar el mensaje para mantener una interacción saludable en el ecosistema. | Esto podría deberse al límite de mensajes de marketing por usuario (lee más detalles aquí). Vuelve a intentarlo después de un tiempo. |
| 131051 | Tipo de mensaje no admitido Se intentó enviar un mensaje con un formato de plantilla (contenido multimedia u otra carga útil) que WhatsApp no admite. | Consulta los tipos de mensaje admitidos en la documentación de WhatsApp. |
f) Errores de contenido multimedia: Errores al gestionar archivos multimedia
| Código | Descripción | Posible solución |
| 131052 | Error al descargar contenido multimedia WhatsApp no puede descargar el contenido multimedia incluido en el mensaje del usuario de WhatsApp. | Se recomienda pedir al usuario que envíe el archivo multimedia por un canal que no sea WhatsApp. |
| 131053 | Error al subir contenido multimedia WhatsApp no pudo subir el contenido multimedia por motivos como los siguientes:
| Consulta la lista de formatos de archivo multimedia admitidos por WhatsApp |
g) Error de WhatsApp Flows: Problemas relacionados con la función WhatsApp Flows
| Código | Descripción | Posible solución |
| 100 | Un posible motivo podría ser alguno de los muchos que pueden surgir durante la gestión de Flows
| Proporciona un nombre válido y único, confirma el ID específico y la URL válida tal como se aplicó. Lee más sobre el manejo de errores |
| 139000 | Bloqueo por integridad Es posible que WhatsApp haya detectado problemas de integridad en la cuenta de empresa que impiden crear o publicar tus Flows | Comunícate con el soporte de Whatsapp o con tu proveedor de soluciones para resolver el problema. |
| 139001 | No se pueden actualizar los Flows No es posible actualizar los Flows después de publicarlos; si lo intentas, aparecerá este error. |
Clona el Flow, actualízalo y vuelve a publicarlo. Usa el Flow nuevo en lugar del anterior. |
| 139002 | Publicación de Flows con información incompleta Publicar Flows con información incompleta o incorrecta generará este error. Puede deberse a uno de los siguientes motivos:
|
Identifica los detalles que faltan en los flujos. Agrega la información pertinente con la solución adecuada y luego intenta publicar de nuevo. |
| 139003 | Retirar un flujo El error al intentar retirar un flujo podría deberse a los siguientes motivos
| Consulta esta guía sobre cómo retirar un flujo |
| 139004 | No se puede eliminar un flujo publicado Error al eliminar un flujo publicado, ya que no está permitido | Una vez publicado, un flujo no se puede eliminar. En su lugar, intenta retirarlo |
| 139006 | Umbral de métricas de flujos No hay datos suficientes para generar métricas del flujo | Espera a que haya suficientes datos en los flujos para generar métricas |
| 132068 | Flujo bloqueado La ejecución de los flujos de WhatsApp está bloqueada debido a infracciones de las políticas o a reportes de usuarios. | Revisa el flujo y verifica si hay infracciones de las políticas o un número excesivo de reportes de usuarios. |
| 132069 | Flujo limitado La capacidad de un flujo específico de WhatsApp para procesar mensajes se limitó temporalmente, ya que ya se enviaron 10 mensajes en 1 hora | Supervisa el rendimiento del flujo y corrígelo. Solicita ayuda al equipo de soporte de WhatsApp o a tu proveedor de soluciones. |
h) Otros errores diversos:
| Código | Descripción | Posible solución |
| 131000 | Algo salió mal No se pudo enviar el mensaje debido a un error desconocido | Vuelve a intentar la solicitud o comunícate con el equipo de soporte. Si es necesario, contacta a tu proveedor de soluciones de WhatsApp |
| 131005 | Acceso denegado WhatsApp no otorgó el permiso o lo revocó | Prueba estos pasos para solucionar el problema con esta guía. |
| 131008 | Falta el parámetro obligatorio: | Consulta la documentación de referencia del endpoint para determinar qué parámetros son obligatorios. |
| 131009 | El valor del parámetro no es válido | Proporciona solo parámetros admitidos. Consulta esta guía para revisar los tipos de parámetros admitidos. |
| 131016 | Servicio no disponible Un servicio de WhatsApp no está disponible temporalmente | Comunícate con tu proveedor de soluciones de WhatsApp para obtener más detalles o consulta el estado de la plataforma de WhatsApp Business aquí |
| 131021 | El destinatario no puede ser el remitente El remitente y el destinatario tienen el mismo número | Usa números diferentes para enviar el mensaje |
| 131037 | Falta el nombre para mostrar Para enviar mensajes, se necesita un nombre para mostrar aprobado en WhatsApp API. No se puede enviar el mensaje si el nombre para mostrar no está aprobado | Prueba cambiar el nombre para mostrar y obtener su aprobación siguiendo esta guía |
| 131042 | Problema de pago relacionado con los requisitos de elegibilidad de la empresa Se produjo un error con el método de pago vinculado a tu cuenta de WhatsApp Business. Entre las posibles causas se incluyen: superar el límite de crédito, no tener una cuenta de pago, no haber configurado el pago o la línea de crédito, etc. | Verifica los detalles de facturación y el método de pago en WhatsApp Manager para asegurarte de que la facturación esté configurada correctamente. |
| 131045 | Certificado incorrecto No se pueden enviar mensajes debido a un error en el registro del teléfono de la empresa | Intenta registrar de nuevo el número de teléfono y luego vuelve a intentarlo |
| 131057 | Cuenta en modo de mantenimiento | Comunícate con el equipo de soporte de WhatsApp o con tu proveedor de soluciones para obtener más detalles. |