Genuka WA docs

Errore WhatsApp 132015: modello in pausa — causa e soluzione

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

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). 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). 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:

OccorrenzaConseguenza
1ª voltaIn pausa per 3 ore
2ª voltaIn pausa per 6 ore
3ª voltaDisattivato: 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?

CanaleCosa ottieni
Risposta di POST /api/v1/messages400, "error": "send_template", meta.code: 132015
Lancio di una campagnaSe 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_updateL'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:

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), 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?

Ferma gli invii automatici che usano questo modello. Lo consiglia Meta: verrebbero comunque rifiutati finché dura la pausa.

Passa a un modello di riserva per i messaggi che non possono aspettare, come una conferma d'ordine.

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.

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.

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 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", ... }, ... } }

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: non più un modello ma il numero è limitato per bassa qualità.
  • 132001: il modello non si trova in quella lingua, oppure non è approvato.
  • 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

In questa pagina