Guías y Tutoriales

API de WhatsApp No Envía Mensajes: Errores Más Comunes y Cómo Resolverlos

Meta dice que tu negocio está verificado, pero los mensajes no salen. La revisión que conviene hacer primero, qué significa cada código de error y cómo saber si el problema está en tu configuración o en Meta.

Por Equipo Cercai
·
Octubre 2026
·
10 min de lectura

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.

  1. ¿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.
  2. ¿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.
  3. ¿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.
  4. ¿La cuenta de mensajes tiene medio de pago? Revisa también si la tarjeta está rechazando cobros.
  5. ¿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.
  6. ¿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ódigoQué significaCómo resolverlo
0No se pudo autenticar: el token venció o fue invalidadoGenera un token nuevo
190El token de acceso vencióUsa un token permanente de usuario del sistema
3, 10, 200-299Falta un permiso o fue retiradoRevisa el token con el depurador de tokens y los permisos de la app
100Parámetro incorrecto o ID que no calzaConfirma el ID del número y los parámetros del envío

Número y registro

CódigoQué significaCómo resolverlo
133010, 131045El número no está registradoRegístralo por API
133006Hay que verificar el número antes de registrarloVerifica la propiedad del número
133005PIN de verificación en dos pasos incorrectoUsa el PIN correcto o reinícialo
133016Demasiados intentos de registroEspera: son 10 solicitudes por número cada 72 horas
131037Número 555 sin nombre visible aprobadoCambia o aprueba el nombre visible

Mensajes y plantillas

CódigoQué significaCómo resolverlo
131047Pasaron más de 24 horas desde el último mensaje del clienteEnvía una plantilla
132001La plantilla no existe en ese idioma o no está aprobadaRevisa nombre, idioma y estado
132000No calza la cantidad de variablesEnvía todas las variables que define la plantilla
132015, 132016Plantilla pausada o deshabilitada por baja calidadEdítala o crea una nueva
131026No se pudo entregar: el número no usa WhatsApp o tiene una versión antiguaConfirma el número por otro canal

Pago, límites y cuenta

CódigoQué significaCómo resolverlo
131042Problema con el medio de pagoRevisa la cuenta de mensajes: método de pago, moneda y zona horaria
130429Se alcanzó el límite de velocidad de envíoBaja el ritmo y reintenta
131056Demasiados mensajes al mismo destinatario en poco tiempoEspera antes de reintentar con ese número
131048Restricción porque muchos mensajes fueron bloqueados o marcados como spamRevisa la calidad en el Administrador de WhatsApp
131031, 368Cuenta restringida o deshabilitada por una políticaRevisa 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.