# Errore WhatsApp 132015: modello in pausa — causa e soluzione

URL: https://wa.genuka.com/it/docs/errors/132015
Language: Italian

> Errore WhatsApp 132015: Meta ha messo in pausa il modello per bassa qualità. Quanto durano le pause (3 h, 6 h, poi disattivazione con 132016) e come riprendere in sicurezza.

L'errore WhatsApp 132015 significa che il modello è in pausa: la sua valutazione di qualità è scesa al livello più basso
dopo feedback negativi o bassi tassi di lettura, e Meta l'ha sospeso. Non può essere inviato finché dura la
pausa. Aspetta che la pausa finisca oppure modifica il modello, e nel frattempo passa a un altro modello.

## Cosa significa l'errore 132015?

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

La soluzione di Meta: modifica il modello per migliorarne la qualità, poi riprova quando viene approvato. Il
codice vicino segna il passo successivo:

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

Per 132016 c'è una sola via d'uscita: creare un nuovo modello, con un contenuto diverso.

### Come funziona la pausa?

Ogni modello ha una valutazione di qualità, basata su utilizzo, feedback degli utenti e coinvolgimento: `GREEN`,
`YELLOW`, `RED`, oppure `UNKNOWN` finché non ci sono abbastanza dati
([Meta, Template quality](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/template-quality)).
Secondo la pagina di Meta sulle pause, un modello che raggiunge la valutazione più bassa (`RED` tramite
l'API) viene messo in pausa automaticamente
([Meta, Template pausing](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/template-pausing)).
La sua pagina sulla qualità dice però che un modello `RED` "can be sent, but is in danger of being
paused or disabled soon". Meta non è coerente da una pagina all'altra: considera `RED` come una pausa
imminente. Il calendario delle pause:

| Occorrenza | Conseguenza                |
| ---------- | -------------------------- |
| 1ª volta   | In pausa per 3 ore         |
| 2ª volta   | In pausa per 6 ore         |
| 3ª volta   | Disattivato: errore 132016 |

Durante la pausa, Meta non ti addebita i tentativi di invio e non li conta sul tuo
limite di messaggistica, ma l'API li rifiuta. Quando la pausa finisce, il modello torna attivo
da solo e la sua valutazione viene ricalcolata. Meta ti avvisa con una notifica in WhatsApp Manager,
un'email e il webhook `message_template_status_update`.

All'inizio una pausa non incide sul numero: i suoi altri modelli di alta qualità continuano a partire. Ma
un numero che continua a inviare modelli di bassa qualità potrebbe alla fine risentirne.

## Quando si verifica l'errore 132015?

* **A metà di una campagna**, quando il modello ha raccolto feedback negativi sui primi
  invii.
* **Su un modello automatico** (promemoria carrello, follow-up) inviato a persone che non se lo
  aspettavano.
* **Subito dopo una pausa**, se la causa non è stata affrontata: la pausa successiva dura di più, e la
  terza è definitiva.

### Dove lo vedi in Genuka WA?

| Canale                                   | Cosa ottieni                                                                                                                    |
| ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
| Risposta di `POST /api/v1/messages`      | `400`, `"error": "send_template"`, `meta.code: 132015`                                                                          |
| Lancio di una campagna                   | Se Genuka WA sa già che il modello è in pausa: un unico rifiuto prima del primo invio, invece di un fallimento per destinatario |
| `GET /api/v1/templates/{id}`             | `status` e `qualityScore` letti in tempo reale da Meta                                                                          |
| Webhook `message_template_status_update` | L'evento di pausa, inoltrato così come lo invia Meta                                                                            |

Appena Genuka WA sa che il modello è in pausa, dopo `GET /api/v1/templates/{id}` o
`GET /api/v1/templates?sync=true`, rifiuta l'invio **prima** di Meta, con lo stesso codice 132015,
così la tua gestione degli errori reagisce allo stesso modo:

```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 }
}
```

Un modello disattivato viene rifiutato allo stesso modo con il codice 132016. Nota che Genuka WA registra come
disattivato anche un modello che Meta ha solo **segnalato** (l'evento webhook `FLAGGED`, "at risk of being
disabled" secondo
[Meta](https://developers.facebook.com/documentation/business-messaging/whatsapp/webhooks/reference/message_template_status_update)),
anche se può ancora essere inviato. Prima di ricreare un modello rifiutato con 132016, rileggilo
con `GET /api/v1/templates/{id}`: se Meta lo riporta ancora come approvato, Genuka WA lo rimette in
`approved` e il rifiuto sparisce.

## Come risolvo l'errore 132015?

1. **Ferma gli invii automatici che usano questo modello.** Lo consiglia Meta: verrebbero comunque rifiutati
   finché dura la pausa.
2. **Passa a un modello di riserva** per i messaggi che non possono aspettare, come una conferma d'ordine.
3. **Scegli tra aspettare e modificare.** Presso Meta, la pausa si toglie da sola dopo 3 o 6 ore.
   Modificare il contenuto (`PATCH /api/v1/templates/{id}` con nuovi `components`) lo rimanda in
   revisione: non può partire finché non viene approvato di nuovo.
4. **Quando la pausa è finita, fai rileggere il modello a Genuka WA** con
   `GET /api/v1/templates/{id}`, `GET /api/v1/templates?sync=true` o `POST /api/v1/templates/sync`.
   Solo quella lettura garantisce che Genuka WA tolga il suo rifiuto 132015: l'avviso di riattivazione
   ricevuto via webhook non sempre aggiorna il suo stato. Senza quella lettura, può
   continuare a rispondere 132015 dopo che Meta ha già riattivato il modello.
5. **Correggi la causa prima di riprendere**: targeting, frequenza, pertinenza del messaggio. Altrimenti la
   pausa successiva dura di più, e la terza disattiva il modello.

Meta ti permette anche di togliere manualmente la pausa a un modello, da WhatsApp Manager o tramite la sua
API `unpause`, e lo richiede per le pause causate dal *template pacing*. Genuka WA non espone
questa azione: usa WhatsApp Manager.

**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
/** Call before a bulk send: do not start on a template that is paused or in the red. */
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:
    """Call before a bulk send: do not start on a template that is paused or in the red."""
    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"
```

## Come prevengo l'errore 132015?

* **Tieni d'occhio la valutazione prima della pausa.** A `YELLOW`, Meta avverte che il modello rischia di essere
  messo in pausa; a `RED`, considera la pausa imminente. È quello il momento di rallentare.
* **Invia solo a persone che hanno acconsentito** ai tuoi messaggi, e al momento giusto.
* **Rendi ogni messaggio utile e atteso**: un promemoria di appuntamento viene segnalato di rado, una
  promozione generica inviata a tutta la tua lista spesso sì.
* **Tieni un modello di riserva** per ogni messaggio critico, con un altro nome.

## Codici di errore correlati

* [131048](https://wa.genuka.com/it/docs/errors/131048): non più un modello ma **il numero** è limitato per bassa
  qualità.
* [132001](https://wa.genuka.com/it/docs/errors/132001): il modello non si trova in quella lingua, oppure non è
  approvato.
* [131049](https://wa.genuka.com/it/docs/errors/131049): un modello di marketing trattenuto per uno specifico destinatario.

## FAQ

### Quanto dura la pausa di un modello?

3 ore la prima volta, 6 ore la seconda. La terza volta, il modello viene disattivato (errore
132016\) e devi crearne uno nuovo. Quando la pausa è finita, rileggi il modello con
`GET /api/v1/templates/{id}` così Genuka WA smette di rifiutarlo.

### I tentativi di invio durante la pausa vengono fatturati?

No. Meta precisa che non ti viene addebitato il tentativo di invio di un modello in pausa, e che il
tentativo non conta sul tuo limite di messaggistica. Viene semplicemente rifiutato.

### Modificare il modello toglie la pausa?

Non subito: la modifica lo rimanda in revisione, e non può essere inviato finché non viene approvato di nuovo.
Serve quando la causa è il contenuto, non per guadagnare tempo.

## Fonti

* [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)
