Cuando un mensaje no se puede enviar, ya sea en una campaña, en un seguimiento, en la respuesta del agente o en un envío manual, Nuvia muestra la falla en el mismo contexto del envío, con la causa en lenguaje claro, el código del canal y, cuando el reenvío es posible, un botón para intentarlo de nuevo. Este artículo explica dónde aparecen esas fallas y cómo interpretarlas.
En la conversación: la tarjeta de falla
Cuando un mensaje enviado falla, aparece en la conversación con una tarjeta roja. La tarjeta siempre trae tres datos:
-
La causa, en lenguaje claro — en la primera línea, después de la etiqueta No enviado. Ejemplo: “No enviado · La ventana de 24 horas de esta conversación venció. Envía una plantilla aprobada para reabrir el contacto.”
-
La línea de identificación — justo debajo, con el código del canal, el origen de la falla y el horario: “Código 131047 · WhatsApp (Meta) · 10/08 14:32”. El origen es WhatsApp (Meta), LinkedIn o Nuvia.
-
Ver detalles técnicos — un enlace que expande la respuesta cruda del proveedor, el estado HTTP y el número de registro de la falla, cuando esa información existe.
La causa se muestra en tu idioma (portugués, inglés o español) siempre que Nuvia reconoce el código del canal, por ejemplo: número fuera de la ventana de 24 horas, límite de envío alcanzado, plantilla pausada por Meta, cuenta de LinkedIn desconectada o un pendiente de cobro con Meta.
El botón Intentar de nuevo
El botón Intentar de nuevo hace exactamente lo mismo que el campo de escritura de la conversación. Por eso solo aparece cuando el reenvío realmente puede funcionar:
-
el mensaje que falló es de texto (las plantillas y la multimedia no se reenvían con este botón);
-
la conversación no está cerrada;
-
la conversación está dentro de la ventana de 24 horas de WhatsApp;
-
tu cuenta no está en un período de prueba vencido.
Si no se cumple alguna de estas condiciones, el botón no se muestra; el envío volvería a fallar por el mismo motivo.
Bloqueo de la ventana de 24 horas: dos textos diferentes
Cuando Nuvia impide el envío porque no hay ventana abierta, la tarjeta explica cuál de las dos situaciones ocurrió:
| Situación | Qué dice la tarjeta |
|---|---|
| El contacto ya respondió en algún momento, pero pasaron las 24 horas | “La ventana de 24 horas venció. Envía una plantilla aprobada para reabrir la conversación.” |
| El contacto nunca respondió en esta conversación | “El contacto todavía no respondió, así que no hay una ventana de 24 horas abierta. Envía una plantilla aprobada para iniciar la conversación.” |
Este bloqueo lo hace Nuvia, antes de que el mensaje salga hacia WhatsApp. Por eso aparece con origen Nuvia en la línea de identificación — y no WhatsApp (Meta), como antes. El cambio separa nuestro bloqueo del error 131047 real, en el que la propia Meta rechaza el envío.
Falla por variable de plantilla vacía
Un caso común de falla en campañas de WhatsApp es la plantilla que no se puede enviar porque una de las variables mapeadas está vacía para ese lead. En este caso, el mensaje indica exactamente qué campo completar, por ejemplo:
El nombre del campo aparece con su etiqueta amigable (ej.: Nombre de la empresa), no con el identificador técnico. Cuando hay más de un campo vacío, se listan todos. Para entender cómo mapear variables y evitar campos vacíos, mira Cómo usar variables en plantillas de WhatsApp.
Contacto que pidió no recibir marketing
Antes de enviar una plantilla de Marketing, Nuvia verifica si ese contacto puede recibir este tipo de mensaje ahora. Si no puede, el envío se bloquea antes de salir hacia WhatsApp y la falla aparece con origen Nuvia y el código MARKETING_SUPPRESSED.
Son dos situaciones diferentes, con textos diferentes en la tarjeta:
| Situación | Qué dice la tarjeta | Cuánto dura |
|---|---|---|
| El contacto pidió dejar de recibir marketing | “Este contacto pidió no recibir mensajes de marketing en este canal.” | Sin plazo — aplica hasta que el contacto cambie de opinión |
| WhatsApp está limitando el marketing para ese contacto | “WhatsApp está limitando los mensajes de marketing para este contacto en este momento. El envío se liberará automáticamente.” | 24 horas, y se libera solo |
De dónde viene el pedido de dejar de recibir: el contacto desactivó los mensajes de marketing de tu empresa en la propia app de WhatsApp, o Meta rechazó un envío con el código 131050 (el contacto bloqueó el marketing). En los dos casos Nuvia registra la preferencia en el contacto y deja de enviarle marketing en ese canal.
De dónde viene el límite temporal: Meta rechazó un envío con el código 131049 (límite de mensajes de marketing por usuario) o 130472. Nuvia guarda ese bloqueo durante 24 horas para ese contacto, en ese canal, dentro de tu empresa — y vuelve a enviar sola cuando pasa el plazo.
El 131049 tiene dos momentos diferentes — y dos tarjetas diferentes
Vale la pena entender esta diferencia, porque explica por qué el mismo problema aparece de dos formas en la pantalla:
| Momento | Qué pasó | Cómo aparece en la conversación |
|---|---|---|
| El primer rechazo | WhatsApp aceptó el envío, creó el mensaje y solo después avisó que no lo entregó | Origen WhatsApp (Meta), código 131049, con el texto “No entregado: Meta limita los mensajes de marketing por usuario. Intenta de nuevo en 24 horas.” |
| Los envíos siguientes, dentro de las 24 horas | Nuvia ya sabe del límite y ni siquiera llama a WhatsApp | Origen Nuvia, código MARKETING_SUPPRESSED, con el texto “WhatsApp está limitando los mensajes de marketing para este contacto en este momento. El envío se liberará automáticamente.” |
En la campaña: causas por etapa e Historial de acciones
En el detalle de la campaña, el indicador de Fallas de cada etapa se puede expandir para ver las causas agrupadas, el mensaje en lenguaje claro, el código del canal y la cantidad de cada causa.
En el Historial de acciones de la campaña, cada ejecución que falló muestra la misma causa y la misma línea de identificación (código y origen) que ves en la tarjeta de la conversación. Las dos pantallas usan la misma traducción: el mismo código nunca aparece con textos diferentes en lugares diferentes.
En la exportación de contactos de la campaña
La exportación de contactos de la campaña trae dos columnas con el motivo, justo después de la columna Estado:
-
Código del error — el mismo código que aparece en la tarjeta (ej.:
131049,131026) -
Motivo del error — la causa en lenguaje claro, igual que en la pantalla
Antes, la exportación solo decía “Error de entrega” en la columna Estado, sin decir por qué. Ahora puedes filtrar la hoja por motivo y separar, por ejemplo, “el número no usa WhatsApp” de “límite de marketing”.
En el webhook de salida
Si usas los webhooks de Nuvia para seguir los envíos en otro sistema, existe el evento MESSAGE_FAILED. Trae un campo failure_reason con el código, la causa en texto, la clasificación y el proveedor — el mismo texto que el operador lee en la conversación, no la respuesta cruda del canal.
Mira también Cómo interpretar las métricas de campaña.
En la integración con HubSpot: Historial de sincronización
Cuando la falla es de HubSpot, y no de un envío de mensaje, aparece en el Historial de sincronización de la integración. En el detalle del elemento con error, Nuvia muestra primero la causa clasificada con el código de HubSpot (por ejemplo INVALID_OPTION o INVALID_PHONE_NUMBER), nombrando la propiedad que falló, y solo debajo la respuesta cruda de la API, que puede superar los dos mil caracteres.
Los elementos de sincronización antiguos, guardados antes de este cambio, siguen mostrando solo la respuesta cruda.
Fallas permanentes y transitorias
Toda falla de envío se clasifica internamente en dos tipos, lo que ayuda a entender si necesitas actuar:
-
Permanente — Meta (o Nuvia) rechazó este intento. Normalmente es definitivo y requiere una acción tuya: reconectar un número de WhatsApp, ajustar un permiso, reconectar la cuenta de LinkedIn o corregir los datos del lead
-
Transitoria — falla temporal, en la que el reenvío ocurre automáticamente (ej.: límite de envío momentáneo, inestabilidad del canal). En estos casos el propio mensaje avisa que el reenvío es automático y que no necesitas hacer nada
Qué reenvía la campaña y qué cierra en el momento
Cuando una etapa de campaña falla, Nuvia puede intentar el envío una vez más, unas 24 horas después. Es un intento extra, no un ciclo infinito: si el segundo también falla, el contacto se cierra en esa campaña.
Este reenvío solo se descarta cuando esperar no cambia nada — o cuando insistir sería un error.
La campaña reenvía en 24 horas:
-
131049 y 130472 — límite de mensajes de marketing por usuario. Es una ventana del destinatario y pasa sola
-
Límites e inestabilidad momentánea de WhatsApp (130429, 131048, 131056, 131000, 132069 y similares)
-
Códigos que Nuvia no reconoce y errores internos de la propia plataforma
La campaña cierra el contacto en el momento, sin reenviar:
-
131026 — el número no usa WhatsApp. No se recupera nunca
-
131050 — el contacto pidió no recibir marketing. No se insiste, por política y no por eficacia
-
Errores de plantilla (132000, 132001, 132015, 132016 y los otros 132xxx) — el problema está en la plantilla, no en el momento
-
Conexión y configuración del número (0, 190, 3, 10, 200, 131031, 131037, 131042, 131045, 133010) — solo se resuelve después de que alguien lo arregle
-
Ventana y contenido (131047 ventana vencida, 131051 tipo de contenido, 131052 y 131053 adjunto, 131008 y 131009 variable faltante, 131021 número propio del canal)
-
Bloqueos de la propia Nuvia —
MARKETING_SUPPRESSEDy bandeja de entrada sin agente predeterminado
Adjunto rechazado por Meta (código 131053)
El código 131053 pasó a tratarse como falla permanente, con el texto “Meta rechazó el adjunto. Intenta enviarlo de nuevo.”
Antes aparecía como transitoria y prometía un reenvío automático — pero este error llega por un aviso de Meta después de que el envío ya fue aceptado, así que ningún reenvío automático de la plataforma alcanza ese mensaje. El adjunto simplemente se perdía en el camino y nadie se enteraba. Ahora la tarjeta pide la acción: envía el adjunto de nuevo.