# Error 132000 de WhatsApp: número de variables incorrecto en la plantilla

URL: https://wa.genuka.com/es/docs/errors/132000
Language: Spanish

> Error 132000 de WhatsApp (Template Param Count Mismatch): las variables que enviaste no coinciden con la plantilla. Cómo contarlas y enviarlas correctamente.

El error 132000 de WhatsApp significa que la cantidad de valores que enviaste para las variables de la
plantilla no coincide con la cantidad de variables que contiene la plantilla. Meta rechaza el mensaje sin enviarlo.
Cuenta las variables de la plantilla aprobada, encabezado y cuerpo, y luego envía exactamente un valor por
variable, en el orden correcto.

## ¿Qué significa el error 132000?

> "The number of variable parameter values included in the request did not match the number of
> variable parameters defined in the template."
> — [Meta, códigos de error de la Cloud API](https://developers.facebook.com/documentation/business-messaging/whatsapp/support/error-codes#other-errors)

Meta te pide asegurarte de que la solicitud incluya un valor para **cada** parámetro que exige la
plantilla. El título que acompaña al código en el campo `message` es "Template Param Count
Mismatch" ([lista de 360dialog](https://docs.360dialog.com/docs/support/api-error-message-list)).

Una plantilla declara sus variables en un formato elegido al crearla
([Meta, Templates, parameter formats](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/overview)):

| Formato                     | Cómo se escribe en la plantilla               | Regla al enviar                                          |
| --------------------------- | --------------------------------------------- | -------------------------------------------------------- |
| Posicional (predeterminado) | `{{1}}`, `{{2}}`…                             | Los valores siguen el orden de las variables en el texto |
| Con nombre                  | `{{first_name}}` (minúsculas y guiones bajos) | Los valores pueden llegar en cualquier orden             |

## ¿Cuándo ocurre el error 132000?

* **Una variable del encabezado olvidada**: el título "Pedido `{{1}}` enviado" tiene su propia variable,
  que no se llena con las del cuerpo.
* **Una plantilla modificada después de la integración**: se agregó una variable al texto y el código todavía
  envía la cantidad anterior de valores.
* **Una campaña con variables desiguales**: algunos destinatarios tienen dos valores, otros uno.
* **Un arreglo vacío o ausente** porque faltaba un dato en tu aplicación (nombre desconocido,
  un número de pedido descartado por ser `null`).

### ¿Dónde lo ves en Genuka WA?

| Canal                                | Lo que recibes                                                                                                                                |
| ------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------- |
| Respuesta de `POST /api/v1/messages` | `400`, `"error": "send_template"`, `meta.code: 132000`, `meta.retryable: false`                                                               |
| Campaña                              | Los destinatarios afectados pasan a `failed`; si las variables tienen la misma forma para todos, **toda** la campaña falla de la misma manera |

Genuka WA clasifica todos los códigos 132xxx como `template`: el error está en la solicitud, y volver a enviarla
sin cambios siempre fallará.

## ¿Cómo corrijo el error 132000?

1. **Lee la plantilla tal como fue aprobada** con `GET /api/v1/templates/{id}`: el campo `components` contiene
   el texto del encabezado y del cuerpo.

2. **Cuenta las variables de cada componente**: las del encabezado de texto por un lado, las del cuerpo por el otro.

3. **Coloca cada valor en el campo correcto** de `template`:

   | En la plantilla                         | En `POST /api/v1/messages`                               |
   | --------------------------------------- | -------------------------------------------------------- |
   | Cuerpo posicional `{{1}}`, `{{2}}`      | `body` (o su alias `variables`): un arreglo, en orden    |
   | Cuerpo con nombre `{{first_name}}`      | `bodyNamed`: un objeto `{ "first_name": "Awa" }`         |
   | Encabezado de texto con `{{1}}`         | `header: { "text": "ORD-1042" }`                         |
   | Encabezado de imagen, video o documento | `header: { "image": { "assetId": "ast_1" } }`            |
   | Botón de URL dinámica                   | `buttons: [{ "type": "url", "text": "1042" }]`           |
   | Plantilla de autenticación              | `otp: "472913"`, que llena a la vez el cuerpo y el botón |

**curl**

```bash
# 1. La plantilla tal como fue aprobada
curl https://wa.genuka.com/api/v1/templates/tpl_123 \
  -H "Authorization: Bearer $GENUKA_WA_API_KEY"
# "components": [
#   { "type": "HEADER", "format": "TEXT", "text": "Pedido {{1}} enviado" },
#   { "type": "BODY", "text": "Hola {{1}}, tu paquete llega {{2}}." }
# ]

# 2. Un valor para el encabezado, dos para el cuerpo
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": "es",
      "header": { "text": "ORD-1042" },
      "body": ["Awa", "mañana"]
    }
  }'
```

**Node.js**

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

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

/** Cuántos valores espera la plantilla, por componente. */
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") };
}

// Antes de enviar: rechaza localmente en lugar de dejar que Meta responda 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", "mañana"];
if (body.length !== expected.body) {
  throw new Error(`El cuerpo espera ${expected.body} valor(es), se recibieron ${body.length}`);
}
```

**Python**

```python
import re

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


def expected_params(components: list[dict]) -> dict:
    """Cuántos valores espera la plantilla, por componente."""

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

## ¿Cómo evito el error 132000?

* **Valida antes de enviar**, con un contador como el de arriba, y rechaza localmente una solicitud incompleta:
  el error aparece antes y nombra el dato que falta.
* **Versiona tus plantillas** (`parcel_shipped_v2`) cuando cambies sus variables, en lugar de
  editar una plantilla de la que tu código ya depende.
* **Revisa cada destinatario de la campaña** antes de `POST /api/v1/campaigns`: la misma cantidad de valores para
  todos, ningún valor vacío.
* **Revisa también el formato**: una plantilla creada con parámetros con nombre se llena con `bodyNamed`,
  no con un arreglo.

## Códigos de error relacionados

* [132001](https://wa.genuka.com/es/docs/errors/132001): la plantilla en sí no existe en ese idioma o no está
  aprobada.
* [132015](https://wa.genuka.com/es/docs/errors/132015): la plantilla está pausada por baja calidad.
* [131047](https://wa.genuka.com/es/docs/errors/131047): la ventana de 24 horas está cerrada, de ahí el paso a una plantilla.

## Preguntas frecuentes

### ¿Cuentan al enviar los ejemplos que diste al crear la plantilla?

No. Los ejemplos sirven para la revisión de la plantilla por parte de Meta; al enviar proporcionas los valores
reales, uno por variable.

### ¿Importa el orden de los valores?

En una plantilla posicional, sí: el primer valor llena `{{1}}`, el segundo `{{2}}`. En una plantilla
con nombre, no: Meta acepta los valores en cualquier orden.

### ¿Por qué falla toda mi campaña con 132000?

Porque el error viene de la forma de las variables, que es la misma para todos los destinatarios.
Genuka WA no reintenta un error de plantilla, y una campaña ya lanzada solo reenvía a
los destinatarios que siguen en `pending`: corrige las variables y luego crea una nueva campaña.

## Fuentes

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