# Errore WhatsApp 132000: numero di parametri del modello non corrispondente

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

> 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](https://developers.facebook.com/documentation/business-messaging/whatsapp/support/error-codes#other-errors)

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](https://docs.360dialog.com/docs/support/api-error-message-list)).

Un modello dichiara le sue variabili in un formato scelto al momento della creazione
([Meta, Templates, parameter formats](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/overview)):

| Formato               | Come si scrive nel modello                | Regola 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?

| Canale                              | Cosa ottieni                                                                                                                                 |
| ----------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| Risposta di `POST /api/v1/messages` | `400`, `"error": "send_template"`, `meta.code: 132000`, `meta.retryable: false`                                                              |
| Campagna                            | I 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?

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

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

3. **Metti ogni valore nel campo giusto** di `template`:

   | Nel modello                              | In `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 documento | `header: { "image": { "assetId": "ast_1" } }`             |
   | Pulsante con URL dinamico                | `buttons: [{ "type": "url", "text": "1042" }]`            |
   | Modello di autenticazione                | `otp: "472913"`, che riempie sia il corpo sia il pulsante |

**curl**

```bash
# 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"]
    }
  }'
```

**Node.js**

```ts
type Component = { type: string; format?: string; text?: string };

const VARIABLE = /\{\{\s*([a-z0-9_]+)\s*\}\}/g;

/** How many values the template expects, per component. */
export function expectedParams(components: Component[]) {
  const count = (type: string) => {
    const component = components.find((c) => c.type.toUpperCase() === type);
    if (!component?.text) return 0;
    if (type === "HEADER" && component.format && component.format.toUpperCase() !== "TEXT") return 0;
    return new Set([...component.text.matchAll(VARIABLE)].map((match) => match[1])).size;
  };
  return { header: count("HEADER"), body: count("BODY") };
}

// Before sending: refuse locally rather than letting Meta answer 132000.
const { data: template } = await fetch("https://wa.genuka.com/api/v1/templates/tpl_123", {
  headers: { Authorization: `Bearer ${process.env.GENUKA_WA_API_KEY}` },
}).then((response) => response.json());

const expected = expectedParams(template.components);
const body = ["Awa", "tomorrow"];
if (body.length !== expected.body) {
  throw new Error(`The body expects ${expected.body} value(s), got ${body.length}`);
}
```

**Python**

```python
import re

VARIABLE = re.compile(r"\{\{\s*([a-z0-9_]+)\s*\}\}")


def expected_params(components: list[dict]) -> dict:
    """How many values the template expects, per component."""

    def count(kind: str) -> int:
        component = next((c for c in components if c.get("type", "").upper() == kind), None)
        if not component or not component.get("text"):
            return 0
        if kind == "HEADER" and component.get("format", "TEXT").upper() != "TEXT":
            return 0
        return len(set(VARIABLE.findall(component["text"])))

    return {"header": count("HEADER"), "body": count("BODY")}
```

## 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](https://wa.genuka.com/it/docs/errors/132001): il modello stesso non si trova in quella lingua, oppure non è
  approvato.
* [132015](https://wa.genuka.com/it/docs/errors/132015): il modello è in pausa per bassa qualità.
* [131047](https://wa.genuka.com/it/docs/errors/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

* [Meta — Error codes](https://developers.facebook.com/documentation/business-messaging/whatsapp/support/error-codes)
* [Meta — Templates overview, parameter formats](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/overview)
* [360dialog — API error message list](https://docs.360dialog.com/docs/support/api-error-message-list)
