Reporte de calidad de número en la API

El reporte de calidad de número en la API de WhatsApp es una métrica que indica, en una escala de baja a alta, qué tan confiable es un número de teléfono para enviar mensajes a tus contactos. Lo calcula Meta en base a cómo reaccionan los usuarios: si abren, responden o bloquean tus mensajes. Si el reporte es bajo, la API puede limitar tu velocidad de envío o incluso suspender el número. Para una PyME, entender este reporte es clave para no quedarse sin poder responder por WhatsApp.

¿Por qué le importa a una PyME?

Si usás la API oficial de WhatsApp (por ejemplo, a través de Wando), el reporte de calidad de número es como la reputación de tu negocio en la plataforma. Si es baja, tus mensajes pueden llegar más lento o directamente no llegar. Para una PyME que usa WhatsApp para vender, atender consultas o mandar recordatorios, una caída en la calidad significa menos ventas y clientes enojados. Además, si la calidad es baja por mucho tiempo, Meta puede bloquear el número y perderías el acceso a tu historial de chats.

¿Cómo se usa en la práctica?

En el panel de la API de WhatsApp, dentro de la sección de 'Números de teléfono', vas a ver el estado de calidad de cada número. Se actualiza cada 24 horas y se basa en los últimos 7 días de actividad. Para mantenerlo en alta, tenés que hacer que los usuarios interactúen positivamente con tus mensajes: que los abran, los respondan y no los marquen como spam.

1. 1Entrá al panel de WhatsApp Business Platform y buscá la pestaña de 'Phone numbers'.
2. 2Mirá el indicador de calidad: verde (alta), amarillo (media) o rojo (baja).
3. 3Si es media o baja, revisá los mensajes que enviaste en los últimos días y buscás patrones: ¿mucha gente bloquea? ¿Responden poco?
4. 4Ajustá tu estrategia: mandá mensajes más relevantes, pedí confirmación de lectura y evitá enviar en horarios molestos.
5. 5Esperá 24-48 horas para que el reporte se actualice y volvé a chequear.

Ejemplo concreto

Imaginá una tienda de ropa que usa WhatsApp para mandar ofertas a toda su lista. Un día, el dueño manda un mensaje genérico a 500 contactos que no pidieron nada. Resultado: 100 lo bloquean, 50 lo reportan como spam. Al día siguiente, el reporte de calidad del número pasa a 'baja'. La API ahora limita los envíos a 10 mensajes por segundo y muchos no llegan. El dueño pierde ventas y tiene que esperar días para recuperar la confianza. Si en cambio hubiera enviado un mensaje con un descuento personalizado y un botón de 'Dejar de recibir ofertas', la calidad se habría mantenido alta y las ventas habrían subido.

¿Con qué se confunde y en qué se diferencia?

Se suele confundir con el 'estado de verificación' del número (si está verificado con una palomita) o con el 'límite de mensajes' (cuántos mensajes podés enviar por segundo). Pero son cosas distintas: el reporte de calidad es una métrica de reputación, no un estado fijo. Podés tener un número verificado y aun así tener calidad baja si los usuarios te bloquean. El límite de mensajes, en cambio, depende de tu nivel de calidad y de la antigüedad del número: si la calidad es alta, el límite sube; si baja, baja.

Errores comunes

• Ignorar el reporte y seguir enviando mensajes masivos sin segmentar.
• Enviar mensajes a números que no dieron su consentimiento explícito.
• Usar plantillas de mensaje que suenan a spam (ej: '¡Ganaste un premio!').
• No medir la tasa de respuesta: si nadie responde, la calidad baja.
• Pensar que el reporte es permanente: se actualiza solo, así que se puede recuperar.

¿Qué pasa si no lo tenés en cuenta?

Si no monitoreás el reporte de calidad, tu número puede ser limitado o suspendido sin aviso. Eso significa que no podés enviar mensajes a tus clientes, y si tenés un negocio que depende de WhatsApp, es un problema serio. Además, recuperar un número suspendido es un proceso largo y no siempre exitoso. La buena noticia es que el reporte es transparente: lo podés ver en el panel y actuar antes de que sea tarde.

¿Cómo se relaciona con la API oficial de Meta?

El reporte de calidad de número es una función nativa de la API de WhatsApp Business de Meta. Cualquier proveedor que use esa API, como Wando, hereda esta métrica. No es un invento de terceros: es parte del sistema de reputación de Meta. Para mejorar tu calidad, las buenas prácticas son las mismas que para cualquier canal de mensajería: enviar contenido relevante, respetar los horarios y ofrecer siempre una vía de baja.

¿Cuándo NO aplica?

Si usás WhatsApp normal (la app personal) o WhatsApp Business sin API, no tenés reporte de calidad. Tampoco aplica si solo respondés mensajes entrantes y nunca enviás mensajes proactivos: en ese caso, la calidad suele mantenerse alta porque los usuarios te escriben primero. El reporte solo importa cuando hacés envíos masivos o usás plantillas de mensaje (HSM). Si tu negocio es 100% reactivo, no te preocupes por esto.

En resumen: el reporte de calidad de número es una señal de salud para tu cuenta de WhatsApp Business API. Si lo cuidás, tus mensajes llegan más rápido y a más gente. Si lo descuidás, podés quedarte sin canal de venta. Herramientas como Wando te muestran esta métrica en el panel y te ayudan a mantener la calidad alta con sugerencias de respuestas y plantillas aprobadas por Meta.

Cómo se configura en concreto

Para activar el reporte de calidad no hay un botón que lo encienda: se genera solo desde que registrás tu número en la API de WhatsApp Business. Lo que sí podés configurar es el webhook para recibir notificaciones cuando cambia el estado de calidad.

En el panel de Meta, entrá a WhatsApp > Configuration > Webhook. Ahí tenés que suscribirte al campo 'quality' dentro de 'messages'. Cada vez que el reporte pase de verde a amarillo o a rojo, Meta te manda un evento. Si usás una plataforma como Wando, esto ya viene configurado y te avisa en el panel sin que toques nada.

También podés consultar el estado actual vía API con el endpoint de phone numbers. La respuesta incluye el campo 'quality_rating' con los valores 'GREEN', 'YELLOW' o 'RED'.

• Revisá que el webhook esté activo para el campo 'quality'.
• Configurá una alerta interna para cuando el estado baje a amarillo.
• Documentá qué mensajes se enviaron en los últimos 7 días para correlacionar.

Cómo darse cuenta de que quedó bien, y qué mirar primero cuando no funciona

Lo primero que notás cuando la configuración está bien es que el panel te muestra el indicador de calidad sin errores. Si configuraste el webhook, vas a recibir un evento de prueba (test) al suscribirte. Ese es el momento de confirmar que llega.

Si no te llega nada, revisá tres cosas: que el webhook esté apuntando a una URL válida, que el token de verificación coincida, y que hayas marcado el campo 'quality' en la suscripción. Un error típico es suscribirse a 'messages' pero no al subcampo de calidad.

Cuando la calidad ya está en rojo, el problema no es de configuración sino de contenido. Mirá primero las métricas de mensajes entregados y la tasa de respuesta. Si la gente no abre ni responde, el problema es el mensaje, no el código.

Qué cambia según el tamaño del negocio

En un negocio de una sola persona, el reporte de calidad se cuida casi sin darte cuenta: respondés rápido, personalizás cada mensaje y no hacés envíos masivos. El riesgo es cuando esa persona decide probar una campaña a toda su lista un domingo a la noche.

En un negocio de quince personas, el problema es otro: la calidad depende de todos los que tocan el WhatsApp. Si un vendedor manda un mensaje genérico sin consentimiento, puede tirar abajo la reputación del número. Ahí necesitás roles y permisos: quién puede enviar plantillas, quién solo responder.

Las herramientas con multiagente, como Wando, ayudan justamente en eso: centralizás los mensajes y controlás qué sale de cada número. En un negocio chico, alcanza con sentido común; en uno mediano, hace falta política interna.

Qué dice la documentación oficial de Meta y qué queda a criterio de cada plataforma

Meta define el reporte de calidad como un indicador de la confiabilidad de tu número, basado en señales como bloqueos, reportes de spam y falta de respuesta. Eso está documentado y es igual para todos.

Lo que Meta deja abierto es cómo cada plataforma te muestra ese dato. Algunas lo esconden en un panel técnico; otras, como Wando, lo integran al flujo diario. La API te da el dato crudo; la plataforma decide si te lo presenta como una alerta o como un número más.

También varía el criterio de los umbrales exactos: Meta no publica el puntaje numérico ni las fórmulas. Lo que sí es seguro: si tu tasa de bloqueos es alta, la calidad baja. Eso no lo discute nadie.

Preguntas de segundo orden que quedan después de entender el concepto

Una vez que sabés qué es el reporte, aparecen preguntas más finas: ¿la calidad es por número o por cuenta? Es por número. Si tenés varios números, cada uno tiene su propio reporte.

¿Puedo cambiar de número si la calidad está muy baja? Sí, pero el historial de mensajes no se transfiere y el número nuevo arranca de cero. No es una solución mágica.

¿El reporte afecta la entrega de respuestas a mensajes entrantes? No directamente: si un cliente te escribe, podés responder siempre. El límite aplica a los mensajes proactivos (los que usan plantillas).

¿Cuánto tarda en recuperarse un número en rojo? No hay un plazo fijo, pero con buenas prácticas suele mejorar en una o dos semanas. Mientras tanto, limitá los envíos al mínimo.