Ir al contenido principal

Troubleshooting de errores de WhatsApp (Meta Cloud API)

Si estás teniendo problemas al enviar mensajes por WhatsApp desde Tecnom, podés identificar el error usando el código que aparece en el historial de eventos.

En esta guía vas a encontrar:

  • Qué significa cada error

  • Por qué ocurre

  • Cómo solucionarlo

🔐 Errores de autenticación

Qué indican: Problemas con permisos o tokens de acceso.

Posibles causas

  • Token vencido o inválido

  • Permisos insuficientes

  • Acceso revocado

Cómo solucionarlo

  • Generar un nuevo token desde Meta Business Manager

  • Verificar permisos de la app (whatsapp_business_management y whatsapp_business_messaging)

👉 Qué vas a ver:

Es un problema de configuración interna. No requiere acción de tu parte.

⏱️ Errores por límite de envíos (Rate Limit)

Qué indican: Se superó la cantidad de mensajes permitidos.

Posibles causas

  • Demasiados mensajes en poco tiempo

  • Baja calidad del número (spam o bloqueos)

Cómo solucionarlo

  • Reducir la frecuencia de envíos

  • Espaciar mensajes

  • Mejorar segmentación de audiencia

👉 Qué vas a ver:

Estamos procesando un alto volumen de mensajes. Se reintentará automáticamente.

🚫 Errores por políticas de Meta

Qué indican: Restricciones por incumplir normas de WhatsApp.

Posibles causas

  • Violación de políticas

  • Spam o quejas de usuarios

  • Restricciones por país

Cómo solucionarlo

  • Revisar el estado en Meta Business Manager

  • Apelar si corresponde

👉 Qué vas a ver:

La cuenta tiene restricciones. Es necesario revisar políticas o escalar el caso.

📩 Errores de envío de mensajes

Qué indican: El mensaje no pudo ser entregado.

Cómo solucionarlo

  • Verificar el número del destinatario

  • Usar templates aprobados (fuera de las 24h)

  • Reducir frecuencia de envíos

👉 Qué vas a ver:

El mensaje no se pudo entregar. Verificar el estado del contacto.

🧾 Errores de templates

Qué indican: Problemas con plantillas de mensajes.

Cómo solucionarlo

  • Revisar configuración en WhatsApp Manager

  • Validar variables y formato

  • Crear un nuevo template si fue deshabilitado

👉 Qué vas a ver:

Hay un problema con el template del mensaje.

🖼️ Errores de archivos multimedia

Qué indican: Problemas con imágenes, videos o documentos.

Posibles causas

  • Formato no soportado

  • Archivo corrupto

  • Tamaño excesivo

Cómo solucionarlo

  • Usar formatos válidos (JPG, PNG, MP4, PDF)

  • Verificar tamaño y estado del archivo

👉 Qué vas a ver:

Hubo un problema con el archivo multimedia.

💳 Errores de cuenta y facturación

Qué indican: Problemas con el estado de la cuenta de WhatsApp.

Posibles causas

  • Método de pago no configurado

  • Límite de crédito alcanzado

  • Cuenta suspendida

Cómo solucionarlo

  • Revisar configuración de pagos en Meta

👉 Qué vas a ver:

Hay un problema con la facturación de la cuenta.

⚙️ Errores generales o del servidor

Qué indican: Problemas técnicos o temporales.

Cómo solucionarlo

  • Esperar unos minutos

  • Reintentar el envío

👉 Qué vas a ver:

Problema temporal del lado de Meta/WhatsApp.

🔄 Errores de registro del número

Qué indican: Problemas al configurar el número en WhatsApp.

Cómo solucionarlo

  • Verificar el registro del número

  • Revisar PIN o proceso de verificación

🧠 Buenas prácticas

  • Evitá envíos masivos sin segmentación

  • Usá templates aprobados correctamente

  • Revisá regularmente el estado de tu cuenta

  • Controlá la calidad del número en WhatsApp Manager

¿Ha quedado contestada tu pregunta?