¿Por qué mi mensaje de plantilla de WhatsApp aparece como “undeliverable”?

Cuando un mensaje de plantilla enviado a través de la WhatsApp Business API de SparkTG no llega al destinatario, el registro de la campaña muestra una falla de entrega para ese contacto. Esto no significa que SparkTG haya fallado al enviar el mensaje: significa que la capa de entrega de WhatsApp devolvió un estado de no entregable después de que el mensaje fue despachado. La causa raíz siempre está del lado del destinatario o en las políticas de entrega de Meta.

¿Qué hace que un mensaje de plantilla sea no entregable?

Existen cinco motivos distintos por los que WhatsApp marca un mensaje de plantilla saliente como no entregable. Identificar cuál aplica a tu situación es el camino más rápido hacia la solución.

Motivo 1: el número del destinatario no está en WhatsApp

El número de teléfono existe pero nunca se registró en WhatsApp, o la cuenta de WhatsApp vinculada a ese número fue desactivada. Es la causa más común de fallas masivas en campañas con listas de contactos recién importadas.

1. 1

   Usa la validación de números de SparkTG antes de enviar

   SparkTG Dashboard → Campaigns → New Campaign → Audience. Haz clic en Validate Contacts antes de programar. SparkTG comprobará cada número en la base de datos de WhatsApp y marcará los números no registrados para que puedas excluirlos antes de consumir cualquier crédito.

2. 2

   Depura tu lista de contactos con regularidad

   Los números que eran válidos hace seis meses pueden ya no ser cuentas activas de WhatsApp. Ejecuta una validación en cualquier lista de contactos con más de 90 días antes de usarla en una campaña.

Motivo 2: el destinatario bloqueó el número de tu empresa

Si un usuario bloqueó tu número de WhatsApp Business, todos los mensajes salientes, incluidos los de plantilla, se marcarán en silencio como no entregables. WhatsApp no notifica a las empresas cuando son bloqueadas, para proteger la privacidad del usuario.

• No puedes desbloquearte por tu cuenta: solo el destinatario puede quitar el bloqueo.
• Comunícate por un canal alternativo (correo, SMS, teléfono) y pídele que revise Settings → Privacy → Blocked Contacts en WhatsApp.
• Una tasa alta de bloqueos en una campaña indica que el contenido o la frecuencia de tus mensajes no es deseado: audita tu proceso de opt-in y la relevancia de tus plantillas.

Motivo 3: el destinatario no ha aceptado los Términos de servicio más recientes de WhatsApp

WhatsApp actualiza sus Términos de servicio periódicamente. Hasta que un usuario acepte los términos actualizados, no puede recibir mensajes de la Business API, aunque todavía pueda enviar y recibir mensajes personales.

1. 1

   Pide al destinatario que abra WhatsApp

   Cuando hay términos actualizados pendientes, WhatsApp muestra un aviso de aceptación la próxima vez que el usuario abre la aplicación. El usuario solo necesita abrir WhatsApp y aceptar.

2. 2

   Si el aviso no aparece automáticamente

   Pide al destinatario que vaya a WhatsApp → Settings → Help → Terms and Privacy Policy. Si hay una versión actualizada pendiente, aparecerá ahí.

3. 3

   Reintenta después de la aceptación

   Cuando el destinatario acepte los términos, reintenta el mensaje desde SparkTG Dashboard → Campaign Logs → selecciona el contacto fallido → Retry.

Motivo 4: el destinatario usa una versión desactualizada de WhatsApp

Los mensajes de plantilla con botones interactivos, encabezados o contenido multimedia enriquecido requieren una versión mínima de WhatsApp en el dispositivo del destinatario. Las versiones muy antiguas de la aplicación no pueden mostrar estos tipos de mensajes.

• Android: versión 2.21.15.15 o posterior
• WhatsApp Business (Android): versión 2.21.15.15 o posterior
• iOS: versión 2.21.170.4 o posterior
• WhatsApp Business (iOS): versión 2.21.170.4 o posterior
• KaiOS: versión 2.2130.10 o posterior
• WhatsApp Web: versión 2.2132.6 o posterior

1. 1

   Pide al destinatario que actualice WhatsApp

   Android: Google Play Store → My Apps → WhatsApp → Update. iOS: App Store → busca WhatsApp → Update.

2. 2

   Reintenta después de actualizar

   La mayoría de las fallas de entrega causadas por la versión de la aplicación se resuelven de inmediato tras una actualización. Reintenta desde SparkTG Dashboard → Campaign Logs.

Motivo 5: límite de frecuencia de mensajes de marketing por usuario de Meta

Para proteger a los usuarios de verse abrumados por mensajes de empresas, Meta limita cuántos mensajes de plantilla de marketing puede recibir un mismo usuario de todas las empresas dentro de una ventana de tiempo determinada. Es un límite por usuario y de toda la plataforma: aplica incluso si tu empresa nunca antes le ha escrito a ese contacto.

• No hay forma de evitar este límite: es una restricción de la plataforma de Meta.
• Los contactos afectados vuelven a ser alcanzables cuando el límite se reinicia, normalmente en 24 horas.
• Reintentar de inmediato no ayuda: espera a que se reinicie antes de volver a intentarlo.
• Las categorías de plantillas de utilidad y autenticación no están sujetas a este límite de frecuencia. Recategorizar como plantillas de utilidad los mensajes que califiquen puede mejorar la entregabilidad.

Preguntas frecuentes

• ¿Este error lo causa SparkTG? No. SparkTG transmite el mensaje correctamente a la API de Meta. El estado de no entregable lo devuelve la capa de entrega de WhatsApp según el estado de la cuenta del destinatario o las propias políticas de Meta.
• ¿Me cobrarán por los mensajes no entregados? WhatsApp cobra por sesión de conversación, no por mensaje individual. Si no se abrió ninguna sesión, no se aplica ningún cargo de conversación. Revisa SparkTG Dashboard → Billing → Usage para ver el desglose por contacto.
• ¿Puedo reintentar automáticamente los mensajes fallidos? Sí. Ve a SparkTG Dashboard → Campaign Settings → Retry Policy para programar reintentos automáticos de los contactos fallidos después de un intervalo definido.
• ¿Cómo veo qué contactos fallaron y por qué? SparkTG Dashboard → Campaigns → selecciona tu campaña → Delivery Report. Cada contacto fallido muestra el código de error específico y el motivo devuelto por Meta.

Cómo reducir las tasas de mensajes no entregables en futuras campañas

• Envía mensajes solo a contactos que hayan dado su opt-in activo para recibir mensajes de WhatsApp de tu empresa: es un requisito de las políticas de Meta y el factor que más influye en las tasas de entrega.
• Valida tu lista de contactos antes de cada campaña con la herramienta de validación de números integrada de SparkTG.
• Evita enviar plantillas de marketing de alta frecuencia a la misma audiencia en un período corto: esto acelera que se alcance el límite de marketing por usuario.
• Usa las categorías de plantillas de utilidad o autenticación siempre que corresponda: están exentas del límite de frecuencia de marketing.
• Monitorea con regularidad la calificación de calidad de tu plantilla en SparkTG → WhatsApp → Channel Status. Una calificación a la baja es una señal temprana de que están aumentando las tasas de mensajes no entregables.