Ir al contenido principal

Troubleshooting de errores de WhatsApp (Meta Cloud API)

Actualizado hace más de 2 semanas

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?