Si tu API de WhatsApp no envía mensajes y Meta dice que todo está bien, lo primero es separar dos cosas: que tu negocio esté verificado no significa que el número esté listo para enviar. Son estados distintos, y la mayoría de los errores de envío vienen de la configuración, no de un bloqueo.
Esta guía va en orden: primero la revisión rápida, después qué significa cada código de error en español y por último cómo reconocer un problema que no depende de ti. Está basada en la tabla oficial de errores de Meta, pensada para quien trabaja directo con Cloud API.
La revisión de 10 minutos antes de tocar el código
Revisa estos puntos en orden. Muchos casos se resuelven en el primero o el segundo.
- ¿La app apunta a la cuenta y al número correctos? En Meta for Developers, abre WhatsApp → Configuración de la API y confirma el número seleccionado. Un portafolio puede tener una cuenta de prueba y cuentas vacías junto a la real.
- ¿El número está registrado? Agregarlo en el Administrador de WhatsApp no alcanza: el registro se hace solo por API, con un PIN de 6 dígitos.
- ¿El token sigue vigente? El token de la página de pruebas dura poco. Para producción se usa un usuario del sistema con token permanente.
- ¿La cuenta de mensajes tiene medio de pago? Revisa también si la tarjeta está rechazando cobros.
- ¿Hay una plantilla aprobada en esa cuenta y en ese idioma? Para iniciar una conversación, el nombre y el código de idioma tienen que calzar exacto.
- ¿Business Support Home muestra restricciones? Si hay una infracción, ahí aparece el detalle.
¿Pasaste los seis puntos y sigue sin salir? Mándanos el código de error o una captura. Si calza con lo que hacemos, revisamos la cuenta y la conexión, y te decimos dónde está el problema.
Contar mi caso por WhatsApp →Qué significa cada código de error
Meta recomienda basar el manejo de errores en el campo code y en details, no en el título del mensaje. Estos son los que más vale la pena conocer:
Acceso y permisos
| Código | Qué significa | Cómo resolverlo |
|---|---|---|
| 0 | No se pudo autenticar: el token venció o fue invalidado | Genera un token nuevo |
| 190 | El token de acceso venció | Usa un token permanente de usuario del sistema |
| 3, 10, 200-299 | Falta un permiso o fue retirado | Revisa el token con el depurador de tokens y los permisos de la app |
| 100 | Parámetro incorrecto o ID que no calza | Confirma el ID del número y los parámetros del envío |
Número y registro
| Código | Qué significa | Cómo resolverlo |
|---|---|---|
| 133010, 131045 | El número no está registrado | Regístralo por API |
| 133006 | Hay que verificar el número antes de registrarlo | Verifica la propiedad del número |
| 133005 | PIN de verificación en dos pasos incorrecto | Usa el PIN correcto o reinícialo |
| 133016 | Demasiados intentos de registro | Espera: son 10 solicitudes por número cada 72 horas |
| 131037 | Número 555 sin nombre visible aprobado | Cambia o aprueba el nombre visible |
Mensajes y plantillas
| Código | Qué significa | Cómo resolverlo |
|---|---|---|
| 131047 | Pasaron más de 24 horas desde el último mensaje del cliente | Envía una plantilla |
| 132001 | La plantilla no existe en ese idioma o no está aprobada | Revisa nombre, idioma y estado |
| 132000 | No calza la cantidad de variables | Envía todas las variables que define la plantilla |
| 132015, 132016 | Plantilla pausada o deshabilitada por baja calidad | Edítala o crea una nueva |
| 131026 | No se pudo entregar: el número no usa WhatsApp o tiene una versión antigua | Confirma el número por otro canal |
Pago, límites y cuenta
| Código | Qué significa | Cómo resolverlo |
|---|---|---|
| 131042 | Problema con el medio de pago | Revisa la cuenta de mensajes: método de pago, moneda y zona horaria |
| 130429 | Se alcanzó el límite de velocidad de envío | Baja el ritmo y reintenta |
| 131056 | Demasiados mensajes al mismo destinatario en poco tiempo | Espera antes de reintentar con ese número |
| 131048 | Restricción porque muchos mensajes fueron bloqueados o marcados como spam | Revisa la calidad en el Administrador de WhatsApp |
| 131031, 368 | Cuenta restringida o deshabilitada por una política | Revisa Business Support Home y evalúa pedir revisión |
24 horas
La ventana para responder con texto libre desde el último mensaje del cliente
10 cada 72 h
Solicitudes de registro permitidas por número antes del error 133016
1.000
Mensajes de servicio gratis al mes por número, según la tarifa vigente de Meta
La trampa más común: todo funciona, pero en la cuenta de prueba
Al partir en Meta for Developers, la plataforma crea una cuenta de prueba, un número de prueba y plantillas de ejemplo. Todo funciona, y por eso es fácil construir encima sin notar que nunca se pasó al número real.
Un número de prueba solo llega a destinatarios autorizados; si le escribes a otro, normalmente verás un mensaje como Recipient phone number not in allowed list. Y ese número no se puede migrar: hay que agregar uno real, verificarlo y registrarlo.
Tres señales de que te pasó esto:
- El número real aparece conectado, pero con 0 mensajes enviados y recibidos.
- Tus plantillas están en la cuenta de prueba, no en la real.
- El número que envía empieza con +1 555.
Si tu sistema quedó armado sobre la cuenta de prueba, falta el último tramo. Te lo dejamos conectado al número real, con token permanente, webhook y un primer mensaje enviado de verdad. Tu desarrollador sigue a cargo de la lógica.
Ver qué incluye la conexión →Cuenta de WhatsApp y cuenta de mensajes: por qué hay dos
Meta separó las cuentas en dos tipos. Según su documentación, la cuenta de WhatsApp tiene el número de teléfono y la cuenta de mensajes guarda las plantillas y la facturación. Se necesitan las dos para enviar.
Esto explica varios errores raros: una plantilla que existe en una cuenta pero no en la que usa tu app, un número sin método de pago asociado, o una cuenta creada en un intento anterior que quedó vacía. Si trabajas con un proveedor, también hay que compartirle ambas cuentas: con una sola, el envío no funciona.
Que la API acepte el envío no significa que llegó
Un error importante de diseño es mirar solo la respuesta de la API. Algunos errores llegan al momento y otros después, por webhook. Por eso conviene escuchar ambos canales y guardar el estado de cada mensaje.
Esto también importa para la cuenta: Meta cobra solo los mensajes entregados, y una plantilla mal configurada puede dejarte sin envíos sin que nadie lo note, si el sistema no registra los errores.
Cuándo el problema no está en tu configuración
Hay casos que no se arreglan tocando el código:
- Restricción por política. Según las reglas de Meta, puede ir desde un bloqueo de 1 a 3 días en plantillas hasta 30 días sin enviar nada, o un bloqueo indefinido que solo se levanta con apelación. La revisión se pide en Business Support Home y la respuesta suele tardar entre 24 y 48 horas, aunque no todas las infracciones por spam se pueden apelar.
- Caída de la plataforma. Si aparecen errores como 1, 2, 131016 o 133004, revisa la página de estado de la plataforma de WhatsApp Business antes de cambiar nada.
- Baja calidad. Si los clientes bloquean o reportan tus mensajes, la solución está en a quién le escribes y qué le dices, no en la API.
Si el problema empezó antes, en la aprobación de la empresa, revisa la guía de verificación de negocio en Meta. Para el servicio completo, con precios, está nuestra página de API de WhatsApp Business en Chile. Y si lo que quieres es saber qué se puede construir encima, parte por cómo automatizar WhatsApp en tu empresa.
Preguntas frecuentes
¿Por qué la API de WhatsApp no envía mensajes si mi negocio está verificado?
Porque la verificación y el envío son cosas distintas. Un negocio verificado igual puede fallar por un token vencido, una app apuntando a la cuenta de prueba, un número sin registrar, una plantilla que no existe en ese idioma o un problema con el medio de pago.
¿Qué significa el error 131042 en la API de WhatsApp?
Es un error relacionado con el medio de pago. Las causas más comunes son una cuenta de mensajes sin método de pago, una línea de crédito sobre el límite o una tarjeta rechazada. Se revisa en la configuración de pago de la cuenta de mensajes.
¿Qué significa el error 131047?
Que pasaron más de 24 horas desde el último mensaje del cliente. Fuera de esa ventana no se puede enviar texto libre: hay que usar una plantilla aprobada.
¿Qué significa el error 131031 o el 368?
Que la cuenta tiene una restricción por infringir una política. El 131031 también puede aparecer cuando un dato de la solicitud no calza, como el PIN de verificación en dos pasos. La infracción y las opciones de revisión aparecen en Business Support Home.
¿Puedo pasar el número de prueba de Meta a producción?
No. Los números de prueba no se migran. Hay que agregar un número real, verificar que es tuyo y registrarlo por API. Las plantillas de la cuenta de prueba tampoco pasan solas a la cuenta real.
¿Cuántas veces puedo registrar un número en Cloud API?
Meta permite 10 solicitudes de registro por número en una ventana móvil de 72 horas. Si te pasas, recibes el error 133016 y el número queda bloqueado para registrarse durante las siguientes 72 horas, así que conviene no reintentar a ciegas.