Error 132000 de WhatsApp: número de variables incorrecto en la plantilla
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
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).
Una plantilla declara sus variables en un formato elegido al crearla (Meta, Templates, parameter formats):
| 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?
Lee la plantilla tal como fue aprobada con GET /api/v1/templates/{id}: el campo components contiene
el texto del encabezado y del cuerpo.
Cuenta las variables de cada componente: las del encabezado de texto por un lado, las del cuerpo por el otro.
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 |
# 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"]
}
}'¿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: la plantilla en sí no existe en ese idioma o no está aprobada.
- 132015: la plantilla está pausada por baja calidad.
- 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
Error 131050 de WhatsApp: el usuario dejó de recibir marketing
Error 131050 de WhatsApp: el destinatario dejó de recibir tus mensajes de marketing. Por qué nunca debes reintentar y cómo Genuka WA bloquea los envíos que vendrían después.
Error 132001 de WhatsApp: la plantilla no existe — solución
Error 132001 de WhatsApp (Template does not exist): no hay una plantilla aprobada en ese idioma. La trampa de en vs en_US y cómo revisar nombre, idioma y estado.