Genuka WA docs

Errore WhatsApp 132000: numero di parametri del modello non corrispondente

Errore WhatsApp 132000 (Template Param Count Mismatch): le variabili che hai inviato non corrispondono al modello. Come contarle e inviarle correttamente.

L'errore WhatsApp 132000 significa che il numero di valori che hai inviato per le variabili del modello non corrisponde al numero di variabili che il modello contiene. Meta rifiuta il messaggio senza inviarlo. Conta le variabili del modello approvato, intestazione e corpo, poi invia esattamente un valore per variabile, nell'ordine giusto.

Cosa significa l'errore 132000?

"The number of variable parameter values included in the request did not match the number of variable parameters defined in the template." — Meta, Cloud API error codes

Meta ti chiede di assicurarti che la richiesta includa un valore per ogni parametro richiesto dal modello. Il titolo che accompagna il codice nel campo message è "Template Param Count Mismatch" (elenco di 360dialog).

Un modello dichiara le sue variabili in un formato scelto al momento della creazione (Meta, Templates, parameter formats):

FormatoCome si scrive nel modelloRegola al momento dell'invio
Posizionale (default){{1}}, {{2}}…I valori seguono l'ordine delle variabili nel testo
Con nome{{first_name}} (minuscole e underscore)I valori possono arrivare in qualsiasi ordine

Quando si verifica l'errore 132000?

  • Una variabile dell'intestazione dimenticata: il titolo "Ordine {{1}} spedito" ha una sua variabile, che non viene riempita da quelle del corpo.
  • Un modello modificato dopo l'integrazione: è stata aggiunta una variabile al testo, il codice invia ancora il vecchio numero di valori.
  • Una campagna con variabili disomogenee: alcuni destinatari hanno due valori, altri uno.
  • Un array vuoto o mancante perché nella tua app mancava un dato (nome sconosciuto, un numero d'ordine filtrato perché null).

Dove lo vedi in Genuka WA?

CanaleCosa ottieni
Risposta di POST /api/v1/messages400, "error": "send_template", meta.code: 132000, meta.retryable: false
CampagnaI destinatari coinvolti diventano failed; se le variabili hanno la stessa forma per tutti, fallisce allo stesso modo l'intera campagna

Genuka WA classifica ogni codice 132xxx come template: l'errore sta nella richiesta, e inviarla di nuovo senza modifiche fallirà sempre.

Come risolvo l'errore 132000?

Leggi il modello così come è stato approvato con GET /api/v1/templates/{id}: il campo components contiene il testo dell'intestazione e del corpo.

Conta le variabili di ogni componente: quelle dell'intestazione testuale da un lato, quelle del corpo dall'altro.

Metti ogni valore nel campo giusto di template:

Nel modelloIn POST /api/v1/messages
Corpo posizionale {{1}}, {{2}}body (o il suo alias variables): un array, in ordine
Corpo con nomi {{first_name}}bodyNamed: un oggetto { "first_name": "Awa" }
Intestazione testuale con {{1}}header: { "text": "ORD-1042" }
Intestazione immagine, video o documentoheader: { "image": { "assetId": "ast_1" } }
Pulsante con URL dinamicobuttons: [{ "type": "url", "text": "1042" }]
Modello di autenticazioneotp: "472913", che riempie sia il corpo sia il pulsante
# 1. The template as approved
curl https://wa.genuka.com/api/v1/templates/tpl_123 \
  -H "Authorization: Bearer $GENUKA_WA_API_KEY"
# "components": [
#   { "type": "HEADER", "format": "TEXT", "text": "Order {{1}} shipped" },
#   { "type": "BODY", "text": "Hi {{1}}, your parcel arrives {{2}}." }
# ]

# 2. One value for the header, two for the body
curl -X POST https://wa.genuka.com/api/v1/messages \
  -H "Authorization: Bearer $GENUKA_WA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "connectionId": "con_1",
    "to": "+237690000001",
    "template": {
      "name": "parcel_shipped",
      "language": "en",
      "header": { "text": "ORD-1042" },
      "body": ["Awa", "tomorrow"]
    }
  }'

Come prevengo l'errore 132000?

  • Valida prima di inviare, con un contatore come quello qui sopra, e rifiuta localmente una richiesta incompleta: l'errore emerge prima e indica il dato mancante.
  • Versiona i tuoi modelli (parcel_shipped_v2) quando cambi le loro variabili, invece di modificare un modello su cui il tuo codice già si basa.
  • Controlla ogni destinatario della campagna prima di POST /api/v1/campaigns: lo stesso numero di valori per tutti, nessun valore vuoto.
  • Controlla anche il formato: un modello creato con parametri con nome si riempie con bodyNamed, non con un array.

Codici di errore correlati

  • 132001: il modello stesso non si trova in quella lingua, oppure non è approvato.
  • 132015: il modello è in pausa per bassa qualità.
  • 131047: la finestra di 24 ore è chiusa, da qui il passaggio a un modello.

FAQ

Gli esempi forniti alla creazione contano al momento dell'invio?

No. Gli esempi servono alla revisione del modello da parte di Meta; al momento dell'invio fornisci i valori reali, uno per variabile.

L'ordine dei valori conta?

Per un modello posizionale, sì: il primo valore riempie {{1}}, il secondo {{2}}. Per un modello con nomi, no: Meta accetta i valori in qualsiasi ordine.

Perché tutta la mia campagna fallisce con 132000?

Perché l'errore viene dalla forma delle variabili, che è la stessa per ogni destinatario. Genuka WA non riprova un errore di modello, e una campagna già lanciata rinvia solo i destinatari ancora pending: correggi le variabili, poi crea una nuova campagna.

Fonti

In questa pagina