Solución de errores comunes en campañas de WhatsApp

Al enviar campañas de WhatsApp a través de SparkTG, es posible que ocasionalmente encuentres errores que impiden la entrega de los mensajes. La mayoría se debe a las políticas de Meta (WhatsApp), a problemas de configuración de las plantillas o a restricciones a nivel de cuenta. Esta guía repasa cada tipo de error, qué significa y cómo resolverlo exactamente.

1. Mensaje no entregado: número no entregable

Si un mensaje de la campaña falla y el registro muestra una falla de entrega para un contacto específico, es probable que el número del destinatario tenga alguno de estos problemas:

• El número no está registrado en WhatsApp o la cuenta de WhatsApp vinculada fue desactivada.
• El código de país (+91 para India, etc.) falta o es incorrecto en tu lista de contactos.
• El destinatario usa una versión desactualizada de WhatsApp que no puede recibir mensajes de la Business API.
• El destinatario no ha aceptado los Términos de servicio más recientes de WhatsApp: debe abrir WhatsApp y aceptar los términos actualizados antes de que se puedan entregar los mensajes.

1. 1

   Verifica el formato del contacto

   En SparkTG → Contacts, abre el contacto afectado y confirma que el número incluya el código de país completo, sin espacios ni caracteres especiales. Ejemplo: 919876543210 (no 09876543210).

2. 2

   Elimina los números no válidos de la campaña

   Usa la opción Validate Numbers antes de enviar una campaña. SparkTG marcará los números que no están registrados en WhatsApp para que puedas excluirlos antes del envío.

3. 3

   Pide al destinatario que actualice WhatsApp

   Si el contacto es accesible por otro canal, pídele que actualice la aplicación de WhatsApp y acepte los Términos de servicio más recientes, y luego reintenta el mensaje.

2. Mensaje de marketing bloqueado por restricciones de calidad de Meta

Meta supervisa activamente la calidad de los mensajes de marketing enviados a través de la Business API. Si tus plantillas tienen una calificación de calidad baja (normalmente porque los destinatarios bloquean o reportan tus mensajes), Meta restringirá temporalmente las entregas y te pedirá reintentar después de un período de espera.

• Revisa el contenido de tu plantilla: asegúrate de que sea relevante, personalizado y esperado por el destinatario.
• Audita tu lista de contactos: elimina a quienes no hayan dado su opt-in explícito para recibir mensajes de WhatsApp de tu empresa.
• Espera a que pase el período de enfriamiento (normalmente 24–48 horas) antes de reintentar la campaña.
• Revisa la calificación de calidad de tu plantilla en Meta Business Manager → WhatsApp Manager → Message Templates.

3. Contacto inalcanzable: restricción por experimento de Meta

Desde mediados de 2023, Meta ha estado realizando un experimento continuo en el que un pequeño porcentaje de usuarios de WhatsApp no recibe mensajes de plantillas de marketing de empresas, a menos que el usuario haya iniciado antes una conversación. En los registros de campañas de SparkTG esto aparece como una falla de entrega en contactos específicos.

• Solo se ven afectadas las plantillas de la categoría marketing. Las plantillas de utilidad y de autenticación no se ven impactadas.
• Si un contacto forma parte de este experimento, la única forma de enviarle un mensaje de marketing es recibir primero un mensaje entrante de su parte.
• Una vez que te envíe un mensaje, tienes una ventana de 24 horas para enviar cualquier mensaje de plantilla, incluidos los de marketing.
• Comunícate con los contactos afectados por otro canal (correo, SMS, llamada telefónica) y pídeles que te envíen un mensaje de WhatsApp para iniciar la sesión.

4. Campaña en pausa: límite de mensajería alcanzado

WhatsApp aplica límites diarios de mensajería por niveles a todas las cuentas de la Business API: 1,000 → 10,000 → 100,000 contactos únicos cada 24 horas. Si tu campaña excede el límite de tu nivel actual, los mensajes dejarán de enviarse hasta que se reinicie la ventana de 24 horas.

1. 1

   Revisa tu nivel de mensajería actual

   SparkTG Dashboard → WhatsApp → Channel Status. Aquí se muestran tu límite actual y el uso de la ventana móvil de 24 horas.

2. 2

   Espera a que se reinicie la ventana

   La ventana de 24 horas es móvil, no se reinicia a una medianoche fija. Cuando se libere, la campaña en pausa se reanudará automáticamente si el reintento automático está activado.

3. 3

   Aumenta tu nivel de mensajería con el tiempo

   Meta mejora tu nivel automáticamente según envíos constantes de alto volumen y una buena calificación de calidad. No existe una solicitud manual de ascenso: mantén tasas de entrega altas y tasas de bloqueo bajas para subir de nivel más rápido.

5. Cuenta bloqueada o restringida por Meta

Si tu WhatsApp Business Account (WABA) fue marcada por infracciones de políticas, Meta puede restringirla o deshabilitarla por completo. Cuando esto ocurre, SparkTG muestra un error a nivel de cuenta en todas las campañas.

1. 1

   Revisa el estado de la cuenta en Meta Business Manager

   Inicia sesión en business.facebook.com → Settings → WhatsApp Accounts. Si está restringida, verás un banner con el motivo y una opción para apelar.

2. 2

   Envía una apelación a Meta

   Haz clic en Request Review en Meta Business Manager. Las revisiones suelen tardar 24–48 horas. Recibirás una notificación por correo cuando se tome una decisión.

3. 3

   Contacta al soporte de SparkTG si se levantó la restricción pero el error persiste

   Una vez que Meta levanta la restricción, el cambio puede tardar hasta 2 horas en propagarse a la plataforma de SparkTG. Si el error continúa después de ese plazo, genera un ticket de soporte con tu WABA ID.

6. Errores de plantilla: formato, variables y problemas de aprobación

Los errores de plantilla son la categoría más común de fallas en campañas de WhatsApp. Suelen deberse a variables faltantes, formato incorrecto o una plantilla que Meta pausó o rechazó.

• Variables vacías o faltantes: cada marcador {{variable}} de tu plantilla debe tener un valor al momento del envío. Si alguna variable está vacía, el mensaje fallará. Revisa los datos de tus contactos para asegurarte de que todos los campos requeridos estén completos.
• Multimedia faltante o no válida: si tu plantilla tiene un encabezado de imagen, video o documento, se debe proporcionar un archivo multimedia válido en cada envío. PDF es el único formato admitido para encabezados de documento.
• Saltos de línea o tabulaciones en las variables: no incluyas saltos de línea, tabulaciones ni más de cuatro espacios consecutivos dentro del valor de ninguna variable de la plantilla; Meta rechazará el mensaje.
• Plantilla pausada por Meta: Meta pausa automáticamente las plantillas con una calificación de calidad baja. Ve a WhatsApp Manager → Message Templates y revisa el estado. Puedes volver a enviar el contenido como una plantilla nueva si la original se deshabilitó de forma permanente.
• Nombre de plantilla no encontrado: si envías mediante la API de SparkTG, verifica que el nombre de la plantilla coincida exactamente; distingue mayúsculas y minúsculas. Las plantillas recién aprobadas pueden tardar hasta 30 minutos en estar disponibles por la API.

7. Mensajes que fallan por problemas de pago o facturación

WhatsApp cobra por conversación (no por mensaje). Si Meta no puede cobrar a tu método de pago, los mensajes salientes fallarán a nivel de la API con un código de error relacionado con el pago.

1. 1

   Revisa el método de pago en Meta Business Manager

   Ve a business.facebook.com → Settings → Payments. Verifica que haya un método de pago válido registrado y que no existan facturas vencidas.

2. 2

   Verifica el saldo de tu cuenta de SparkTG

   SparkTG Dashboard → Billing. Asegúrate de que el saldo de tu cuenta de SparkTG sea suficiente para el volumen de la campaña. Las campañas no se enviarán si el crédito de la cuenta cae por debajo del umbral mínimo.

3. 3

   Vuelve a verificar la incorporación si migraste recientemente

   Si migraste hace poco tu número de WhatsApp de otro proveedor a SparkTG, asegúrate de que los pasos de Business Verification y de configuración de pagos en Meta Business Manager se hayan completado por completo. Las migraciones incompletas pueden causar errores de pago persistentes.

8. Errores al subir archivos multimedia

Si tu plantilla incluye un encabezado multimedia y la carga falla, se bloqueará todo el envío de la campaña. WhatsApp tiene requisitos estrictos de formato y códec para los archivos multimedia.

• Imágenes: deben ser JPEG o PNG, con color de 8 bits, en modo RGB o RGBA. Tamaño máximo de archivo: 5 MB.
• Videos: deben usar el códec de video H.264 y el códec de audio AAC. Solo se permite una pista de audio. Tamaño máximo de archivo: 16 MB.
• Documentos: solo se admite el formato PDF en los encabezados de los mensajes de plantilla. Tamaño máximo de archivo: 100 MB.
• Si un video cumple el límite de tamaño pero aun así falla, lo más probable es que el problema sea el códec. Vuelve a codificar el video con una herramienta como HandBrake (H.264 + AAC) y súbelo de nuevo.

9. Texto del mensaje demasiado largo

WhatsApp aplica límites estrictos de caracteres a cada parte de una plantilla. Si alguna sección excede su límite, el mensaje no se enviará.

• Texto del encabezado: máximo 60 caracteres.
• Texto del cuerpo: máximo 1,024 caracteres.
• Texto del pie de página: máximo 60 caracteres.
• URL del botón de llamada a la acción: máximo 2,000 caracteres.
• Los símbolos de formato (*, _, ~) cuentan para el límite de caracteres.

10. Campaña bloqueada: créditos insuficientes

• Ve a SparkTG Dashboard → Billing y revisa tu saldo de crédito disponible.
• Recarga tu cuenta antes de volver a lanzar la campaña.
• Verifica que todos los contactos de tu lista de campaña tengan códigos de país válidos: los números no válidos consumen créditos en los intentos de entrega fallidos.