Códigos de error en WhatsApp Business API
Cuando trabajas con WhatsApp Business API es común encontrar mensajes de error durante el envío de mensajes, plantillas o archivos. En esta guía te explicamos, de forma clara y sencilla, qué significa cada código y cómo puedes resolverlo para que tu operación continúe sin interrupciones.
| Código | Detalles | Posibles razones y soluciones | Código de estado HTTP |
| 1 API desconocida |
Solicitud inválida o posible error del servidor. | Consulta la página de Estado de la Plataforma Empresarial de WhatsApp para ver la información sobre el estado de la API. Si no hay caídas de servidor, revisa la referencia del endpoint y verifica que tu solicitud esté formateada correctamente y cumpla con todos los requisitos del endpoint. | 400 Mala petición |
| 2 Servicio API |
Temporal debido a tiempos de inactividad o a sobrecarga. | Consulta la página de estado de la plataforma empresarial de WhatsApp para ver la información sobre el estado de la API antes de intentarlo de nuevo. | 503 Servicio no disponible |
| 33 El valor del parámetro no es válido |
El número de teléfono de la empresa ha sido eliminado. | Verifica que el número de teléfono del negocio sea correcto. | 400 Mala petición |
| 100 Parámetro inválido |
La solicitud incluía uno o más parámetros no soportados o con errores ortográficos. | Consulta la referencia del endpoint para determinar qué parámetros están soportados y cómo se escriben. Para WhatsApp Flows con Endpoint, asegúrate al establecer la clave pública empresarial de que sea una clave pública RSA válida de 2048 bits en formato PEM. Asegúrate de que no haya discrepancia entre el número de teléfono que registras y el número de teléfono que tienes almacenado previamente. Asegúrate de que tu parámetro esté bajo cualquier restricción de longitud para el tipo. |
400 Mala petición |
| 130472 El número del usuario forma parte de un experimento |
El mensaje no se envió como parte de un experimento. | Véase Experimento de Mensaje de Marketing. | 400 Mala petición |
| 131008 Falta el parámetro requerido |
La petición carece de un parámetro requerido. | Consulta la referencia del endpoint para determinar qué parámetros se requieren. | 400 Mala petición |
| 131016 Servicio no disponible |
Un servicio está temporalmente inaccesible. | Consulta la página de estado de la plataforma empresarial de WhatsApp para ver la información sobre el estado de la API antes de intentarlo de nuevo. | 500 Error interno del servidor |
| 131021 El destinatario no puede ser el remitente |
El número de teléfono del remitente y del destinatario es el mismo. | Envía un mensaje a un número de teléfono diferente al del remitente. | 400 Mala petición |
| 131026 Mensaje no entregable |
No se puede entregar el mensaje. Las razones pueden incluir: El número de teléfono del destinatario no es un número de WhatsApp. El destinatario no ha aceptado nuestros nuevos Términos de Servicio ni Política de Privacidad. El destinatario usa una versión antigua de WhatsApp; debe usar la siguiente versión de WhatsApp o superior:Android: 2.21.15.15 SMBA: 21.21.15.15 iOS: 2.21.170.4 SMBI: 2.21.170.4 KaiOS: 2.2130.10 Web: 2.2132.6 |
Utilizando un método de comunicación que no sea WhatsApp, pide al usuario de WhatsApp que: Confirma que realmente pueden enviar un mensaje a tu número de teléfono de WhatsApp profesional. Confirma que han aceptado nuestros últimos Términos de Servicio (Configuración > Ayuda, o Configuración > La información de la solicitud les pedirá que acepten los últimos términos o políticas si aún no lo han hecho) Actualizar a la última versión del cliente de WhatsApp. |
400 Mala petición |
| 131045 Certificado incorrecto |
El mensaje no se pudo enviar debido a un error en el registro de un número de teléfono. | Registra el número de teléfono antes de intentarlo de nuevo. | 500 Error interno del servidor |
| 131047 Mensaje de reconexión |
Han pasado más de 24 horas desde la última respuesta del destinatario al número del remitente. | Envía al destinatario un mensaje plantilla en su lugar. | 400 Mala petición |
| 131049 Meta decidió no entregar. |
Este mensaje no se transmitió para mantener un compromiso saludable con los ecosistemas. | Si recibes este código de error y sospechas que se debe al límite, espera al menos 24 horas antes de volver a enviar el mensaje de la plantilla. Hacerlo solo resultará en otra respuesta de error, ya que el límite puede estar vigente en diferentes periodos de tiempo. Consulte los Límites de Mensajes de Plantillas de Marketing por Usuario para más información. |
400 Mala petición |
| 131050 El usuario ha dejado de recibir mensajes de marketing. |
Incapaz de transmitir el mensaje. Este destinatario ha decidido dejar de recibir mensajes de marketing en WhatsApp de tu empresa. | No intentes enviar mensajes a este usuario porque no serán recibidos. Para recibir notificaciones cada vez que un usuario de WhatsApp detenga o reanude la entrega de mensajes de plantilla de marketing desde tu negocio, suscríbete al user_preferences webhook. | 400 Mala petición |
| 131051 Tipo de mensaje no soportado |
Tipo de mensaje no soportado. | Consulta Mensajes para los tipos de mensaje compatibles antes de intentarlo de nuevo con un tipo de mensaje compatible. | 400 Mala petición |
| 131053 Error de subida de medios |
No se puede subir el contenido multimedia usado en el mensaje. | No pudimos subir el contenido por una o más razones, como un tipo de medio no soportado. Para más información, consulte el valor en cualquier mensaje que se activó webhooks cuando este mensaje no se envía.error.error_data.details Recomendamos que inspecciones cualquier archivo multimedia que esté causando errores y confirmes que realmente está soportado. Por ejemplo, en UNIX puedes usar la inspección de archivos a través de la línea de comandos para determinar su tipo MIME: file -I rejected-file.mov Entonces puedes confirmar si su tipo MIME es compatible. Ver Tipos de Medios Soportados. |
400 Mala petición |
| 131057 Cuenta en modo mantenimiento |
La cuenta de empresa está en modo mantenimiento | La cuenta de WhatsApp Business está en modo de mantenimiento. Una razón podría ser que la cuenta está en proceso de mejora en el rendimiento. | 500 Mala petición |
| 132007 Política de Formato de Plantilla Violada |
El contenido de la plantilla viola una política de WhatsApp. | Consulta nuestro documento de revisión de plantilla para conocer las posibles razones de la infracción. | 400 Mala petición |
| 132012 Desajuste en el formato de parámetros de plantilla |
Valores de parámetros variables formateados incorrectamente. | Los valores de parámetros variables incluidos en la solicitud no utilizan el formato especificado en la plantilla. Consulta nuestro documento de Plantillas para saber más sobre los parámetros y formatos de las plantillas. | 400 Mala petición |
| 132015 La plantilla está pausada |
La plantilla está pausada debido a la baja calidad, por lo que no puede enviarse en un mensaje de plantilla. | Edita la plantilla para mejorar su calidad y vuelve a intentarlo una vez aprobada. | 400 Mala petición |
| 132016 La plantilla está deshabilitada |
La plantilla se ha pausado demasiadas veces por baja calidad y ahora está permanentemente desactivada. | Crea una plantilla nueva con contenido diferente. | 400 Mala petición |
| 133004 Servidor temporalmente inaccesible |
El servidor está temporalmente no disponible. | Consulta la página de estado de la plataforma empresarial de WhatsApp para ver la información sobre el estado de la API y revisa el valor de respuesta antes de intentarlo de nuevo.details | 503 Servicio no disponible |
| 133006 Se necesita una nueva verificación del número de teléfono |
El número de teléfono debe ser verificado antes de registrarse. | Verifica y registra el número de teléfono. | 400 Mala petición |
| 133009 PIN de verificación en dos pasos Adivinado demasiado rápido |
El PIN de verificación de dos pasos se introdujo demasiado rápido. | Comprueba el valor de respuesta antes de intentarlo de nuevo.details | 400 Mala petición |
| 133010 Número de teléfono no registrado |
Número de teléfono no registrado en la plataforma WhatsApp Business. | Registra el número de teléfono antes de intentarlo de nuevo. | 400 Mala petición |
| 133015 Por favor, espere unos minutos antes de intentar registrar este número de teléfono |
El número de teléfono que intentas registrar fue eliminado recientemente, y aún no se ha completado. | Espera 5 minutos antes de volver a intentar la solicitud. | 400 Mala petición |
| 135000 Error genérico de usuario |
El mensaje no se pudo enviar debido a un error desconocido con los parámetros de tu solicitud. | Consulta la referencia del endpoint para determinar si estás consultando el endpoint usando la sintaxis correcta. Contacta con el servicio de atención al cliente si sigues recibiendo este código de error en respuesta. | 400 Mala petición |
Esta información está basada en la documentación oficial del equipo de Meta, la cual puedes encontrar en: Códigos de error en WhatsApp Business API
En esta guía encontrarás los códigos de error más comunes de WhatsApp Business API, junto con sus causas y soluciones prácticas. Está diseñada para ayudarte a identificar rápidamente cada error y resolverlo sin complicaciones, manteniendo tus envíos y operaciones funcionando con normalidad.