Códigos de error de WhatsApp (Meta): qué significan y qué hacer
Tabla con los códigos de error de Meta más comunes al enviar por WhatsApp (131026, 131047, 131049, 130497, 141006, 131031, 131056, 132000, 190, 368…) y cómo resolver cada uno.
Cuando Meta rechaza un mensaje de WhatsApp, devuelve un código de error. Omnifox lo traduce y te dice qué pasó y qué hacer, pero conviene conocer los códigos más comunes: muchos no son fallas de Omnifox ni de tu canal, sino reglas de Meta sobre el cliente, la plantilla o la cuenta.
Dónde ves el error
- En la conversación: el mensaje que no salió queda marcado como fallido. Debajo verás un título, la explicación y la acción recomendada. Si abres el detalle técnico, aparece el código de Meta.
- En Configuración → Canales: cuando Meta restringe el número entero (por ejemplo, por un problema de pago), la tarjeta del canal muestra el aviso con el código.
- En Difusiones: cada destinatario fallido de una campaña muestra su motivo.
Tabla de códigos
| Código | Qué significa | Qué hacer |
|---|---|---|
| 131026 | Mensaje no entregable. El número no tiene WhatsApp, usa una versión muy vieja de la app, no aceptó los términos actuales de WhatsApp o no puede recibir mensajes de empresas. | Confirma el número con el cliente y pídele que actualice WhatsApp. Si sigue igual, contáctalo por otro canal. Reintentar no lo arregla. |
| 131047 | Pasaron más de 24 horas desde el último mensaje del cliente: la ventana de atención está cerrada. | Envía una plantilla aprobada. Cuando el cliente responda, vuelves a escribir libremente. |
| 131049 | Meta decidió no entregar el mensaje para cuidar la experiencia del usuario: limita cuántos mensajes de marketing recibe cada persona. | No lo reenvíes enseguida. Espera a que el cliente te escriba o inténtalo otro día. Si el mensaje es realmente transaccional (confirmación, recordatorio), usa una plantilla de Utilidad. |
| 130497 | Tu cuenta de WhatsApp Business no tiene permitido enviar a usuarios de ese país. Es una restricción de Meta sobre la cuenta, no sobre el mensaje. | Escríbenos para revisarlo. Mientras tanto, atiende a ese cliente por otro canal. |
| 141006 | Meta no pudo cobrar el método de pago de tu cuenta de WhatsApp Business. No es un problema de token. Se bloquean las conversaciones nuevas (plantillas y campañas); las respuestas dentro de las 24 h siguen saliendo. | Revisa y actualiza la forma de pago en Meta Business Suite (WhatsApp Manager → configuración de pagos). Si pagas los mensajes con el saldo de WhatsApp de Omnifox, revisa que tenga saldo y escríbenos. |
| 131042 | Igual que el anterior, pero visto en un mensaje concreto: Meta no pudo procesar el envío por un problema de pago. | Mismo arreglo que 141006. |
| 131031 | Meta bloqueó o restringió la cuenta de WhatsApp Business. Mientras dure, no sale ningún mensaje. | Entra a Meta Business Suite → WhatsApp Manager y revisa la calidad y el estado de la cuenta. Detrás suele haber un problema de pago (141006) o la verificación de empresa pendiente. Si crees que es un error, apela desde ahí. |
| 131056 | Demasiados mensajes al mismo número en poco tiempo. | Espera unos minutos antes de reintentar. Revisa que ningún workflow o agente de IA esté mandando mensajes en ráfaga a la misma persona. |
| 132000 | La cantidad de variables enviadas no coincide con las que espera la plantilla. | Completa todas las variables (cuerpo, encabezado y botones) antes de enviar. |
| 132001 | La plantilla no existe en ese idioma o no está aprobada. | Revisa el nombre, el idioma y el estado de la plantilla, y sincroniza las plantillas desde Meta. |
| 132012 | Una variable tiene un formato que Meta rechaza: saltos de línea, tabulaciones o más de 4 espacios seguidos, o un encabezado con un tipo de archivo distinto al aprobado. | Limpia el valor de las variables y usa en el encabezado el mismo tipo de archivo (imagen, video o documento) que se aprobó. |
| 190 | El token de acceso del canal venció o fue revocado (por ejemplo, alguien cambió la contraseña de Facebook o quitó permisos). Fallan todos los envíos del canal. | Reconecta el canal en Configuración → Canales. Omnifox revisa los tokens a diario y avisa a los administradores antes de que venzan. Si fallan todos tus canales a la vez y no tocaste nada, puede ser una caída de Meta: espera unos minutos antes de reconectar. |
| 368 | Bloqueo temporal por infringir las políticas de WhatsApp (por ejemplo, muchas denuncias o bloqueos de usuarios). | Espera a que termine el bloqueo y revisa la calidad de la cuenta en WhatsApp Manager. Para que no se repita: envía solo a contactos que aceptaron recibir mensajes y baja el volumen de marketing. |
| 131053 | Meta no aceptó el archivo adjunto por tamaño o formato. | Imágenes hasta 5 MB, video y audio hasta 16 MB, documentos hasta 100 MB. Usa JPG/PNG, MP4, MP3 o PDF. |
| 131048 | Meta limitó tu cuenta por volumen alto de envíos (posible spam). | Pausa las campañas y revisa la calificación de calidad en WhatsApp Manager. |
Problemas frecuentes
- El agente de IA responde, pero nada llega al cliente: mira el error del primer mensaje fallido. Si es 131031, 141006 o 190, el problema es de la cuenta o del canal, no del agente.
- Fallan solo los clientes de un país: casi siempre es 130497. Escríbenos.
- Fallan las plantillas, pero las respuestas sí salen: suele ser 141006 (pago) o una plantilla mal armada (132000, 132001, 132012).
- No encuentro el código: abre el detalle técnico del mensaje fallido; el número aparece ahí. Si es un código que no está en esta tabla, compártelo con soporte.
Artículos relacionados
- Solucionar errores comunes al conectar WhatsApp
- Recargar el saldo de WhatsApp (Meta) y entender los cargos por conversación
- Token de acceso de WhatsApp: qué es y cuándo expira
- Enviar una plantilla de WhatsApp desde una conversación (reabrir la ventana de 24 h)
- Categorías de plantillas de WhatsApp (Marketing, Utilidad, Autenticación) y por qué importan
- Sincronizar plantillas desde Meta
Artículos relacionados
-
Cómo conectar Telegram
Conecta un bot de Telegram a tu bandeja de Omnifox en pocos minutos usando BotFather.
-
Guía completa del Webchat (chat para tu sitio web)
El Webchat a fondo, en 32 capítulos: instalarlo, apariencia, idiomas, formulario, departamentos, horario, disparadores, IA, la bandeja, identificación segura y API de JavaScript, con un sitio real de punta a punta.
-
Pasar de WhatsApp por QR a Coexistence o Cloud API
Cuando termines de probar con el código QR, pasa tu número a la conexión oficial: sin topes, con plantillas, difusiones y sin riesgo de bloqueo por volumen.
-
Comentarios de Instagram y Facebook: responder y moderar desde Omnifox
Ve y responde los comentarios de tus publicaciones y anuncios de Facebook e Instagram, en público o en privado, y configura respuestas automáticas.
-
Enviar y recibir videos por cada canal: formatos y tamaños máximos
Qué videos puedes enviar y recibir por WhatsApp, Instagram, Messenger, Telegram, chat web y correo, con los tamaños máximos reales y qué hacer con un video pesado.