Por que Meta rechaza tus plantillas de WhatsApp (errores 131009 y 190) y como solucionarlo

Pocas cosas frustran tanto a un equipo como preparar una campana, pulsar enviar y toparse con un rechazo de plantilla de WhatsApp que no explica nada. Meta devuelve un codigo numerico, tu plataforma muestra un error crudo y la conversacion se corta. La buena noticia es que casi todos los rechazos caen en un punado de causas conocidas, y los dos codigos que mas veras (131009 y 190) tienen soluciones concretas. En esta guia los desglosamos y te damos un metodo para volver a operar rapido.

Que significa realmente un rechazo

Un rechazo puede ocurrir en dos momentos distintos y conviene no confundirlos:

• En la aprobacion de la plantilla: Meta revisa el contenido antes de permitir su uso. Si el texto viola politicas, tiene variables mal formadas o parece spam, queda en estado Rejected.
• En el envio del mensaje: la plantilla ya esta aprobada, pero la llamada a la API falla. Aqui aparecen los codigos como 131009 o 190.

Saber en cual de los dos estas te ahorra horas. Un 190 nunca se arregla editando el texto de la plantilla, y un rechazo de contenido no se arregla renovando un token.

Error 131009: valor de parametro no valido

El 131009 ("Parameter value is not valid") es el rey de los dolores de cabeza porque el mensaje es genesrico y la causa real casi siempre esta oculta. Las razones mas frecuentes:

1. IDs o titulos duplicados en botones y listas. Meta exige que los Reply Buttons, las filas de una List y los SKU de un catalogo sean unicos dentro del mismo mensaje. Dos botones con el mismo titulo o dos filas con el mismo id disparan un 131009 sin decir cual.
2. Numero de variables que no coincide. Si la plantilla tiene tres {{1}} {{2}} {{3}} y envias dos parametros, la validacion falla.
3. Formato de numero mal armado. El wa_id del destinatario debe ir en formato internacional. Prefijar con "+" y parsear sin asumir un pais por defecto evita errores en Mexico, Colombia o Argentina.
4. Componentes en orden incorrecto (header, body, buttons) o un boton URL dinamico sin su parametro.

El truco: cuando recibas un 131009, revisa primero la unicidad de botones y filas, luego el conteo de variables. En el 80% de los casos el problema esta ahi.

Error 190: el token de acceso expiro

El 190 (OAuthException) es mas simple de diagnosticar: si todos tus envios fallan de golpe con este codigo, no es tu plantilla, es tu token de acceso del canal que caduco. Los tokens de System User pueden expirar por rotacion de credenciales, cambio de permisos en la app de Meta o revocacion manual.

La solucion no es tocar la plantilla, sino reconectar el canal:

• Vuelve a ejecutar el Embedded Signup de WhatsApp para regenerar el token.
• Verifica que el System User de tu app Business tenga los permisos whatsapp_business_messaging y whatsapp_business_management.
• Si usas tokens de larga duracion, agenda una rotacion antes de la fecha de expiracion en vez de esperar el fallo.

Las causas de rechazo de contenido en la aprobacion

Cuando Meta marca la plantilla como Rejected durante la revision, suele ser por:

• Categoria equivocada. Un mensaje promocional enviado como Utility se rechaza. Elige Marketing, Utility o Authentication segun la intencion real.
• Variables al inicio o al final sin texto que las rodee, o dos variables seguidas.
• Lenguaje de floodeo o urgencia exagerada ("COMPRA YA", exceso de mayusculas o emojis).
• Placeholders sin contenido de ejemplo al someterla.

Como corregir y reenviar

Un flujo que funciona:

1. Identifica si el fallo es de aprobacion o de envio por el codigo.
2. Para 131009, corrige unicidad y variables; envia una prueba a un solo numero antes de la campana masiva.
3. Para 190, reconecta el canal y reintenta.
4. Para rechazo de contenido, ajusta categoria y redaccion, y reenvia a revision (suele tardar de minutos a 24 horas).

Una plataforma bien construida te evita gran parte de esto. En Omnifox la bandeja valida la unicidad de botones y el conteo de variables antes de tocar la API, y avisa cuando un canal necesita reconexion por token vencido, de modo que no descubres el 190 en plena campana.

Como prevenir rechazos futuros

• Manten un catalogo de plantillas ya aprobadas y reutilizalas.
• Nombra botones y filas con un esquema unico (por ejemplo, prefijo por seccion).
• Prueba cada plantilla nueva con un envio real antes de escalar.
• Vigila las metricas de calidad de tu numero; una calificacion baja aumenta los rechazos.

Conclusion

El rechazo de plantilla de WhatsApp deja de ser un misterio cuando distingues el momento del fallo y lees el codigo correcto: 131009 casi siempre es unicidad o variables, 190 es token expirado. Con un proceso de prueba antes de cada campana y una plataforma que valide por ti, los bloqueos se vuelven raros. Si quieres una bandeja que atrape estos errores antes de que Meta lo haga, prueba Omnifox y envia tus plantillas con red de seguridad.