Códigos de error de WhatsApp API: qué significa cada uno y cómo resolverlo

2. Errores de entrega: cuando falla un contacto puntual

Son los más comunes y los menos graves: afectan a un destinatario, no a tu número. Si en una campaña de 500 envíos te aparecen 10 o 15 de estos, es normal.

3. Errores de cuenta: los más caros y los más difíciles de detectar

Acá están los dos códigos que pueden dejarte semanas sin vender por WhatsApp sin que nada en tu pantalla se ponga rojo. Cuando alguno de estos está activo, falla el 100 % de tus envíos: no es culpa del destinatario ni de la plantilla.

Un número puede tener la calidad en VERDE y estar completamente bloqueado al mismo tiempo. Son dos indicadores distintos que miden cosas distintas.

4. El dato que casi nadie mira: el estado de salud de tu cuenta

Meta expone un indicador poco conocido que responde directamente la pregunta que importa: ¿este número puede enviar mensajes hoy? Tiene tres valores y conviene conocerlos, porque explican la mayoría de los "no entiendo por qué no salen mis campañas".

5. Errores de plantilla: 132012, 132018, 131009, 131008 y 138000

Esta familia es 100 % configuración tuya. La buena noticia: son los más fáciles de arreglar. La mala: reintentarlos sin corregir nada falla otra vez, siempre. Si lanzaste una campaña y fallaron los 500 destinatarios con el mismo código, mirá acá.

6. Límites de envío: cuántas conversaciones podés iniciar por día

Los límites de WhatsApp no cuentan mensajes: cuentan conversaciones nuevas iniciadas por vos con clientes distintos en una ventana móvil de 24 horas. Responderle a alguien que te escribió no consume ese cupo, y esa distinción cambia por completo cómo conviene planificar una campaña.

Todo número nuevo arranca en el escalón más bajo y va subiendo solo, sin que tengas que pedir nada:

• Para subir de escalón necesitás dos cosas al mismo tiempo: calidad del número en verde (o al menos no en rojo) y haber usado una parte importante de tu cupo actual en los últimos días. Si tenés 250 y mandás 20 por día, no vas a subir nunca: Meta no ve la necesidad.
• La verificación de empresa es el techo invisible: sin ella, tu cuenta queda topeada en 250 aunque el volumen justifique más. Es el trámite que más veces vimos pendiente y el que más rápido destraba crecimiento.
• Hay un segundo límite, el de velocidad: además del tope diario existe un máximo de mensajes por segundo (hasta 80 en las cuentas más grandes, y bastante menos si conectaste tu número conservando la app de WhatsApp Business en el celular). Por eso una campaña grande no sale toda de golpe: se envía de a tandas, a propósito.
• El límite es de la cuenta, no del número: desde fines de 2025 Meta lo calcula a nivel de la cuenta comercial completa. Si tenés varios números bajo la misma cuenta, comparten el mismo presupuesto diario.

7. Calidad del número: verde, amarillo y rojo

Meta le pone un semáforo a cada número según lo que hacen los usuarios con tus mensajes en los últimos siete días: cuántos te bloquean, cuántos te reportan y cuántos interactúan.

8. La ventana de 24 horas, explicada sin vueltas

Casi todos los errores de esta guía se entienden mejor con esta regla: cuando un cliente te escribe, se abre una ventana de 24 horas durante la cual podés responderle lo que quieras, con el texto que quieras, sin costo de plantilla.

Pasadas esas 24 horas, la ventana se cierra. A partir de ahí solo podés escribirle con una plantilla aprobada por Meta. Si intentás mandarle texto libre, el mensaje falla (ese es el 131047). Cada vez que el cliente responde, la ventana se reinicia.

De ahí salen dos consecuencias prácticas que conviene tener grabadas:

• Responder es gratis e ilimitado, iniciar no: contestarle a alguien que te escribió no consume tu cupo diario ni te expone a límites de frecuencia. El presupuesto se gasta solo cuando arrancás vos la conversación.
• Una base "fría" es la receta del desastre: mandarle plantillas a gente que nunca te escribió es lo que dispara bloqueos, reportes, caída de calidad y, en el peor caso, el 131031. Si conseguiste los números por otro canal, arrancá de a poco y con mensajes que el cliente esté esperando recibir. Si venís de la app común, conviene hacer el pasaje conectando tu WhatsApp Business a la API sin perder tus chats.

9. ¿Cuáles conviene reintentar y cuáles no?

Reintentar un error permanente no solo no sirve: gasta cupo, ensucia tus métricas y, si es marketing, empeora tu calidad. Esta es la regla rápida.

10. Checklist para que no te pase

La enorme mayoría de los errores de esta guía se evitan con seis decisiones que se toman una sola vez:

• Hacé la verificación de empresa en Meta: destraba el techo de 250 conversaciones diarias y es requisito para escalar. Es el punto con mejor relación esfuerzo/beneficio de toda la lista.
• Configurá el método de pago y la moneda: sin eso, Meta rechaza todo lo que inicies (131042) y tarde o temprano llega el bloqueo.
• Escribile primero a quien ya te escribió: una base tibia entrega mejor, se queja menos y sube tu calidad en lugar de hundirla.
• Segmentá en lugar de mandar a todos: el volumen sin criterio es lo que dispara los bloqueos. Menos envíos mejor apuntados rinden más y no te queman el número.
• Probá cada plantilla con un contacto real antes de la campaña: un solo envío de prueba te ahorra descubrir el 132012 después de quemar 500 destinatarios.
• Mirá los no entregados, no solo los enviados: si tu herramienta no te muestra el motivo de cada fallo en castellano, estás volando a ciegas. El código está siempre; lo que falta suele ser quien lo traduzca.

Preguntas frecuentes sobre errores y límites de la API de WhatsApp

Las consultas que más nos llegan sobre códigos de error, límites de envío y mensajes que no llegan en WhatsApp Business API.

• ¿Qué significa el error 131049 de WhatsApp? Que WhatsApp no entregó ese mensaje para cuidar la experiencia del usuario: esa persona ya recibió demasiadas plantillas de marketing en poco tiempo. Es un tope por contacto, no una sanción a tu número, y solo afecta a la categoría marketing. Podés reintentar más adelante, idealmente después de 24 horas. Si el 131049 aparece todos los días y en aumento, es señal de que estás saturando tu base.
• ¿Qué significa el error 131026 en WhatsApp? Que el mensaje no se puede entregar a ese número: no tiene WhatsApp, está mal cargado o no puede recibir mensajes. No sirve reintentar; hay que corregir el número o sacarlo de la base. Es el error más común cuando se importan contactos desde una planilla.
• ¿Qué significa el error 131031 y cómo lo destrabo? Es "Business Account locked": Meta bloqueó tu cuenta de WhatsApp Business y ningún mensaje va a salir hasta destrabarla. Se resuelve en Meta Business Manager, en Configuración de la empresa y Estado de la cuenta, donde ves el motivo y podés pedir una revisión. Las causas más frecuentes son enviar a listas frías, no completar la verificación de empresa cuando Meta la pidió, o manejar temas sensibles como cobranzas o pedidos de pago por chat.
• ¿Qué significa el error 131042 de WhatsApp? Que falta configurar el método de pago o la moneda de tu cuenta de WhatsApp Business. Mientras esté activo, Meta rechaza todas las conversaciones que inicies vos, aunque puedas seguir respondiendo a quien te escribe. Se arregla en Meta Business Manager, en Configuración de pagos, y suele ser cuestión de minutos.
• ¿Por qué mi campaña dice "enviado" pero el cliente no recibió nada? Porque "enviado" solo significa que Meta aceptó el pedido, no que lo entregó. El rechazo llega después, por una notificación separada. Si tu plataforma no procesa esa notificación, vas a ver campañas con "0 fallidos" que en realidad no llegaron a nadie. Buscá el detalle de no entregados y el código de error de cada mensaje.
• ¿Qué es un mensaje iniciado por la empresa? Es cualquier conversación que arrancás vos y no el cliente: una campaña, un recordatorio de turno, un aviso de pago. Solo estos consumen tu límite diario y solo estos requieren una plantilla aprobada cuando la ventana de 24 horas está cerrada. Responder a alguien que te escribió no cuenta.
• ¿Cómo funciona la ventana de 24 horas de WhatsApp? Cuando un cliente te escribe se abre una ventana de 24 horas en la que podés responderle libremente, con el texto que quieras y sin plantilla. Cuando se cierra, solo podés contactarlo con una plantilla aprobada por Meta; si intentás mandar texto libre, el envío falla con el código 131047. Cada respuesta del cliente reinicia la ventana.
• ¿Cuántas conversaciones puedo iniciar por día con un número nuevo? Un número nuevo arranca en 250 conversaciones nuevas por día con clientes distintos. Después sube solo a 1.000, 10.000, 100.000 y finalmente sin límite, siempre que la calidad esté bien y estés usando una parte importante del cupo actual. Responder a quien te escribe no consume ese cupo.
• ¿Por qué mi límite sigue en 250 aunque envío todos los días? Casi siempre porque falta la verificación de empresa en Meta. Sin ese trámite, la cuenta queda topeada en el escalón más bajo aunque tu volumen justifique más. Es el techo invisible más común: cuando auditamos números conectados, la mayoría de los que estaban limitados lo estaban por esta razón.
• ¿Qué hace que Meta me baje el límite de mensajes? Que los usuarios te bloqueen o te reporten. Eso baja la calidad de tu número a amarillo y después a rojo, y Meta responde reduciendo tu escalón. Los detonantes típicos son enviar a bases frías, repetir el mismo mensaje promocional muchas veces y escribir a horarios molestos.
• Mi calidad está en verde, ¿significa que mi cuenta está bien? No necesariamente. La calidad mide qué opinan los usuarios de tus mensajes; los bloqueos de cuenta (131031) y los problemas de pago (131042) son otro eje. Es más: una cuenta bloqueada no entrega nada, nadie la reporta y por eso la calidad se queda en verde. El verde puede ser engañoso justamente cuando estás caído.
• ¿Por qué falla la plantilla si en la vista previa se ve perfecta? Porque la vista previa muestra el texto, pero Meta valida el envío completo contra la plantilla tal como la aprobó. Si la plantilla tiene encabezado de imagen, PDF o video, todos los envíos deben incluir ese archivo: si falta, falla con 132012. Lo mismo pasa con variables que traen saltos de línea o espacios de más, que devuelven 131009.
• ¿Puedo enviar plantillas de marketing a Estados Unidos? Meta aplicó restricciones al envío de plantillas de marketing a números de Estados Unidos, manteniendo habilitados los mensajes de utilidad, los de autenticación y las respuestas dentro de la ventana de 24 horas. Si tu público está en Argentina no te afecta, pero conviene verificar el estado vigente antes de una campaña internacional.
• ¿Dónde veo el estado y el límite de mi número? En WhatsApp Manager, dentro de Meta Business Manager, encontrás el escalón de envío, la calidad y el estado de la cuenta. Si operás con una plataforma como Basework, esos datos aparecen dentro del panel junto con el motivo traducido de cada mensaje no entregado, sin necesidad de entrar a Meta.