# Error 132015 de WhatsApp: plantilla pausada — causa y solución

URL: https://wa.genuka.com/es/docs/errors/132015
Language: Spanish

> Error 132015 de WhatsApp: Meta pausó la plantilla por baja calidad. Cuánto duran las pausas (3 h, 6 h y luego desactivada con 132016) y cómo reanudar sin riesgo.

El error 132015 de WhatsApp significa que la plantilla está pausada: su calificación de calidad bajó al nivel más bajo
tras comentarios negativos o bajas tasas de lectura, y Meta la suspendió. No se puede enviar mientras dure la
pausa. Espera a que se levante la pausa o edita la plantilla, y mientras tanto usa otra plantilla.

## ¿Qué significa el error 132015?

> "Template is paused due to low quality so it cannot be sent in a template message."
> — [Meta, códigos de error de la Cloud API](https://developers.facebook.com/documentation/business-messaging/whatsapp/support/error-codes#other-errors)

La solución de Meta: edita la plantilla para mejorar su calidad y vuelve a intentarlo cuando esté aprobada. Su
código vecino marca el paso siguiente:

> "Template has been paused too many times due to low quality and is now permanently disabled."
> — Meta, código 132016

Para el 132016 solo hay una salida: crear una plantilla nueva, con un contenido diferente.

### ¿Cómo funciona la pausa?

Cada plantilla tiene una calificación de calidad, basada en el uso, los comentarios de los usuarios y la interacción: `GREEN`,
`YELLOW`, `RED`, o `UNKNOWN` mientras no haya datos suficientes
([Meta, Template quality](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/template-quality)).
Según la página de Meta sobre la pausa, una plantilla que llega a la calificación más baja (`RED` en la
API) se pausa automáticamente
([Meta, Template pausing](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/template-pausing)).
Sin embargo, su página sobre la calidad dice que una plantilla `RED` "can be sent, but is in danger of being
paused or disabled soon" (se puede enviar, pero corre el riesgo de ser pausada o desactivada pronto). Meta no es coherente
de una página a otra: trata `RED` como una pausa inminente. El calendario de pausas:

| Ocurrencia | Consecuencia              |
| ---------- | ------------------------- |
| 1.ª vez    | Pausada durante 3 horas   |
| 2.ª vez    | Pausada durante 6 horas   |
| 3.ª vez    | Desactivada: error 132016 |

Durante la pausa, Meta no te cobra los intentos de envío ni los cuenta en tu
límite de mensajería, pero la API los rechaza. Cuando termina la pausa, la plantilla vuelve a estar activa
por sí sola y su calificación se recalcula. Meta te avisa mediante una notificación del Administrador de WhatsApp (en inglés, *WhatsApp Manager*),
un correo electrónico y el webhook `message_template_status_update`.

En un principio, una pausa no afecta al número: sus demás plantillas de alta calidad se siguen enviando. Pero
un número que sigue enviando plantillas de baja calidad puede terminar afectado.

## ¿Cuándo ocurre el error 132015?

* **En medio de una campaña**, cuando la plantilla acumuló comentarios negativos en los primeros
  envíos.
* **En una plantilla automatizada** (recordatorio de carrito, seguimiento) dirigida a personas que no la
  esperaban.
* **Justo después de una pausa**, si no se atendió la causa: la siguiente pausa dura más, y la
  tercera es definitiva.

### ¿Dónde lo ves en Genuka WA?

| Canal                                    | Lo que recibes                                                                                                                     |
| ---------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| Respuesta de `POST /api/v1/messages`     | `400`, `"error": "send_template"`, `meta.code: 132015`                                                                             |
| Lanzamiento de una campaña               | Si Genuka WA ya sabe que la plantilla está pausada: un único rechazo antes del primer envío, en lugar de un fallo por destinatario |
| `GET /api/v1/templates/{id}`             | `status` y `qualityScore` leídos en vivo desde Meta                                                                                |
| Webhook `message_template_status_update` | El evento de pausa, reenviado tal como lo envía Meta                                                                               |

En cuanto Genuka WA sabe que la plantilla está pausada, después de `GET /api/v1/templates/{id}` o
`GET /api/v1/templates?sync=true`, rechaza el envío **antes** que Meta, con el mismo código 132015
para que tu manejo de errores reaccione de la misma manera:

```json title="400 — POST /api/v1/messages"
{
  "error": "send_template",
  "message": "Template \"october_promo\" is paused by Meta after negative recipient feedback and cannot be sent. Wait for the pause to lift or edit the template",
  "meta": { "errorClass": "template", "retryable": false, "code": 132015 }
}
```

Una plantilla desactivada se rechaza de la misma manera con el código 132016. Ten en cuenta que Genuka WA también registra como
desactivada una plantilla que Meta solo **marcó** (el evento de webhook `FLAGGED`, "at risk of being
disabled", es decir, en riesgo de ser desactivada, según
[Meta](https://developers.facebook.com/documentation/business-messaging/whatsapp/webhooks/reference/message_template_status_update)),
aunque todavía se pueda enviar. Antes de recrear una plantilla rechazada con 132016, vuelve a leerla
con `GET /api/v1/templates/{id}`: si Meta todavía la reporta como aprobada, Genuka WA la vuelve a poner en
`approved` y el rechazo desaparece.

## ¿Cómo corrijo el error 132015?

1. **Detén los envíos automatizados que usan esta plantilla.** Meta lo recomienda: de todos modos serán rechazados
   mientras dure la pausa.
2. **Cambia a una plantilla de respaldo** para los mensajes que no pueden esperar, como una confirmación de pedido.
3. **Elige entre esperar y editar.** En Meta, la pausa se levanta sola después de 3 o 6 horas.
   Editar el contenido (`PATCH /api/v1/templates/{id}` con nuevos `components`) la devuelve a
   revisión: no se puede enviar hasta que vuelva a estar aprobada.
4. **Una vez levantada la pausa, haz que Genuka WA vuelva a leer la plantilla** con
   `GET /api/v1/templates/{id}`, `GET /api/v1/templates?sync=true` o `POST /api/v1/templates/sync`.
   Solo esa lectura garantiza que Genuka WA elimine su propio rechazo 132015: el aviso de reactivación
   recibido por webhook no siempre actualiza su estado. Sin esa lectura, puede
   seguir respondiendo 132015 cuando Meta ya reactivó la plantilla.
5. **Corrige la causa antes de reanudar**: segmentación, frecuencia, pertinencia del mensaje. De lo contrario, la
   siguiente pausa dura más, y la tercera desactiva la plantilla.

Meta también te permite reanudar manualmente una plantilla pausada, desde el Administrador de WhatsApp o mediante su
API `unpause`, y lo exige para las pausas causadas por el *template pacing*. Genuka WA no expone
esa acción: usa el Administrador de WhatsApp.

**curl**

```bash
curl https://wa.genuka.com/api/v1/templates/tpl_123 \
  -H "Authorization: Bearer $GENUKA_WA_API_KEY"
# { "data": { "name": "october_promo", "status": "paused", "qualityScore": { "score": "RED", ... }, ... } }
```

**Node.js**

```ts
/** Llámala antes de un envío masivo: no empieces con una plantilla pausada o en rojo. */
export async function templateIsSafe(templateId: string): Promise<boolean> {
  const response = await fetch(`https://wa.genuka.com/api/v1/templates/${templateId}`, {
    headers: { Authorization: `Bearer ${process.env.GENUKA_WA_API_KEY}` },
  });
  const { data } = await response.json();
  return data.status === "approved" && data.qualityScore?.score !== "RED";
}
```

**Python**

```python
import os
import requests


def template_is_safe(template_id: str) -> bool:
    """Llámala antes de un envío masivo: no empieces con una plantilla pausada o en rojo."""
    response = requests.get(
        f"https://wa.genuka.com/api/v1/templates/{template_id}",
        headers={
            "Authorization": f"Bearer {os.environ['GENUKA_WA_API_KEY']}",
            "User-Agent": "acme-crm/1.0 (+https://example.com)",
        },
        timeout=30,
    )
    response.raise_for_status()
    data = response.json()["data"]
    return data["status"] == "approved" and (data.get("qualityScore") or {}).get("score") != "RED"
```

## ¿Cómo evito el error 132015?

* **Vigila la calificación antes de la pausa.** En `YELLOW`, Meta advierte que la plantilla corre el riesgo de ser
  pausada; en `RED`, trata la pausa como inminente. Ese es el momento de bajar el ritmo.
* **Envía solo a personas que dieron su consentimiento (opt-in)** para recibir tus mensajes, y en el momento adecuado.
* **Haz que cada mensaje sea útil y esperado**: un recordatorio de cita rara vez se reporta; una
  promoción genérica enviada a toda tu lista, a menudo sí.
* **Ten una plantilla de respaldo** para cada mensaje crítico, con otro nombre.

## Códigos de error relacionados

* [131048](https://wa.genuka.com/es/docs/errors/131048): ya no es una plantilla, sino **el número** el que está restringido por baja
  calidad.
* [132001](https://wa.genuka.com/es/docs/errors/132001): la plantilla no existe en ese idioma o no está
  aprobada.
* [131049](https://wa.genuka.com/es/docs/errors/131049): una plantilla de marketing retenida para un destinatario específico.

## Preguntas frecuentes

### ¿Cuánto dura la pausa de una plantilla?

3 horas la primera vez, 6 horas la segunda. La tercera vez, la plantilla se desactiva (error
132016\) y necesitas crear una nueva. Una vez levantada la pausa, vuelve a leer la plantilla con
`GET /api/v1/templates/{id}` para que Genuka WA deje de rechazarla.

### ¿Se cobran los intentos de envío durante la pausa?

No. Meta indica que no se te cobra por intentar enviar una plantilla pausada, y que el
intento no cuenta en tu límite de mensajería. Simplemente se rechaza.

### ¿Editar la plantilla levanta la pausa?

No de inmediato: editarla la devuelve a revisión, y no se puede enviar hasta que vuelva a estar aprobada.
Sirve cuando el contenido es la causa, no para ganar tiempo.

## Fuentes

* [Meta — Error codes](https://developers.facebook.com/documentation/business-messaging/whatsapp/support/error-codes)
* [Meta — Template pausing](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/template-pausing)
* [Meta — Template quality rating](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/template-quality)
* [Meta — message\_template\_status\_update webhook](https://developers.facebook.com/documentation/business-messaging/whatsapp/webhooks/reference/message_template_status_update)
