> For the complete documentation index, see [llms.txt](https://docs.patagon.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.patagon.ai/es/solucion-de-problemas/quality-rating-red.md).

# Qué hacer cuando el número tiene Quality Rating RED

## Qué es el Quality Rating de WhatsApp

El Quality Rating (clasificación de calidad) es una calificación que Meta asigna a tu número de WhatsApp Business API basándose en la experiencia de los usuarios con tus mensajes en los últimos siete días. Refleja directamente la reputación de tu número ante la plataforma.

Existen tres niveles:

| Estado | Color       | Significado                               |
| ------ | ----------- | ----------------------------------------- |
| Alta   | 🟢 Verde    | Número saludable, sin restricciones       |
| Media  | 🟡 Amarillo | Calidad en descenso, monitoreo necesario  |
| Baja   | 🔴 Rojo     | Número en riesgo de restricción o bloqueo |

Verificas el estado de tu número directamente en **Meta Business Manager → Herramientas de la Cuenta → Números de Teléfono**, en la columna "Calidad". Dentro de Patagon AI, el campo "Calidad" es visible en **Agente → General → Configuración**, en la sección de Información del número conectado, y también en la pantalla de **Leads → Campañas**, donde aparece el aviso "No elegible para mensaje" cuando el número está Rojo o con restricciones activas.

El Quality Rating se calcula a partir de señales negativas: bloqueos por parte del usuario, denuncias de spam y bajo engagement con mensajes iniciados por el negocio. Meta no divulga la fórmula exacta, pero el peso principal está en los **bloqueos y denuncias**. Un número puede caer de Verde a Rojo rápidamente si una campaña genera un alto volumen de denuncias.

## Por qué el número puede ser bloqueado o tener el envío restringido

### Estado Rojo no es bloqueo inmediato

Estar en Rojo significa que Meta identificó señales negativas significativas en tu número. En ese estado, el número entra en un **período de observación** antes de cualquier restricción definitiva. Lo que sucede durante ese período:

* Meta puede **limitar el número de conversaciones** que tu número puede iniciar por día (reducción del tier de mensajes)
* Las campañas masivas quedan **bloqueadas**. No puedes crear nuevas campañas en Patagon AI mientras el número esté Rojo
* Si las señales negativas continúan durante el período de observación, Meta puede **suspender** el número, impidiendo cualquier envío de mensaje iniciado por el negocio

### Qué genera señales negativas

**Bloqueos y denuncias de spam** son la causa más común y de mayor peso. Cuando un usuario bloquea tu número o toca "Denunciar spam" en WhatsApp, Meta lo contabiliza contra tu número. Un alto volumen de denuncias en poco tiempo, como sucede después de una campaña mal segmentada, puede derribar el rating en horas.

**Volumen de mensajes por encima del tier permitido** también es un factor. Cada número tiene un límite de conversaciones iniciadas por día (el "tier"), que sube conforme la calidad mejora. Intentar enviar más allá de ese límite genera errores de entrega y perjudica la reputación.

**Mensajes enviados a contactos que no guardaron tu número** generan más denuncias porque el usuario no reconoce quién está contactando. WhatsApp muestra un aviso al receptor en esos casos, lo que aumenta la probabilidad de bloqueo.

**Plantillas de Marketing usadas fuera de contexto**, como enviar promociones a leads que nunca demostraron interés, también contribuyen a las denuncias. Meta monitorea la tasa de lectura y engagement de tus plantillas.

## Cómo recuperar el Quality Rating

La recuperación no sucede por una acción aislada. Meta recalcula el rating continuamente basándose en los últimos 7 días de señal. El objetivo es **detener lo que está causando las señales negativas** y esperar que el período negativo salga de la ventana de cálculo.

### Paso 1: Pausa las campañas masivas inmediatamente

Si el número cayó a Rojo durante o después de una campaña, interrumpe nuevos envíos. Continuar enviando mensajes mientras el rating está bajo acelera la caída y aumenta el riesgo de suspensión.

### Paso 2: Identifica la causa en Meta Business Manager

Accede a **Meta Business Manager → Herramientas de la Cuenta → Números de Teléfono** y haz clic en el número afectado. El panel muestra:

* El historial del Quality Rating (el gráfico de caída indica cuándo empezó el problema)
* Las plantillas con mayor tasa de denuncia (en **Plantillas de Mensaje**, la columna "Calidad" muestra el estado de cada plantilla)
* Alertas activas de restricción de tier

Si una plantilla específica aparece con calidad baja o estado "Pausado", está contribuyendo activamente al problema. Edita o desactiva esa plantilla.

### Paso 3: Reduce el volumen de mensajes iniciados por el negocio

Durante la recuperación, concéntrate en responder conversaciones inbound (leads que entran por cuenta propia) en lugar de iniciar nuevas. Las conversaciones inbound no generan señales negativas y aún cuentan positivamente para el período de análisis.

### Paso 4: Espera la ventana de 7 días

El Quality Rating se calcula con base en los últimos 7 días corridos. Si detuviste los envíos problemáticos, el rating comienza a mejorar conforme esos días salen de la ventana de cálculo. En general, los números que detienen los envíos problemáticos vuelven al Amarillo en 3 a 5 días y al Verde en 7 a 10 días, dependiendo del volumen de señales negativas acumuladas.

### Paso 5: Retoma campañas con una lista menor y más calificada

Cuando el número vuelva al Amarillo, puedes retomar campañas, pero comienza con un volumen menor y una lista más segmentada para validar que el problema se resolvió antes de escalar nuevamente. Acompaña el Quality Rating en tiempo real en Meta Business Manager durante los primeros envíos.

{% hint style="warning" %}
Si el número fue **suspendido** (estado diferente de activo en Meta Business Manager), es necesario contactar al soporte de Meta directamente por el Business Manager para solicitar revisión. Patagon AI no puede resolver suspensiones. Este proceso es enteramente gestionado por Meta.
{% endhint %}

## Buenas prácticas para no caer a RED

### Envía solo a quienes optaron por recibir

Esta es la regla más importante. Solo envía mensajes proactivos (plantillas de Marketing o Utilidad) a contactos que explícitamente demostraron interés: leads que iniciaron una conversación, llenaron un formulario o hicieron clic en un anuncio recientemente. Listas compradas o muy antiguas generan alta tasa de bloqueo porque el receptor no recuerda haber tenido contacto con tu marca.

### Usa el Retraso en Lote en las campañas

En Patagon AI, al crear una campaña en **Leads → Campañas**, configura un **Retraso en Lote** de al menos 5 segundos entre cada mensaje. Envíos muy rápidos (cercanos al límite de rate de WhatsApp) generan errores 429 y pueden activar alertas en Meta. Para campañas grandes, considera aumentar a 10 a 15 segundos.

### Mantén las plantillas relevantes para el contexto

Usa la **categoría correcta** al crear plantillas en Meta Business Manager:

* **Marketing** - ofertas, promociones, novedades. Solo envía a leads que ya demostraron interés en el producto.
* **Utilidad** - confirmaciones, actualizaciones de pedido, recordatorios de reunión. Envía a quienes están en medio de un proceso contigo.
* **Autenticación** - códigos de verificación. No mezcles con contenido comercial.

Enviar contenido de Marketing disfrazado como Utilidad no solo genera rechazo de Meta en la aprobación. Si es aprobado, aumenta la tasa de denuncia porque el usuario se sorprende con el mensaje.

### Incluye siempre una opción de opt-out clara

Toda plantilla de Marketing debe ofrecer al destinatario una forma simple de dejar de recibir mensajes. El botón de opt-out estándar de WhatsApp (disponible en las plantillas con botones de acción rápida) es la forma más efectiva. Cuando el usuario usa el opt-out, no denuncia como spam, lo que protege tu Quality Rating.

Dentro de Patagon AI, el agente no inicia nuevas conversaciones con leads que bloquearon el número. Pero es responsabilidad de tu equipo honrar las solicitudes de opt-out y no reincluir esos contactos en listas de campañas futuras.

### Monitorea el Quality Rating semanalmente

Verifica el estado del número en **Meta Business Manager → Herramientas de la Cuenta → Números de Teléfono** cada semana, especialmente la semana siguiente a cualquier campaña. También acompaña las métricas de entrega de las campañas en Patagon AI en **Leads → Campañas**. Una tasa alta de "Falló" puede indicar problemas de calidad incluso antes de que el rating caiga.

### Calibra el volumen conforme al tier del número

Los números nuevos comienzan con capacidad de envío limitada (generalmente 1.000 conversaciones iniciadas por día). Este límite sube automáticamente conforme el Quality Rating permanece Verde. Forzar volumen más allá del tier permitido no solo genera errores, señala comportamiento anormal para Meta. Respeta el crecimiento gradual, especialmente en los primeros 30 días del número.

## Checklist de recuperación rápida

Cuando el número caiga a RED, sigue esta secuencia:

* [ ] Pausar todas las campañas masivas en Patagon AI
* [ ] Acceder a Meta Business Manager → Herramientas de la Cuenta → Números de Teléfono → verificar alertas activas
* [ ] Identificar plantillas con calidad baja en Plantillas de Mensaje y desactivar o editar
* [ ] Enfocarse solo en conversaciones inbound por los próximos 3–7 días
* [ ] Acompañar el Quality Rating diariamente hasta volver al Amarillo
* [ ] Retomar campañas con lista reducida y retraso en lote mayor
* [ ] Si el número está suspendido: abrir ticket en el soporte de Meta por el Business Manager

## Artículos relacionados

* [Elegibilidad para Campañas](/es/rendimiento-de-ventas/elegibilidad-para-campanas.md) - qué significa el aviso "No elegible para mensaje" y cómo resolver
* [Cómo crear una campaña](/es/rendimiento-de-ventas/campaigns.md) - configuración de Retraso en Lote y lectura de métricas de entrega
* [Cómo crear plantillas de mensajes](/es/optimizacion-del-agente/message-templates.md) - categorías de plantilla y proceso de aprobación
* [Cómo monitorear la salud de tu número de WhatsApp](/es/marketing-y-atribucion/whatsapp-number-health.md) - dónde ver el Quality Rating y los límites de envío

{% hint style="info" %}
Si tu número fue suspendido y no estás logrando resolver por Meta Business Manager, contacta a <support@patagon.ai> con el número afectado y una descripción de lo que sucedió antes de la suspensión.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.patagon.ai/es/solucion-de-problemas/quality-rating-red.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
