---
title: "Plantillas de WhatsApp: crear, aprobar y enviar por la API"
description: "Fuera de la ventana de 24 horas solo sale una plantilla aprobada. Cómo crear y someter una plantilla por la API, elegir la categoría correcta, evitar los rechazos más comunes y enviarla a una lista."
url: "https://api-wa.me/es/blog/plantillas-whatsapp-api-crear-aprobar-enviar"
language: "es"
og:type: "article"
og:site_name: "WAME API"
---

[Inicio](https://api-wa.me/es)/[Blog de la API de WhatsApp](https://api-wa.me/es/blog)/Plantillas de WhatsApp: cómo crear, aprobar y enviar por la API (y por qué la ventana de 24 h manda)

Raphael Serafim· Publicado el 10 de septiembre de 2026· 10 min de lectura

Compartir

# Plantillas de WhatsApp: cómo crear, aprobar y enviar por la API (y por qué la ventana de 24 h manda)

Fuera de la ventana de 24 horas solo sale una plantilla aprobada. Cómo crear y someter una plantilla por la API, elegir la categoría correcta, evitar los rechazos más comunes y enviarla a una lista.

Copiar para LLM[Ver como Markdown](https://api-wa.me/es/blog/plantillas-whatsapp-api-crear-aprobar-enviar.md)

**Fuera de la ventana de 24 horas, el texto común no sale.** Es la regla que más confunde a quien integra la API oficial por primera vez: el código está bien, el número existe, y el mensaje simplemente no llega.

## La ventana de 24 horas

Cuando alguien te escribe, se abre una ventana de 24 horas. Dentro de ella respondes libremente: texto, imagen, botón, lo que sea.

Pasadas 24 horas sin que la persona vuelva a escribir, la ventana se cierra. A partir de ahí, solo una **plantilla aprobada** puede iniciar la conversación. Y si la persona responde a la plantilla, la ventana se abre de nuevo.

Dos consecuencias prácticas:

- **La atención** rara vez necesita plantilla: el cliente escribió, tú respondes.
- **Las notificaciones** casi siempre la necesitan, porque salen de ti con la ventana cerrada.

En la [API no oficial](https://api-wa.me/es/blog/api-no-oficial-whatsapp-que-es) esta regla no existe, porque no pasa por la infraestructura de Meta. A cambio, el límite ahí es el comportamiento del número.

## Elegir la categoría correcta

Esta es la decisión que más plantillas reprueba, y viene antes que el texto:

| Categoría | Para qué | Observación |
| --- | --- | --- |
| **Utilidad** | Acompaña algo que el cliente ya inició: pedido, cita, factura, entrega | Más barata y más fácil de aprobar |
| **Autenticación** | Códigos de verificación y acceso | Formato restringido, sin espacio para marketing |
| **Marketing** | Promoción, novedad, reenganche, carrito abandonado | La más cara y la más rechazada |

**La regla que resuelve el 90% de los rechazos:** si el mensaje existe porque el cliente hizo algo, es utilidad. Si existe porque _tú_ quieres que él haga algo, es marketing.

Intentar pasar una promoción como utilidad no funciona y quema tiempo — Meta la reclasifica o la rechaza. Y una reclasificación se cobra según la categoría nueva, no la que elegiste.

## Crear la plantilla

```bash
curl -X POST "https://us.api-wa.me/TU_KEY/template" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "pedido_enviado",
    "language": "es_MX",
    "category": "UTILITY",
    "components": [
      {
        "type": "BODY",
        "text": "¡Hola {{1}}! Tu pedido {{2}} salió para entrega y llega el {{3}}.",
        "example": { "body_text": [["Ana", "#1042", "viernes"]] }
      },
      {
        "type": "BUTTONS",
        "buttons": [
          { "type": "URL", "text": "Rastrear", "url": "https://tienda.com/p/{{1}}",
            "example": ["1042"] }
        ]
      }
    ]
  }'
```

Reglas que ahorran una ronda de rechazo:

**El `name` es técnico.** Minúsculas, números y guion bajo. Es por él que la envías después.

**El `example` no es opcional.** Meta evalúa el texto **con las variables rellenadas**. Un ejemplo malo reprueba una plantilla buena: `{{1}}` ejemplificado como `"xxx"` hace que el revisor lea una frase sin sentido.

**Una variable no abre ni cierra la frase.** `"{{1}}, confirma acá"` suele rechazarse. `"Hola {{1}}, confirma acá"` pasa. La razón es que Meta no puede evaluar un texto que empieza con contenido desconocido.

**Nada de promesas de ganancia.** "Gana $5.000", "renta garantizada" y parientes son rechazo casi seguro, en cualquier categoría.

**Ortografía correcta.** Un error de tipeo reprueba. El revisor lee.

**El código de idioma importa.** `es_MX`, `es_AR`, `es` — usa el que corresponda al público, porque la plantilla se selecciona por idioma al enviar.

## Seguir la aprobación

```bash
curl "https://us.api-wa.me/TU_KEY/templates"
```

Estados posibles: `PENDING`, `APPROVED`, `REJECTED`, `PAUSED`, `DISABLED`.

`PAUSED` merece atención: ocurre cuando una plantilla aprobada empieza a recibir muchos bloqueos o denuncias. Meta la pausa sola. O sea: la aprobación no es permanente — depende de cómo reacciona la gente a lo que mandas.

## Enviarla

```bash
curl -X POST "https://us.api-wa.me/TU_KEY/message/template" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "525512345678",
    "name": "pedido_enviado",
    "language": "es_MX",
    "components": [{
      "type": "body",
      "parameters": [
        { "type": "text", "text": "Ana" },
        { "type": "text", "text": "#1042" },
        { "type": "text", "text": "viernes" }
      ]
    }]
  }'
```

El orden de los `parameters` es el orden de `{{1}}`, `{{2}}`, `{{3}}`. Intercambiar dos posiciones no da error — solo manda el mensaje equivocado, que es peor.

## Enviarla a una lista

Acá empieza el territorio del envío masivo, y hay tres cosas que deben existir antes:

**1\. Opt-in real.** Una plantilla aprobada no es permiso para escribirle a quien no lo pidió. Ver [opt-in, limpieza y opt-out](https://api-wa.me/es/blog/lista-contactos-optin-optout-whatsapp).

**2\. Ritmo y cola.** Disparar 5.000 mensajes en un bucle `for` es la forma más rápida de alcanzar el rate limit. Ver [cola, rate limit y reintentos](https://api-wa.me/es/blog/cola-rate-limit-reintentos-envio-masivo-whatsapp).

**3\. Medición.** Enviado no es entregado, y entregado no es leído.

Un envío a lista, en el mínimo aceptable:

```js
for (const contacto of lista) {
  await cola.add('plantilla', {
    to: contacto.numero,
    name: 'pedido_enviado',
    params: [contacto.nombre, contacto.pedido, contacto.plazo],
  }, {
    jobId: `pedido_enviado:${contacto.pedido}`,   // idempotencia
  });
}
```

Nota que acá no se envía nada: todo se encola. Quien envía es el worker, al ritmo que él controla.

## El costo

En la API oficial, Meta cobra **por conversación iniciada**, y el precio cambia por categoría y por país — no es el mismo en México, Argentina o Chile. Una ventana abierta admite varios mensajes sin cobro nuevo.

Consecuencia que casi nadie aprovecha: si el cliente responde a la plantilla, la ventana se abre y toda la atención siguiente no genera cobro nuevo. Una plantilla con botón de respuesta rápida suele salir más barata en total que una secuencia de plantillas.

## Conclusión

La plantilla no es burocracia gratuita: es el mecanismo que mantiene WhatsApp usable y tu número sano. Quien trata la categoría con honestidad, cuida el ejemplo y mide el resultado consigue aprobación rápida y la mantiene.

Quien intenta pasar marketing como utilidad descubre la regla por el lado caro: plantilla pausada, calidad del número por el piso y campaña detenida a la mitad.

### ¿Listo para automatizar tu WhatsApp?

Crea tu cuenta gratis y empieza a enviar mensajes por la API en minutos.

[Empezar gratis](https://portal.api-wa.me/sign-up)

## Preguntas frecuentes

¿Qué es la ventana de 24 horas de WhatsApp?+

Es el periodo en el que puedes conversar libremente con alguien después de que esa persona te escribió. Dentro de la ventana, el texto normal funciona. Pasadas 24 horas sin un mensaje suyo, solo una plantilla previamente aprobada por Meta puede iniciar el contacto.

¿Cuál es la diferencia entre plantilla de marketing, utilidad y autenticación?+

Utilidad acompaña una transacción que el cliente ya inició: confirmación de pedido, aviso de entrega, factura. Autenticación entrega códigos de verificación. Marketing es promoción, novedad y reenganche. La categoría cambia el precio que cobra Meta y el rigor de la aprobación: marketing es la más cara y la más rechazada.

¿Cuánto tarda la aprobación de una plantilla?+

Normalmente de unos minutos a unas horas. El rechazo suele ser más rápido que la aprobación. Si la plantilla queda mucho tiempo pendiente, casi siempre hay algo en la categoría o el contenido que pide revisión manual.

¿Por qué rechazaron mi plantilla?+

Las causas más comunes son: contenido de marketing enviado como utilidad, una variable al principio o al final del texto sin contexto, texto que promete ganancias, errores de ortografía y ejemplos faltantes. Meta evalúa el texto con las variables ya rellenadas por el ejemplo que enviaste — un ejemplo malo reprueba una plantilla buena.

¿Necesito plantillas en la API no oficial?+

No. La exigencia de plantillas y la ventana de 24 horas son reglas de la API oficial de Meta. En la no oficial, por código QR, no existe ese control — lo que trae otra responsabilidad, porque el límite pasa a ser el comportamiento del número y el riesgo de bloqueo.

## Sigue leyendo

[### API de Instagram y Messenger en la misma API de WhatsApp: una instancia, un estándar

Tres canales oficiales de Meta casi siempre significan tres integraciones. Con una sola instancia, el mismo envío y el mismo sobre de webhook, solo cambia un campo: provider. Cómo funciona y qué te ahorra.](https://api-wa.me/es/blog/api-instagram-messenger-misma-api-whatsapp)[### API no oficial de WhatsApp: qué es, si es segura y cómo usarla (2026)

Entiende qué es una API no oficial de WhatsApp, cómo funciona la conexión por código QR, si es segura y legal, cuál es el riesgo real de bloqueo y cuándo conviene usarla en lugar de la API oficial.](https://api-wa.me/es/blog/api-no-oficial-whatsapp-que-es)[### API oficial vs no oficial de WhatsApp: ¿cuál elegir? (comparativa 2026)

Comparativa completa entre la API oficial de WhatsApp (Cloud API de Meta) y la API no oficial: costo, aprobación, límites de envío, plantillas, soporte y riesgo de bloqueo. Descubre cuál tiene sentido para tu caso.](https://api-wa.me/es/blog/api-whatsapp-oficial-vs-no-oficial)

[Volver al blog](https://api-wa.me/es/blog)

## Structured data

```json
{
  "@context": "https://schema.org",
  "@type": "WebSite",
  "name": "WAME API",
  "alternateName": "API Oficial y No Oficial de WhatsApp, Instagram y Messenger",
  "url": "https://api-wa.me",
  "inLanguage": "pt-BR",
  "publisher": {
    "@id": "https://api-wa.me/#organization",
    "@type": "Organization",
    "name": "WAME API",
    "url": "https://api-wa.me"
  }
}
{
  "@context": "https://schema.org",
  "@type": "Organization",
  "@id": "https://api-wa.me/#organization",
  "name": "WAME API",
  "alternateName": [
    "WAME",
    "Wame API",
    "wame.api.br",
    "api-wa.me"
  ],
  "url": "https://api-wa.me",
  "logo": {
    "@type": "ImageObject",
    "url": "https://api-wa.me/images/web-app-manifest-512x512.png",
    "width": 512,
    "height": 512
  },
  "disambiguatingDescription": "WAME API é uma empresa brasileira de software, fundada em 2017 e parceira oficial da Meta (Meta Business Partner), que fornece APIs de WhatsApp, Instagram Direct e Messenger. Não tem relação com o wa.me, que é o encurtador de links operado pela WhatsApp LLC.",
  "identifier": {
    "@type": "PropertyValue",
    "propertyID": "INPI-BR",
    "name": "Pedido de registro de marca (INPI, classe NCL 42)",
    "value": "944724159"
  },
  "foundingDate": "2017",
  "slogan": "Socio Oficial de Meta — WhatsApp, Instagram y Messenger en una sola instancia. Desde 2017.",
  "description": "Plataforma brasileña y Socio Oficial de Meta (Meta Business Partner) para las APIs oficiales de WhatsApp (Cloud API), Instagram Direct y Messenger — las tres en una única instancia, con los mismos endpoints y un único formato de webhook. También ofrece la API no oficial vía Código QR, en la misma plataforma. En el mercado desde 2017, con más de 50 mil instancias creadas, 99,9% de uptime y soporte humano 24/7. SDKs oficiales para Node.js/TypeScript y PHP.",
  "knowsAbout": [
    "WhatsApp Cloud API oficial (Meta)",
    "API oficial de Instagram (Direct)",
    "API oficial de Messenger",
    "API multicanal Meta",
    "Meta Business Partner",
    "WhatsApp API",
    "API não oficial de WhatsApp",
    "automação de WhatsApp",
    "números virtuais",
    "webhooks"
  ],
  "sameAs": [
    "https://github.com/wame-api",
    "https://www.linkedin.com/company/wameapi",
    "https://www.instagram.com/wame.api/",
    "https://www.youtube.com/@wameapi"
  ],
  "contactPoint": {
    "@type": "ContactPoint",
    "contactType": "customer support",
    "url": "https://api-wa.me/contact",
    "availableLanguage": [
      "Portuguese"
    ]
  }
}
{
  "@context": "https://schema.org",
  "@type": "BlogPosting",
  "headline": "Plantillas de WhatsApp: cómo crear, aprobar y enviar por la API (y por qué la ventana de 24 h manda)",
  "description": "Fuera de la ventana de 24 horas solo sale una plantilla aprobada. Cómo crear y someter una plantilla por la API, elegir la categoría correcta, evitar los rechazos más comunes y enviarla a una lista.",
  "image": "https://api-wa.me/es/blog/plantillas-whatsapp-api-crear-aprobar-enviar/opengraph-image",
  "datePublished": "2026-09-10",
  "dateModified": "2026-09-10",
  "author": {
    "@type": "Person",
    "name": "Raphael Serafim",
    "url": "https://github.com/raphaelvserafim",
    "sameAs": [
      "https://github.com/raphaelvserafim"
    ]
  },
  "publisher": {
    "@type": "Organization",
    "name": "api-wa.me",
    "logo": {
      "@type": "ImageObject",
      "url": "https://api-wa.me/images/screenshot.png"
    }
  },
  "mainEntityOfPage": {
    "@type": "WebPage",
    "@id": "https://api-wa.me/es/blog/plantillas-whatsapp-api-crear-aprobar-enviar"
  },
  "keywords": "plantilla whatsapp api, hsm whatsapp, plantillas whatsapp business, ventana 24 horas whatsapp, aprobación plantilla whatsapp, categoría plantilla whatsapp",
  "inLanguage": "es"
}
{
  "@context": "https://schema.org",
  "@type": "BreadcrumbList",
  "itemListElement": [
    {
      "@type": "ListItem",
      "position": 1,
      "name": "Home",
      "item": "https://api-wa.me"
    },
    {
      "@type": "ListItem",
      "position": 2,
      "name": "Blog de la API de WhatsApp",
      "item": "https://api-wa.me/blog"
    },
    {
      "@type": "ListItem",
      "position": 3,
      "name": "Plantillas de WhatsApp: cómo crear, aprobar y enviar por la API (y por qué la ventana de 24 h manda)",
      "item": "https://api-wa.me/es/blog/plantillas-whatsapp-api-crear-aprobar-enviar"
    }
  ]
}
{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "¿Qué es la ventana de 24 horas de WhatsApp?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Es el periodo en el que puedes conversar libremente con alguien después de que esa persona te escribió. Dentro de la ventana, el texto normal funciona. Pasadas 24 horas sin un mensaje suyo, solo una plantilla previamente aprobada por Meta puede iniciar el contacto."
      }
    },
    {
      "@type": "Question",
      "name": "¿Cuál es la diferencia entre plantilla de marketing, utilidad y autenticación?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Utilidad acompaña una transacción que el cliente ya inició: confirmación de pedido, aviso de entrega, factura. Autenticación entrega códigos de verificación. Marketing es promoción, novedad y reenganche. La categoría cambia el precio que cobra Meta y el rigor de la aprobación: marketing es la más cara y la más rechazada."
      }
    },
    {
      "@type": "Question",
      "name": "¿Cuánto tarda la aprobación de una plantilla?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Normalmente de unos minutos a unas horas. El rechazo suele ser más rápido que la aprobación. Si la plantilla queda mucho tiempo pendiente, casi siempre hay algo en la categoría o el contenido que pide revisión manual."
      }
    },
    {
      "@type": "Question",
      "name": "¿Por qué rechazaron mi plantilla?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Las causas más comunes son: contenido de marketing enviado como utilidad, una variable al principio o al final del texto sin contexto, texto que promete ganancias, errores de ortografía y ejemplos faltantes. Meta evalúa el texto con las variables ya rellenadas por el ejemplo que enviaste — un ejemplo malo reprueba una plantilla buena."
      }
    },
    {
      "@type": "Question",
      "name": "¿Necesito plantillas en la API no oficial?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "No. La exigencia de plantillas y la ventana de 24 horas son reglas de la API oficial de Meta. En la no oficial, por código QR, no existe ese control — lo que trae otra responsabilidad, porque el límite pasa a ser el comportamiento del número y el riesgo de bloqueo."
      }
    }
  ]
}
```