# Error 132001 de WhatsApp: la plantilla no existe — solución

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

> 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.

El error 132001 de WhatsApp significa que Meta no encuentra una plantilla aprobada con este nombre en este idioma,
en la cuenta de WhatsApp Business que hace el envío. La mayoría de las veces es el código de idioma: `en`
y `en_US` son dos plantillas distintas. Revisa el nombre, el idioma exacto y el estado, y luego
vuelve a enviar.

## ¿Qué significa el error 132001?

> "The template does not exist in the specified language or the template has not been approved."
> — [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 plantilla haya sido aprobada y de que su nombre y su configuración regional de idioma
sean correctos. El título que acompaña al código en el campo `message` es "Template does not
exist" ([lista de 360dialog](https://docs.360dialog.com/docs/support/api-error-message-list)).

Tres reglas de Meta explican la mayoría de los casos:

* **Una plantilla se identifica por su nombre y su idioma.** Crear el mismo nombre en varios
  idiomas produce varias plantillas, cada una contada por separado
  ([Meta, Templates](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/overview)).
* **Los códigos de idioma son exactos.** `en`, `en_US` y `en_GB` son tres idiomas distintos, al igual que
  `es`, `es_AR`, `es_ES` y `es_MX`
  ([Meta, Supported languages](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/supported-languages)).
* **Una plantilla pertenece a una cuenta de WhatsApp Business.** No existe para un número vinculado
  a otra cuenta. Una plantilla inactiva durante 12 meses o más se archiva y luego se elimina 28 días
  después, salvo que se desarchive.

## ¿Cuándo ocurre el error 132001?

* **El idioma que envías no es el de la plantilla**, por ejemplo `en_US` para una plantilla creada como
  `en`, o `es_MX` para una plantilla creada como `es`.
* **El idioma se omite en uno de los dos lados.** Esta es la trampa propia de la API de Genuka WA:
  sin `language`, una plantilla se **crea** como `en`, pero un mensaje se **envía** como `en_US`. Por lo tanto, una
  plantilla creada y enviada sin idioma termina en 132001.
* **La plantilla todavía no está aprobada**, o fue rechazada.
* **El nombre difiere**: un error de tipeo, una mayúscula, un sufijo `_v2` olvidado.
* **El número está en la cuenta equivocada**: una plantilla creada para un cliente, enviada desde el número
  de otro cliente.

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

Genuka WA mantiene un espejo de las plantillas creadas a través de él, por API o desde el panel. Cuando
conoce la plantilla solicitada en ese idioma, rechaza el envío por su cuenta si la plantilla no está
aprobada, e indica el motivo. Cuando no la conoce, por ejemplo una plantilla creada en
el Administrador de WhatsApp (en inglés, *WhatsApp Manager*), la solicitud va a Meta, que la envía o responde 132001.

| Situación                                          | Respuesta de `POST /api/v1/messages`                                                                                                                                                                                                  |
| -------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Plantilla desconocida para Genuka WA en ese idioma | `400`, `"error": "send_template"`, `meta.code: 132001` (respuesta de Meta)                                                                                                                                                            |
| Plantilla conocida, en revisión                    | `400`, `"error": "send_template"`, `message`: `Template "x" is still under review by Meta`                                                                                                                                            |
| Plantilla conocida, rechazada                      | `400`, `"error": "send_template"`, `message`: `Template "x" was rejected during review and cannot be sent`, seguido del motivo                                                                                                        |
| Plantilla conocida, pausada o desactivada          | `400`, `"error": "send_template"`, `meta.code`: [132015](https://wa.genuka.com/es/docs/errors/132015) o 132016. Ese 132016 también puede indicar una plantilla que Meta solo marcó (`FLAGGED`): vuelve a leerla, consulta [132015](https://wa.genuka.com/es/docs/errors/132015) |

Al crear una campaña, una plantilla y un número que no pertenecen al mismo cliente se
rechazan de entrada con `400 template_connection_mismatch`.

## ¿Cómo corrijo el error 132001?

1. **Vuelve a leer tus plantillas** con `GET /api/v1/templates?sync=true`, filtradas por `companyId` si
   hace falta: cada fila da un `name`, un `language` y un `status` actualizados. Esa lista solo contiene las
   plantillas creadas a través de Genuka WA: la sincronización actualiza su estado, pero no importa las
   creadas en el Administrador de WhatsApp. Para esas, revisa nombre, idioma y estado en el Administrador de WhatsApp.
2. **Compara carácter por carácter** el nombre y el idioma de la fila que buscas con lo que envía tu código.
3. **Actúa según el estado**: `pending`, espera la revisión; `rejected`, corrígela y vuelve a enviarla a revisión;
   ausente en ese idioma, también en el Administrador de WhatsApp, crea la traducción con
   `POST /api/v1/templates`, mismo nombre, nuevo `language`.
4. **Vuelve a enviar, siempre pasando `language`**, con exactamente el valor de la fila que encontraste.

**curl**

```bash
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", ... } ] }
```

**Node.js**

```ts
/**
 * El idioma exacto en el que está aprobada una plantilla creada a través de Genuka WA, o un error explícito.
 * Una plantilla creada en WhatsApp Manager no está en esta lista.
 */
export async function approvedLanguage(companyId: string, name: string, wanted: string) {
  const url = new URL("https://wa.genuka.com/api/v1/templates");
  url.search = new URLSearchParams({ sync: "true", companyId, status: "approved" }).toString();

  const response = await fetch(url, {
    headers: { Authorization: `Bearer ${process.env.GENUKA_WA_API_KEY}` },
  });
  const { data } = (await response.json()) as { data: { name: string; language: string }[] };

  const languages = data.filter((t) => t.name === name).map((t) => t.language);
  if (languages.includes(wanted)) return wanted;
  throw new Error(
    languages.length === 0
      ? `"${name}" no se encontró entre las plantillas aprobadas en Genuka WA (revisa WhatsApp Manager)`
      : `"${name}" está aprobada en ${languages.join(", ")}, no en ${wanted}`,
  );
}
```

**Python**

```python
import os
import requests


def approved_language(company_id: str, name: str, wanted: str) -> str:
    """El idioma exacto en el que está aprobada una plantilla creada a través de Genuka WA.

    Una plantilla creada en WhatsApp Manager no está en esta lista.
    """
    response = requests.get(
        "https://wa.genuka.com/api/v1/templates",
        params={"sync": "true", "companyId": company_id, "status": "approved"},
        headers={
            "Authorization": f"Bearer {os.environ['GENUKA_WA_API_KEY']}",
            "User-Agent": "acme-crm/1.0 (+https://example.com)",
        },
        timeout=60,
    )
    response.raise_for_status()
    languages = [t["language"] for t in response.json()["data"] if t["name"] == name]
    if wanted in languages:
        return wanted
    if not languages:
        raise LookupError(f'"{name}" no se encontró entre las plantillas aprobadas en Genuka WA (revisa WhatsApp Manager)')
    raise LookupError(f'"{name}" está aprobada en {", ".join(languages)}, no en {wanted}')
```

**PHP**

```php
<?php
$query = http_build_query(["sync" => "true", "companyId" => "cmp_1", "status" => "approved"]);
$ch = curl_init("https://wa.genuka.com/api/v1/templates?{$query}");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_USERAGENT => "acme-crm/1.0 (+https://example.com)",
    CURLOPT_HTTPHEADER => ["Authorization: Bearer " . getenv("GENUKA_WA_API_KEY")],
]);
$templates = json_decode(curl_exec($ch), true)["data"];
curl_close($ch);

foreach ($templates as $template) {
    echo "{$template['name']} [{$template['language']}] {$template['status']}\n";
}
```

## ¿Cómo evito el error 132001?

* **Guarda el par nombre + idioma**, nunca solo el nombre, en tu configuración.
* **Envía siempre `language`**, incluso cuando creas que el valor predeterminado sirve: no es el mismo al
  crear (`en`) que al enviar (`en_US`).
* **Crea cada idioma que necesites**: un envío en `es_AR` falla si solo existe la plantilla `es`.
  Lo más simple suele ser usar un solo código por idioma, `es` o `en`.
* **Escucha el webhook `message_template_status_update`** y usa una plantilla nueva solo cuando
  esté aprobada; `GET /api/v1/templates?sync=true` corrige un estado que quedó desactualizado.

## Códigos de error relacionados

* [132000](https://wa.genuka.com/es/docs/errors/132000): la plantilla se encuentra, pero la cantidad de variables no
  coincide.
* [132015](https://wa.genuka.com/es/docs/errors/132015): la plantilla existe y fue aprobada, pero está pausada.
* [131047](https://wa.genuka.com/es/docs/errors/131047): la ventana de 24 horas está cerrada, el motivo habitual para pasar
  a una plantilla.

## Preguntas frecuentes

### Mi plantilla está aprobada en WhatsApp Manager, ¿por qué recibo 132001?

Tres sospechosos, en este orden: el código de idioma que envías no es exactamente el de la plantilla, el
número que envía pertenece a otra cuenta de WhatsApp Business, o el nombre difiere en un
carácter.

### ¿`en` y `en_US` son el mismo idioma para Meta?

No. Son dos códigos distintos en la lista de Meta, por lo tanto dos plantillas distintas. Una plantilla creada como
`en` no responde a un envío en `en_US`.

### ¿Puede desaparecer una plantilla sin que yo la elimine?

Sí. Meta archiva una plantilla que lleva 12 meses o más inactiva y luego la elimina 28
días después, salvo que se desarchive. Una plantilla de reactivación poco usada es la candidata típica.

## Fuentes

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