> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nubea.com.ar/llms.txt
> Use this file to discover all available pages before exploring further.

# Errores de envío de WhatsApp: qué significa cada uno

> Diccionario de los errores que aparecen en el reporte de tus automatizaciones y campañas de WhatsApp — qué significa cada mensaje de Meta y qué hacer con cada uno.

Cuando una automatización o campaña de WhatsApp falla, Nubea guarda el motivo
en el **reporte**. Esta página es el diccionario: buscá el texto que te aparece
y vas a encontrar qué significa y qué hacer.

<Note>
  **Dónde ver el error:** panel → **Automatizaciones** (o **Campañas**) → click
  en la automatización/campaña → **Reporte**. Cada fila muestra el estado
  (**Enviado**, **Entregado**, **Leído**, **Fallido**) y, en los fallidos, el
  **motivo**. Ese texto es el que buscás acá abajo.
</Note>

<Tip>
  Usá `Ctrl/Cmd + F` y pegá el texto exacto del error para saltar directo a la
  explicación.
</Tip>

***

## "Requiere actualización" — la causa #1 de que no puedas enviar

Si al lado de una automatización ves el cartel amarillo **Requiere
actualización** y no te deja confirmarla ni probarla, con este texto:

> *Esta automatización usa un mensaje de texto que no es compatible con la API
> Oficial. Editala para seleccionar un mensaje aprobado.*

o este otro:

> *Esta automatización está vinculada a un mensaje que ya no está disponible en
> tu cuenta de WhatsApp actual. Editala y seleccioná un mensaje actualizado.*

**Qué pasó:** tu tienda está conectada con **WhatsApp Oficial** (Número de
Nubea, Coexistencia o Número Dedicado). La API Oficial de Meta **solo permite
enviar plantillas (templates) aprobadas** — no permite mensajes de texto libre.
Esa automatización todavía tiene cargado un mensaje de texto viejo (de cuando
usabas QR) o un mensaje que quedó fuera de tu cuenta actual, y por eso queda
trabada.

<Warning>
  No es una caída ni un bug: es un requisito de Meta. Mientras la automatización
  diga **Requiere actualización**, no envía nada.
</Warning>

**Cómo arreglarlo:**

<Steps>
  <Step title="Creá tus plantillas de mensaje">
    Panel → click en el nombre de tu marca (abajo a la izquierda) →
    **Configuración de WhatsApp** → **Plantillas**. Creá una plantilla para cada
    automatización que uses (carrito, pago pendiente, etc.).
  </Step>

  <Step title="Esperá la aprobación de Meta">
    Cada plantilla queda en **Pendiente** hasta que Meta la revisa (normalmente
    de 1 a 24 h). Cuando pasa a **Aprobada**, ya se puede usar.
  </Step>

  <Step title="Editá la automatización y elegí la plantilla aprobada">
    Entrá a la automatización → pestaña **Mensaje** → seleccioná la plantilla
    aprobada → guardá. El cartel **Requiere actualización** desaparece y la
    automatización vuelve a enviar.
  </Step>
</Steps>

<Note>
  Si usás el **Número de Nubea** (el número compartido), **no** necesitás
  configurar un número propio ni verificar nada: ya estás en la API Oficial.
  Solo te falta crear las plantillas y esperar la aprobación. Más detalle en
  [conectar la API Oficial](/guias/conectar-api-oficial).
</Note>

***

## "Mensaje pendiente de aprobación"

> *Este mensaje está pendiente de aprobación por Meta. La automatización no
> enviará mensajes hasta que sea aprobado.*

**Qué pasó:** creaste la plantilla pero Meta todavía no la aprobó. No hay nada
roto — hay que esperar.

**Cómo arreglarlo:** esperá 1-24 h. Si pasadas 24 h sigue en **Pendiente** o la
rechazaron, revisá el copy (menos lenguaje promocional, sin exceso de mayúsculas
ni signos de exclamación, links con contexto) y reenviala a aprobación.

***

## Errores mensaje por mensaje (en el reporte)

Estos aparecen por contacto, en la columna de motivo de los envíos **Fallidos**.

### No es un problema tuyo — se resuelven solos

<AccordionGroup>
  <Accordion title="WhatsApp decidió no entregar este mensaje de marketing para cuidar la experiencia del usuario. Probá más tarde o con otro contenido.">
    Es un **tope de frecuencia de Meta** (error 131049): Meta limita cuántos
    mensajes de **marketing** recibe cada persona por día, **sumando todas las
    empresas** que le escriben — no solo la tuya. Si un cliente ya recibió mucho
    marketing de otras marcas, Meta retiene el tuyo.

    **Qué hacer:** nada. No es un bug, ni un bloqueo de tu número, ni un problema
    de calidad. Se resuelve solo cuando se libera el cupo de esa persona. Los
    mensajes que fallan **no se te cobran**. Aparece sobre todo en **carrito
    abandonado**: la única palanca que tenés es enviar el mensaje **más
    temprano** tras el abandono (cuanto más frío el contacto, más chance de estar
    topeado).
  </Accordion>

  <Accordion title="Meta no entregó este mensaje porque el número está en un experimento de marketing de Meta. No es un problema de tu cuenta.">
    Error 130472. Meta a veces retiene mensajes a ciertos números para medir el
    impacto de la publicidad (un "grupo de control"). **No hay nada que
    arreglar** y no se te cobra.
  </Accordion>

  <Accordion title="WhatsApp limitó los envíos por exceso de mensajes. Esperá un rato antes de reintentar.">
    Error 131048 (spam rate limit): mandaste muchos mensajes muy seguido y Meta
    frenó el ritmo. **Qué hacer:** esperá un rato; el sistema reintenta. Si pasa
    seguido en campañas grandes, dividí el envío en tandas.
  </Accordion>

  <Accordion title="Demasiados mensajes seguidos al mismo número. WhatsApp limita 1 cada 6 segundos.">
    Error 131056. Le mandaste varios mensajes al mismo contacto en muy poco
    tiempo. **Qué hacer:** nada puntual; es una protección de Meta y se acomoda
    sola.
  </Accordion>

  <Accordion title="Se superó el ritmo de envíos permitido por WhatsApp.">
    Error 130429 (throughput). Se juntaron muchos envíos en el mismo momento.
    **Qué hacer:** se reintenta automáticamente; no requiere acción.
  </Accordion>
</AccordionGroup>

### Necesitan una acción tuya

<AccordionGroup>
  <Accordion title="WhatsApp rechazó el envío por un problema de facturación en tu cuenta de WhatsApp Business (falta o venció el método de pago).">
    Error 131042. Meta rechaza **todos** los envíos porque tu cuenta de WhatsApp
    Business tiene un problema de pago. **Qué hacer:** entrá al **Administrador
    de Meta** (business.facebook.com) → **Configuración de pagos** de WhatsApp y
    cargá/actualizá un método de pago. Cuando quede al día, los envíos se
    reanudan. (No aplica al Número de Nubea, que ya viene con facturación
    resuelta.)
  </Accordion>

  <Accordion title="La conexión con WhatsApp expiró. Reconectá tu cuenta.">
    El token de la conexión venció o se revocó. **Qué hacer:** panel →
    **Configuración de WhatsApp** → **Reconectar**. Si es QR, reescaneá el
    código. Más detalle en
    [errores al conectar WhatsApp](/guias/errores-conectar-whatsapp).
  </Accordion>

  <Accordion title="El mensaje (template) todavía no fue aprobado por Meta. Esperá la aprobación para que se envíe.">
    La plantilla que usa esa automatización/campaña está en **Pendiente**.
    **Qué hacer:** esperá la aprobación (1-24 h). Ver
    ["Mensaje pendiente de aprobación"](#mensaje-pendiente-de-aprobación) arriba.
  </Accordion>

  <Accordion title="El mensaje (template) ya no existe en tu cuenta de WhatsApp. Editá la automatización y elegí un mensaje actualizado.">
    La plantilla fue eliminada en Meta o quedó de una conexión anterior.
    **Qué hacer:** editá la automatización → pestaña **Mensaje** → elegí una
    plantilla aprobada de tu cuenta actual.
  </Accordion>

  <Accordion title="El mensaje pertenece a otra conexión de WhatsApp. Editá la automatización y seleccioná un mensaje de tu cuenta actual.">
    La plantilla es de un número/cuenta distinto al que tenés conectado ahora
    (por ejemplo, cambiaste de número). **Qué hacer:** editá la automatización y
    seleccioná una plantilla de la cuenta actual.
  </Accordion>

  <Accordion title="Faltan parámetros del template: …">
    Tu plantilla tiene variables (por ejemplo `{{nombre}}` o `{{cupón}}`) que no
    se pudieron completar. **Qué hacer:** editá la plantilla y asegurate de que
    cada variable tenga un valor asignado, o sacá las variables que no uses.
  </Accordion>

  <Accordion title="El número de teléfono del cliente está vacío o tiene un formato inválido.">
    Ese cliente no dejó teléfono en el checkout, o lo dejó en un formato que no
    se puede normalizar (sin código de país, con letras, etc.). **Qué hacer:**
    no se recupera hacia atrás. Para adelante, en Tiendanube podés hacer el
    teléfono **obligatorio** en el checkout (panel de Tiendanube →
    **Configuración** → **Checkout**). Para campañas, usá el formato
    `5491112345678`.
  </Accordion>

  <Accordion title="El número no está registrado en WhatsApp.">
    Error 131026. Ese teléfono no tiene WhatsApp. **Qué hacer:** nada — ese
    contacto simplemente no puede recibir el mensaje.
  </Accordion>

  <Accordion title="Pasaron más de 24 horas desde el último contacto. Solo se puede enviar con un template aprobado.">
    Error 131047 (ventana de 24 h). En la API Oficial, fuera de las 24 h desde el
    último mensaje del cliente solo se puede enviar con **plantilla aprobada** y
    con **opt-in** del contacto. **Qué hacer:** usá una plantilla de Marketing
    aprobada y enviá solo a contactos que aceptaron recibir tus mensajes.
  </Accordion>

  <Accordion title="No se entregó: hay un bloqueo entre tu cuenta de WhatsApp y este número.">
    Error 130403. Hay un bloqueo entre tu WhatsApp Business y ese contacto (uno
    bloqueó al otro). **Qué hacer:** nada del lado de Nubea; ese contacto no
    puede recibir tus mensajes hasta que se desbloquee.
  </Accordion>
</AccordionGroup>

### Graves: revisá el estado en el Administrador de Meta

<AccordionGroup>
  <Accordion title="Tu cuenta de WhatsApp fue restringida temporalmente por Meta por políticas.">
    Error 368 / restricción por políticas. Meta limitó tu número por un problema
    de comportamiento o políticas. **Qué hacer:** entrá al **Administrador de
    Meta** → **WhatsApp Manager** y revisá el estado y la calidad del número.
    Bajá el ritmo de envíos y revisá las
    [mejores prácticas de WhatsApp](/guias/mejores-practicas-whatsapp).
  </Accordion>

  <Accordion title="La cuenta de WhatsApp está bloqueada por Meta.">
    Error 131031. **Qué hacer:** revisá el estado en el Administrador de Meta.
    Si no ves el motivo, escribinos a
    [ayuda@nubea.com.ar](mailto:ayuda@nubea.com.ar) y lo miramos juntos.
  </Accordion>

  <Accordion title="Tu cuenta de Business no está verificada.">
    Error 131045. Falta verificar tu cuenta de negocio en Meta. **Qué hacer:**
    completá la verificación de negocio en el Administrador de Meta.
  </Accordion>
</AccordionGroup>

***

## "Se envió a 250 y la campaña se pausó sola"

**No es un error.** Los números nuevos, de coexistencia o sin verificar tienen
un tope de **250 conversaciones de marketing por día** que impone Meta. Cuando
tu campaña llega a ese tope, Nubea la **pausa automáticamente** y la **reanuda
sola** al día siguiente, hasta terminar toda la lista.

**Qué hacer:** nada. Una lista de, por ejemplo, 1.000 contactos se completa en
\~4 días, sola. El tope sube a medida que tu número gana reputación con Meta.
Si necesitás más volumen ya, mirá
[ampliar el límite de mensajes](/guias/ampliar-limite-mensajes).

<Warning>
  Si en cambio **cancelaste** la campaña (no se pausó por el tope), esa **no** se
  reanuda sola: hay que crear una nueva. Ojo con las campañas con fecha (invitación
  a un evento): si la lista es más grande que tu tope diario, puede seguir
  enviándose después del evento.
</Warning>

***

## "Meta marcó mi número como spam" o me lo restringieron

Si recibís de Meta una alerta de "actividad de spam" o te bajan la **calidad**
(Quality rating a **Medium**/amarillo o **Low**/rojo), es por el
**comportamiento del número**, no por Nubea: reportes o bloqueos de destinatarios,
envíos a gente que no dio opt-in, velocidad de envío, o envíos manuales/otras
herramientas desde el mismo número.

**Qué hacer:**

* Pausá las campañas masivas unos días.
* Limpiá la audiencia: sacá contactos fríos, listas compradas y quienes nunca
  interactuaron.
* Mejorá el copy (menos promocional, más informativo).
* Si estás en **QR**, el propio método no oficial es un factor de riesgo para
  Meta: la recomendación es migrar a **API Oficial** con plantillas aprobadas y
  opt-in.

Más en [mejores prácticas de WhatsApp](/guias/mejores-practicas-whatsapp).

***

## ¿Seguís con el problema?

Si el error que ves no está en esta lista, o ya hiciste lo que dice y no se
resuelve, escribinos por el asistente de WhatsApp o a
[ayuda@nubea.com.ar](mailto:ayuda@nubea.com.ar) con una captura del reporte.

<CardGroup cols={2}>
  <Card title="Una automatización no envía" icon="bolt-slash" href="/guias/troubleshooting/automatizacion-no-envia">
    Si no sale ningún mensaje, empezá por el árbol de causas.
  </Card>

  <Card title="Una campaña no llega" icon="megaphone" href="/guias/troubleshooting/campana-no-llega">
    Fallos masivos en campañas: plantillas, audiencia y tiers.
  </Card>

  <Card title="Ampliar el límite de mensajes" icon="gauge-high" href="/guias/ampliar-limite-mensajes">
    Subir el tope diario que te asignó Meta.
  </Card>

  <Card title="Mejores prácticas de WhatsApp" icon="whatsapp" href="/guias/mejores-practicas-whatsapp">
    Cuidar la calidad del número y evitar bloqueos.
  </Card>
</CardGroup>