Quality rating de WhatsApp: el indicador que avisa antes de que caiga tu número

El quality rating de WhatsApp es la nota de calidad que Meta le asigna a cada número conectado a la API oficial, en tres colores: verde, amarillo y rojo. Se calcula según cómo reaccionaron los destinatarios a tus mensajes en los últimos 7 días, aparece en el WhatsApp Manager y se puede leer por la API. En la práctica, es una alarma con anticipación: cuando el color cambia, todavía tienes días para actuar antes de que caiga tu límite de envío.

¿Qué mide el quality rating — y qué no mide?

Meta no lee el contenido de tus conversaciones: el cifrado lo impide. Lo que mide es la reacción de quien recibe:

• cuánta gente bloqueó tu número después de recibir el mensaje;
• cuántos denunciaron;
• qué motivo marcó la persona al denunciar ("no pedí recibir esto", "contenido ofensivo", y así sucesivamente).

El cálculo mira los últimos 7 días — ventana declarada en la documentación de Meta, vigente en agosto de 2026 —, con más peso para los días recientes.

Lo que no mide: volumen, velocidad de envío o tamaño de la empresa. Mandar 50.000 mensajes no tumba la nota — mandar 500 a gente que no lo pidió, sí.

La nota es por número, no por empresa

Dos consecuencias prácticas cambian a quién vas a culpar cuando cambie el color:

1. La nota es por número de teléfono, no por cuenta (WABA) ni por empresa. Dos números de la misma cuenta pueden estar en colores distintos el mismo día, porque hacen cosas distintas.
2. Las plantillas tienen su propia evaluación, separada. Una plantilla de mensaje puede pausarse por calidad sin que el número cambie de color — y viceversa.

Es decir: la investigación empieza estrecha. Un número, y dentro de él una plantilla — casi nunca la operación entera.

¿Qué significa cada color del quality rating?

Aquí vive la confusión más cara del WhatsApp corporativo: el amarillo no bloquea nada. Ningún mensaje deja de salir — y por eso pasa desapercibido: la operación sigue normal y nadie mira el panel hasta que el límite se desploma.

La ventana de 7 días y el estado marcado

Cuando la nota cae a rojo, el número entra en estado marcado (flagged). A partir de ahí:

• sigues enviando normalmente;
• Meta observa durante 7 días;
• si la calidad vuelve a subir dentro de ese plazo, el número vuelve a la normalidad y no pasa nada;
• si sigue baja al final de la ventana, se reduce el límite de envío — bajas un escalón.

La ventana móvil explica dos cosas que parecen defecto y no lo son. El color tarda en mejorar: arregla la campaña hoy y la nota no cambia mañana, porque necesita días limpios para diluir los malos. Y el color tarda en empeorar: el envío desafortunado del lunes puede aparecer recién el miércoles — revisa el historial de 7 días antes de concluir que "no fue eso".

¿Dónde ver el quality rating de tu número?

En el WhatsApp Manager, ve a Configuración de la cuenta → Números de teléfono. La tabla lista cada número con las tres columnas que importan juntas — estado, calidad y límite de mensajes — y muestra si el número está marcado. Revisa también la pestaña de plantillas de mensajes: cada plantilla tiene su propio estado (activa, pausada, rechazada), y ahí es donde aparece la plantilla específica que está arrastrando tu reputación hacia abajo.

Por la API, una llamada al endpoint de números de tu cuenta lo resuelve:

GET /{WABA_ID}/phone_numbers?fields=display_phone_number,quality_rating,messaging_limit_tier

El campo quality_rating devuelve GREEN, YELLOW, RED o UNKNOWN — este último en un número nuevo, todavía sin historial. Correr esto una vez al día en un panel interno convierte la nota en una serie histórica: el formato en el que realmente sirve para algo.

¿Cómo enterarte sin tener que mirar el panel?

Suscribiéndote a un webhook. Son dos campos en tu cuenta:

• phone_number_quality_update — se dispara cuando el número es marcado, cuando vuelve a la normalidad y cuando cambia el límite de envío. Trae el evento y el límite actual.
• account_update — trae cambios de estado de la cuenta, incluyendo el campo waba_ban_state, con valores DISABLE, SCHEDULE_FOR_DISABLE y REINSTATE.

Este segundo campo merece una pausa honesta: existe porque un número en la API oficial sí puede ser desactivado. Quien vende la API oficial diciendo que "elimina el riesgo de baneo" está mintiendo — lo que da es otra cosa, y mejor de lo que suena. La entrada del glosario sobre quality rating y messaging tier resume la parte conceptual.

¿Qué tumba el quality rating?

En orden de peso:

1. Enviar a quien no dio opt-in. Es el ítem número uno, por lejos. La política exige las dos cosas: la persona te dio el número y autorizó el contacto. Una base comprada o una lista extraída de un grupo entran aquí — el detalle de lo que Meta trata como abuso está en qué es spam en WhatsApp.
2. Frecuencia demasiado alta. El límite de mensajes de marketing por persona es adaptativo — cambia por usuario y por empresa, y Meta no publica la cifra. Cuando lo superas, la API responde con el error 131049 y el mensaje no se entrega. Esto no es una sanción: es el sistema frenando antes de que se convierta en denuncia.
3. Una plantilla que promete una cosa y entrega otra. Una plantilla aprobada como utilidad que llega como oferta es la receta más rápida para una denuncia — y para que la plantilla se pause por calidad (3 horas la primera vez, 6 horas la segunda, desactivada la tercera; regla vigente en agosto de 2026).
4. Base vieja y segmentación perezosa. Un contacto de hace dos años no te recuerda. Reactivar una base fría tumba más la nota que una campaña a una base activa — y mandarle todo a todos solo multiplica a quien recibe algo irrelevante.
5. Ninguna salida visible. Quien no encuentra cómo salir, denuncia. Un "responde SALIR" respetado de verdad cambia una denuncia por un opt-out — y el opt-out no pesa en la nota.

Cayó a amarillo: ¿qué hacer en las primeras 48 horas?

1. Pausa las campañas de marketing. La atención y la utilidad siguen — el problema casi nunca está en responderle al cliente.
2. Encuentra al culpable. Cruza los últimos 7 días de envío con la pestaña de plantillas. En la mayoría de los casos es una plantilla y una lista, no toda la operación.
3. Limpia la lista. Saca a quien nunca respondió en tres campañas seguidas y a quien entró sin opt-in registrable. Esa gente no va a comprar y cuesta reputación.
4. Reescribe la plantilla. Empresa identificada en la primera línea, contexto explícito ("pediste una cotización el 12/08") y salida al final.
5. Reduce la frecuencia y envía en lotes más pequeños, monitoreando entre ellos.
6. Espera. La nota necesita días limpios; retomar el volumen al día siguiente es el error clásico. Sigue el progreso por la API hasta que vuelva a verde y solo entonces escala.

Si el número ya fue restringido, el camino es otro — está en la guía de WhatsApp baneado: qué hacer.

¿El quality rating es lo mismo que el límite de envío?

No. Son dos indicadores distintos que aparecen lado a lado en el mismo panel y se confunden todo el tiempo:

La relación entre los dos va en un solo sentido: una nota baja que se mantiene hasta el final de la ventana de observación es lo que hace bajar el límite. El quality rating es el peaje de la escala — por eso pesa mucho más para quien hace envío masivo que para quien solo atiende.

Los escalones del límite de envío (messaging tiers)

El messaging limit cuenta contactos únicos que inicias por día — no mensajes enviados, ni conversaciones donde el cliente habló primero. Los escalones vigentes en agosto de 2026:

Para subir de escalón necesitas volumen constante y una nota que no esté en rojo. Por eso una operación que crece rápido y cuida mal la lista se traba sola: sube el volumen, tumba la nota, y la nota traba el volumen.

¿Qué da la API oficial que el código QR no da?

Aquí la honestidad es el argumento más fuerte: ninguno de los dos caminos es inmune al baneo. CRPRO vende los dos, así que no tenemos motivo para vender fantasía. La diferencia es visibilidad y debido proceso:

Esta última fila suele pasar desapercibida. En la API oficial, mandar un mensaje libre fuera de la ventana de 24 horas no es una infracción — es imposible: la API rechaza con un error y solo una plantilla reabre la conversación. En el código QR, nada te impide enviarlo, y lo que viene después es la denuncia. En apps modificadas como GB WhatsApp, encima sumas la violación de los Términos.

Traducido: en la API oficial eres una empresa con historial. En la app común eres un número anónimo que Meta puede desconectar un martes cualquiera, sin explicación y sin plazo.

Preguntas frecuentes

¿El quality rating amarillo bloquea mis envíos?

No. El amarillo es una marca: todos los mensajes siguen saliendo normalmente. Justamente por eso exige acción inmediata — es el único aviso que llega sin doler.

¿En cuánto tiempo vuelve la nota al verde?

No hay un plazo garantizado. Como la ventana de cálculo es móvil, de 7 días, y pesa más los días recientes, la recuperación suele tardar entre unos días y una semana de envíos limpios. Retomar el volumen antes de eso reinicia el problema.

Mi número aparece como UNKNOWN. ¿Es un problema?

No. Es el estado normal de un número nuevo o de bajo volumen: todavía no hay suficiente reacción de los destinatarios para que Meta calcule una nota. Aparece en cuanto se forma el historial.

¿Un quality rating bajo puede banear mi número?

Puede contribuir. Una nota baja persistente primero tumba el límite de envío; la desactivación llega por escalamiento, con aviso previo. La API oficial no elimina el riesgo de baneo — el campo waba_ban_state en el webhook existe precisamente porque la desactivación es posible. Lo que garantiza es que te avisen antes.

¿Una plantilla pausada tumba la nota del número?

Son evaluaciones separadas: una plantilla puede pausarse sin que cambie el color del número. Pero la causa suele ser la misma — denuncias y bloqueos —, así que una plantilla pausada es indicio de que la caída de nota viene justo detrás.

¿Se puede monitorear el quality rating sin entrar al WhatsApp Manager?

Sí, y es lo recomendado. Consulta quality_rating en el endpoint de números de tu cuenta o suscríbete al webhook phone_number_quality_update, que avisa cuando el número es marcado y cuando cambia el límite. Las plataformas conectadas a la API oficial suelen mostrar esto en su propio panel.

Revisa el color antes de que te revise a ti

Si operas por la API oficial y nunca miraste esta nota, abre el WhatsApp Manager hoy y ve en qué color están tus números. En CRPRO, las conexiones oficiales y el código QR están en el mismo panel, con atención multiagente y campañas por plantilla — y preferimos decirte cuál de los dos tiene sentido para tu caso antes que venderte una inmunidad que nadie tiene.