Genuka WA docs

Errore WhatsApp 132001: il modello non esiste — soluzione

Errore WhatsApp 132001 (Template does not exist): nessun modello approvato in quella lingua. La trappola en vs en_US, e come verificare nome, lingua e stato.

L'errore WhatsApp 132001 significa che Meta non trova un modello approvato con questo nome in questa lingua, sul WhatsApp Business Account che effettua l'invio. Il più delle volte è il codice lingua: en e en_US sono due modelli diversi. Verifica il nome, la lingua esatta e lo stato, poi invia di nuovo.

Cosa significa l'errore 132001?

"The template does not exist in the specified language or the template has not been approved." — Meta, Cloud API error codes

Meta ti chiede di assicurarti che il modello sia stato approvato, e che il suo nome e la sua lingua siano corretti. Il titolo che accompagna il codice nel campo message è "Template does not exist" (elenco di 360dialog).

Tre regole di Meta spiegano la maggior parte dei casi:

  • Un modello è identificato dal suo nome e dalla sua lingua. Creare lo stesso nome in più lingue produce più modelli, ciascuno contato separatamente (Meta, Templates).
  • I codici lingua sono esatti. en, en_US e en_GB sono tre lingue distinte, così come fr, fr_BE, fr_CA e fr_CH (Meta, Supported languages).
  • Un modello appartiene a un WhatsApp Business Account. Non esiste per un numero collegato a un altro account. Un modello inattivo da 12 mesi o più viene archiviato, poi eliminato 28 giorni dopo, a meno che non venga ripristinato dall'archivio.

Quando si verifica l'errore 132001?

  • La lingua che invii non è quella del modello, per esempio en_US per un modello creato come en, oppure fr_CA per un modello creato come fr.
  • La lingua viene omessa da una delle due parti. È la trappola specifica dell'API di Genuka WA: senza language, un modello viene creato come en, ma un messaggio viene inviato come en_US. Un modello creato e inviato senza lingua finisce quindi in 132001.
  • Il modello non è ancora approvato, oppure è stato rifiutato.
  • Il nome è diverso: un errore di battitura, una maiuscola, un suffisso _v2 dimenticato.
  • Il numero è sull'account sbagliato: un modello creato per un cliente, inviato dal numero di un altro cliente.

Dove lo vedi in Genuka WA?

Genuka WA tiene una copia dei modelli creati tramite la piattaforma, via API o dalla dashboard. Quando conosce il modello richiesto in quella lingua, rifiuta lei stessa l'invio se il modello non è approvato, e ne indica il motivo. Quando non lo conosce, per esempio un modello creato in WhatsApp Manager, la richiesta va a Meta, che lo invia oppure risponde 132001.

SituazioneRisposta di POST /api/v1/messages
Modello sconosciuto a Genuka WA in quella lingua400, "error": "send_template", meta.code: 132001 (la risposta di Meta)
Modello noto, in revisione400, "error": "send_template", message: Template "x" is still under review by Meta
Modello noto, rifiutato400, "error": "send_template", message: Template "x" was rejected during review and cannot be sent, seguito dal motivo
Modello noto, in pausa o disattivato400, "error": "send_template", meta.code: 132015 o 132016. Quel 132016 può anche indicare un modello che Meta ha solo segnalato (FLAGGED): rileggilo, vedi 132015

Alla creazione di una campagna, un modello e un numero che non appartengono allo stesso cliente vengono rifiutati subito con 400 template_connection_mismatch.

Come risolvo l'errore 132001?

Rileggi i tuoi modelli con GET /api/v1/templates?sync=true, filtrati per companyId se serve: ogni riga riporta name, language e status aggiornati. Quell'elenco contiene solo i modelli creati tramite Genuka WA: la sincronizzazione aggiorna il loro stato ma non importa quelli creati in WhatsApp Manager. Per questi, verifica nome, lingua e stato in WhatsApp Manager.

Confronta carattere per carattere il nome e la lingua della riga che ti interessa con ciò che il tuo codice invia.

Agisci in base allo stato: pending, aspetta la revisione; rejected, correggilo e invialo di nuovo in revisione; assente in quella lingua, anche in WhatsApp Manager, crea la traduzione con POST /api/v1/templates, stesso nome, nuovo language.

Invia di nuovo, passando sempre language, esattamente con il valore della riga che hai trovato.

curl "https://wa.genuka.com/api/v1/templates?sync=true&companyId=cmp_1&status=approved" \
  -H "Authorization: Bearer $GENUKA_WA_API_KEY"
# { "data": [ { "id": "tpl_1", "name": "order_update", "language": "en", "status": "approved", ... } ] }

Come prevengo l'errore 132001?

  • Salva la coppia nome + lingua, mai il nome da solo, nella tua configurazione.
  • Invia sempre language, anche quando pensi che il default vada bene: non è lo stesso alla creazione (en) e all'invio (en_US).
  • Crea ogni lingua che ti serve: un invio in fr_BE fallisce se esiste solo il modello fr. L'approccio più semplice è spesso un solo codice per lingua, fr o en.
  • Ascolta il webhook message_template_status_update e usa un nuovo modello solo quando è approvato; GET /api/v1/templates?sync=true corregge uno stato rimasto indietro.

Codici di errore correlati

  • 132000: il modello viene trovato, ma il numero di variabili non corrisponde.
  • 132015: il modello esiste ed è stato approvato, ma è in pausa.
  • 131047: la finestra di 24 ore è chiusa, il motivo abituale per passare a un modello.

FAQ

Il mio modello è approvato in WhatsApp Manager, allora perché 132001?

Tre sospettati, in quest'ordine: il codice lingua che invii non è esattamente quello del modello, il numero mittente appartiene a un altro WhatsApp Business Account, oppure il nome differisce di un carattere.

en e en_US sono la stessa lingua per Meta?

No. Sono due codici distinti nell'elenco di Meta, quindi due modelli distinti. Un modello creato come en non risponde a un invio in en_US.

Un modello può sparire senza che io lo elimini?

Sì. Meta archivia un modello inattivo da 12 mesi o più, poi lo elimina 28 giorni dopo, a meno che non venga ripristinato dall'archivio. Un modello di riattivazione usato di rado è il candidato tipico.

Fonti

In questa pagina