❓ ¿Qué es el error 9001004?
El error 9001004 es un código de validación previa (pre-flight) que funciona como un mecanismo de seguridad integrado en la plataforma.
Se genera automáticamente al intentar enviar una plantilla o ejecutar un flujo cuando el sistema detecta que el contacto carece de un número de teléfono o de un identificador de Meta válido (BSUID) asociado a ese canal. Esta validación temprana es crucial porque evita que se realicen peticiones fallidas hacia los servidores de Meta.
🎯 Escenarios de Disparo
El error puede presentarse en tres procesos operativos principales dentro de la plataforma:
Envíos de Campañas: Ocurre comúnmente si se descarga una lista de contactos y se intenta enviar una campaña a través de un número que no pertenece al mismo Business Manager, lo que invalida el identificador del cliente.
Tipificación de Conversaciones: Al realizar una tipificación en WhatsApp, el sistema evalúa los datos del cliente. Si el contacto no tiene teléfono visible y su BSUID no pertenece al negocio del canal en uso, el proceso se bloquea antes de enviar la petición a Meta.
Bot de Mensaje Entrante (templateExec): Cuando el bot procesa un mensaje para disparar una plantilla, detiene la llamada a Meta si no logra resolver la identidad del cliente en el portafolio, y registra el error directamente en el log del flujo.
⚙️ Proceso de Validación en Cascada
Para evitar envíos erróneos, el sistema no rechaza el contacto de inmediato, sino que ejecuta una validación lógica estructurada paso a paso:
Paso 1 - Iniciar envío: Se dispara el envío (ej. sendCampaignTask) y se toma el lote de contactos.
Paso 2 - Iteración individual: El sistema prepara el envío evaluando al cliente uno por uno (executePerClient).
Paso 3 - Resolución en cascada: El validador intenta resolver la identidad del destinatario mediante una búsqueda exacta y secuencial:
Primero busca el teléfono.
Si no hay teléfono, busca el BSUID del canal.
Si no coincide, busca el Parent BSUID. 👉 Si al final de esta cascada no se halla ninguna identidad válida, detona el error 9001004 y bloquea el envío para ese registro en particular.
💬 Mensajes de Error Contextuales
Para facilitar la comprensión del problema por parte del usuario, el sistema cuenta con un catálogo centralizado y traducido (español, inglés, francés y portugués) que despliega un mensaje descriptivo adaptado al módulo donde ocurrió la falla:
En el Módulo de Tipificación: "No se cuenta con teléfono ni identificador de Meta válido para el cliente, en el canal que se está atendiendo esta conversación."
En el Módulo de Campañas: "No se cuenta con teléfono ni identificador de Meta válido para el cliente, en el canal configurado para esta campaña."
📊 Trazabilidad y Cierre de Ciclo
El manejo de este error está diseñado para mantener tus métricas de éxito y fallos completamente exactas y auditables:
Panel de Health: Los errores detectados en la validación previa se visibilizan y contabilizan directamente en el panel de salud del disparador.
Cierre de Ciclo Seguro: Al detonarse el error, el estado del envío pasa inmediatamente a FAILED (Fallido), cerrando el ciclo de seguimiento de manera equivalente a si el fallo hubiera ocurrido con un número de teléfono tradicional.
Reportes CSV precisos: Al exportar los resultados, el archivo CSV incluye una estructura fija de 7 columnas (
clientId,phone,bsuid,errorCode,error,date,template). El sistema incorpora las filas con el código 9001004, dejando correctamente vacío el campo del número de teléfono en los casos donde solo se cuente con un BSUID inválido.
¡Protege la reputación de tu línea y optimiza tus envíos! 🚀
El error 9001004 no es un fallo del sistema, sino un escudo protector que valida a tus destinatarios antes de tocar los servidores de Meta, garantizando que tu reportería sea precisa y tus recursos se utilicen solo en contactos alcanzables. ✅