Skip to main content

Errores comunes del canal de WhatsApp

Suele deberse a que la URL que usas en el mensaje o la plantilla no es públicamente accesible, o a que el formato de archivo no está soportado por WhatsApp. Solución: revisa que la URL empiece con https, termine con la extensión del archivo, y que el archivo sea siempre público.
Puede dispararse al usar la función WhatsApp Flow. Para ciertas funciones, Meta requiere un Meta Business Manager verificado. Verifica el estado de tu negocio.
La solicitud incluyó parámetros no soportados o mal escritos. Es posible que uses variables de campos personalizados que no tienen valor. Solución: agrega una verificación condicional de todas las variables antes de usarlas, y revisa en los registros de errores el valor de cada una. Códigos de error.
Enviaste muchos mensajes que fueron bloqueados o marcados como spam, así que Meta limitó tu número. Mantén una calidad de cuenta saludable o tu número/WABA podría bloquearse.
No tienes fondos suficientes en tu cuenta de proveedor (ej. 360dialog). Solución: recarga saldo en tu cuenta del proveedor (Insights & Billing).
El permiso no fue otorgado o fue removido. Al conectar tu cuenta de WhatsApp debes seleccionar todos los permisos requeridos.
Al llamar a la API de Meta para enviar el mensaje, tardó más de 10 segundos (timeout por defecto de Meta). Puede ser lentitud del servidor de Meta. Revisa el estado de la API de Meta; si no hay caída, contacta al soporte de Botky.
Falta un parámetro requerido. Suele pasar porque una variable de campo personalizado no tiene valor. Solución: agrega verificación condicional y revisa los registros de errores.
Usaste una plantilla que no encontramos en tu cuenta de WhatsApp. Puede que la hayas cambiado o eliminado en el Business Manager y los cambios no se sincronizaron a Botky.
Meta bloqueó tu cuenta de WhatsApp Business. Debes contactar a Meta. Revisa las notificaciones en tu WhatsApp Manager.
El mensaje no se envió porque forma parte de un experimento (Marketing Message Experiment). Más info.
Han pasado más de 24 horas desde el último mensaje iniciado por el usuario; la sesión está cerrada y no puedes usar mensajes de formato libre. Solución: restringe el envío si no hubo mensaje entrante en 24h, o contacta al usuario con un mensaje de plantilla.
Demasiados mensajes enviados del mismo remitente al mismo destinatario en poco tiempo. Solución: espera y reintenta; puedes seguir enviando a otros números sin esperar.
El usuario cambió su contraseña de Facebook (o Meta cambió la sesión por seguridad), y Meta cerró sesión de las plataformas de terceros. Solución: reconecta el canal para restablecer la conexión.
Restricciones por mensajes bloqueados o marcados como spam. Revisa tu estado de calidad en WhatsApp Manager y la documentación de Quality-Based Rate Limits.
No se pudo entregar el mensaje. Razones posibles: el número no es de WhatsApp; el destinatario no aceptó los nuevos Términos y Política de Privacidad; o usa una versión antigua de WhatsApp. Solución: confirma que el destinatario acepta ser contactado por WhatsApp y usa la última versión.
Errores relacionados con tu método de pago. Ve a tu Business Manager → WhatsApp Manager y revisa el billing. Meta cobra por las plantillas, así que configura una tarjeta válida.
Parámetro no soportado o mal escrito (ej. clave inesperada “index”). Revisa la referencia del endpoint para los parámetros soportados y su escritura correcta. Asegúrate de que la clave pública sea RSA de 2048 bits en formato PEM, y que no haya discrepancia con el phone number id.
La plantilla no existe en el idioma especificado o no fue aprobada. Asegúrate de que esté aprobada y que el nombre y el locale de idioma sean correctos.
Surge cuando hay un almacenamiento de terceros integrado (Cloudinary, S3, etc.) y se comparte un archivo sin los permisos requeridos. Solución: desconecta la integración de almacenamiento, o habilita los ajustes que nos permiten compartir los archivos.
Surge al portar/migrar un número entre un proveedor y Cloud API mientras se conecta al mismo bot, al intentar registrar el número con el embedded signup. Solución: pausa y reanuda el bot actual, luego intenta de nuevo.
Ocurre cuando agregas el número directamente en Ads Manager: Facebook muestra la opción de conectarlo con la WhatsApp Business App, lo que causa conflicto porque ya está registrado con la Cloud API. Solución: inicia sesión en Facebook, cambia a tu perfil de Página, vincula el número (registrado con Cloud API) a tu Página, y luego en Ads Manager selecciona ese número al configurar tu campaña de entrega de mensajes.