> For the complete documentation index, see [llms.txt](https://docs.dapta.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dapta.ai/dapta-docs-es/agentes-de-texto/canales/plantillas-de-mensajes.md).

# Plantillas de mensajes

Crea, envía a aprobación, importa y manda plantillas de WhatsApp, y consigue que queden aprobadas para la línea desde la que realmente envías.

Usa **Agentes de texto → Plantillas** para administrar los mensajes con los que tu negocio escribe primero. Conecta antes una [línea de WhatsApp](https://docs.dapta.ai/dapta-docs-es/agentes-de-texto/canales/conecta-tu-agente-con-whatsapp.md) en el mismo espacio de trabajo y asegúrate de tener permisos para editar y enviar.

¿Es tu primera plantilla? Empieza por los tipos y vuelve aquí para construirla.

{% content-ref url="/pages/i5LUY4IOhshW2gR85abZ" %}
[Qué tipo de plantilla necesitas](https://docs.dapta.ai/dapta-docs-es/agentes-de-texto/canales/tipos-de-plantilla.md)
{% endcontent-ref %}

## La aprobación pertenece a la cuenta que envía

Una misma plantilla en Dapta puede tener **registros** en más de una cuenta emisora: una cuenta de WhatsApp Business de Meta, o la cuenta detrás de una línea legacy. La aprobación se da por registro, no a la plantilla completa: una plantilla aprobada en una cuenta no queda aprobada automáticamente en otra.

Tres cosas tienen que coincidir para que un envío funcione: la **línea** desde la que envías, la **cuenta** a la que pertenece y un **registro aprobado** de la plantilla para esa cuenta. Que veas una plantilla en la biblioteca no significa que puedas usarla en la línea seleccionada en la Bandeja de entrada o en una Secuencia.

## Crea y envía a aprobación

Meta revisa cada plantilla antes de dejarte usarla. La mayoría de los rechazos se deben a detalles de formato que puedes evitar desde el primer envío. Ve a **Agentes de texto → Plantillas** y haz clic en **Nueva**.

El editor muestra el formulario junto a una vista previa de WhatsApp en vivo, en tres secciones: **Configuración**, **Redacción** y **Líneas de WhatsApp**.

<figure><img src="https://365551146-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMUYDYzjmxpzlYaw0gcaZ%2Fuploads%2Fgit-blob-499071f922c4826dc6dedc2b120e56b8e8249518%2Fplantilla-crear-01-formulario.png?alt=media" alt="Formulario Crear plantilla con nombre, idioma, categoría, tipo, encabezado, cuerpo con variables, pie, botones, la vista previa en un teléfono y el panel de variables con valores de ejemplo"><figcaption><p>El formulario junto a una vista previa de WhatsApp en vivo.</p></figcaption></figure>

**Paso 1: Ponle un nombre.**

En **Configuración**, escribe el **Nombre de la plantilla** con tus palabras, como quieras encontrarla después, por ejemplo `Confirmación de pedido`. Dapta lo adapta al formato de WhatsApp automáticamente y muestra el resultado en **Se guarda como**. El nombre es interno: tus clientes no lo ven. No se puede cambiar después de crear la plantilla.

***

**Paso 2: Elige el idioma.**

Elige el idioma en que está escrito el mensaje y crea una plantilla por idioma. Si el texto está en español y eliges inglés, Meta la rechaza.

***

**Paso 3: Elige el tipo de plantilla.**

**Estándar** envía un solo mensaje, con título, nota al pie y botones opcionales. **Carrusel** envía de 2 a 10 tarjetas que el cliente desliza, cada una con su imagen o video. Un carrusel debe usar la categoría **Marketing**.

***

**Paso 4: Elige la categoría correcta.**

**Marketing**, **Utilidad** o **Autenticación**, según lo que hace el mensaje, no según lo que cuesta. Una promoción marcada como Utilidad se rechaza o Meta la cambia a Marketing. Si tienes dudas, revisa [Qué tipo de plantilla necesitas](https://docs.dapta.ai/dapta-docs-es/agentes-de-texto/canales/tipos-de-plantilla.md).

***

**Paso 5: Agrega un título, si lo necesitas.**

En **Redacción**, dentro de **Agregar a tu plantilla**, haz clic en **Título**. Se muestra arriba en negrita y puede ser un texto, una imagen, un video o un documento. Un título de texto tiene hasta 60 caracteres y como máximo un campo personalizado, sin negrita ni cursiva.

Para una imagen, un video o un documento, elige el **Origen del archivo**:

* **Subir archivo**: una imagen (jpg, jpeg o png, hasta 5 MB), un video (mp4, hasta 16 MB) o un documento (pdf, hasta 16 MB). El archivo también se guarda en **Archivos de plantilla** para que puedas reutilizarlo.
* **Usar URL pública**: pega un enlace `https://` público al archivo. WhatsApp descarga el archivo desde esa dirección al enviar la plantilla a aprobación, así que debe seguir accesible sin iniciar sesión. Se rechazan los enlaces que empiezan por `http://` y las direcciones sin un dominio real, como `localhost` o una dirección de red privada.

Cambiar de una opción a la otra cancela una carga que siga en curso. El archivo que elijas es el predeterminado de la plantilla: al enviarla, puedes reemplazarlo por otro archivo del mismo servidor.

***

**Paso 6: Escribe el texto.**

En **Texto**, escribe el mensaje principal, de hasta 1.024 caracteres. Selecciona palabras para ponerlas en negrita o cursiva. Para personalizarlo, escribe `/` e inserta un campo personalizado, como el nombre del contacto. Cada campo personalizado se reemplaza por el dato del contacto al enviar. Haz clic en un campo para editarlo.

En un **Carrusel**, arma cada tarjeta en **Tarjetas del carrusel** con **Agregar tarjeta**: su imagen o video (subido o desde una URL pública), su texto y sus botones. Todas las tarjetas usan el mismo tipo de archivo y los mismos botones. Las reglas completas están en [Qué tipo de plantilla necesitas](https://docs.dapta.ai/dapta-docs-es/agentes-de-texto/canales/tipos-de-plantilla.md).

***

**Paso 7: Dale un ejemplo a cada campo personalizado.**

Haz clic en **Campos personalizados**, arriba en **Redacción**, y escribe un **Ejemplo** realista para cada campo, como `María` para el nombre o `Acme` para la empresa. WhatsApp usa los ejemplos para revisar tu plantilla, y la vista previa los muestra. Nunca uses datos de un cliente real. **Importar desde agente** trae los campos que un agente ya usa, para que tus secuencias los llenen con los mismos datos.

***

**Paso 8: Agrega la nota al pie y los botones, si los necesitas.**

En **Agregar a tu plantilla**:

* **Nota al pie**: una línea corta de solo texto, de hasta 60 caracteres, sin campos personalizados. Por ejemplo, `Responde STOP para darte de baja`.
* **Botones**: hasta 3, cada uno de tipo **Respuesta** (respuesta rápida), **Enlace** a tu sitio web o **Número** de teléfono para llamar, con hasta 25 caracteres de texto. Una plantilla puede tener como máximo 2 botones de enlace y 1 de teléfono. Sube o baja los botones para ordenarlos, y mantén juntas las respuestas rápidas, antes o después de los botones de enlace y llamada.

***

**Paso 9: Revisa la vista previa.**

La vista previa de WhatsApp junto al formulario muestra el mensaje como lo verá tu cliente, con los ejemplos en lugar de los campos personalizados. Léelo completo como si fueras él: que se entienda, que los campos tengan sentido en la frase y que no quede ningún espacio vacío.

***

**Paso 10: Elige la línea y envía a aprobación.**

En **Líneas de WhatsApp**, elige las líneas con las que envías la plantilla a revisión. WhatsApp la aprueba por separado para la cuenta de cada línea, y solo las líneas aprobadas pueden enviarla. Si tu espacio de trabajo tiene una sola línea, se elige automáticamente.

Haz clic en **Enviar a aprobación**. Si todavía falta algo, el botón queda bloqueado y **Antes de enviar** lista lo que falta; haz clic en el botón para ir a los campos pendientes. ¿Aún no terminas? **Guardar borrador**, el botón de guardar que está al lado, conserva tu trabajo.

Lee el resultado de cada línea por separado: si unos se aprueban y otros fallan, conserva los que funcionaron y corrige el resto uno por uno.

### Para que Meta la apruebe a la primera

| Haz esto                                                           | Evita esto                                                                                         |
| ------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------- |
| Escribe texto antes de la primera variable y después de la última. | Empezar o terminar el mensaje con una variable, como `{{contact_name}}, hola`.                     |
| Pon texto entre una variable y la siguiente.                       | Dos variables seguidas, como `{{nombre}} {{apellido}}`.                                            |
| Dale un nombre a cada variable: `{{contact_name}}`.                | Dejar una variable vacía, como `{{}}`.                                                             |
| Usa pocas variables y mucho texto fijo.                            | Un mensaje que es casi solo variables: Meta no puede saber qué vas a enviar.                       |
| Un ejemplo realista para cada variable.                            | Dejar ejemplos vacíos, o usar datos de un cliente real.                                            |
| Una categoría que coincida con el contenido.                       | Marcar una oferta como Utilidad para pagar menos.                                                  |
| Un mensaje claro sobre quién escribe y por qué.                    | Mensajes ambiguos, amenazantes o que pidan datos sensibles, como contraseñas o números de tarjeta. |
| Enlaces públicos y de tu propio dominio.                           | Acortadores de enlaces o archivos que piden iniciar sesión.                                        |

{% hint style="info" %}
Si Meta la rechaza, lee el motivo en la plantilla, corrígelo y vuelve a enviarla. La revisión de Meta suele tardar desde unos minutos hasta 24 horas.
{% endhint %}

## Importa lo que ya tienes y mantén los estados al día

* **Importar** (Importar desde Meta), en la barra de la tabla de plantillas, trae al espacio de trabajo las plantillas de tus cuentas de Meta conectadas. El resultado distingue creadas, asociadas, actualizadas y con error: léelo en vez de dar por hecho que llegó todo. Puedes corregir los errores y repetirlo.
* **Sincronizar estado** actualiza los estados de aprobación. Revisa **Última sincronización** y el motivo de rechazo cuando aparezca.
* **Agregar línea**, en la sección **Líneas de WhatsApp** de la plantilla, registra una plantilla existente en otra cuenta elegible. Úsalo cuando esté aprobada en un lado pero falte en la línea que necesitas.

Importar y sincronizar mueven información. Ninguna de las dos concede la aprobación.

En la tabla de plantillas, la columna **Estado** muestra un chip por cuenta emisora: su estado y los últimos seis caracteres del ID de la cuenta. Pasa el cursor sobre los chips o haz clic en ellos para abrir **Estado por cuenta**, con el nombre, el estado y el motivo de rechazo de cada cuenta, y un botón **Copiar ID**. Usa **Filtros** para acotar la tabla por nombre, estado, categoría, idioma, último uso o fecha de creación.

| Estado                          | Qué hacer                                                                                                                                                                                     |
| ------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Borrador**                    | Termínala y envíala a aprobación.                                                                                                                                                             |
| **Pendiente**                   | Espera y sincroniza. No programes nada con ella todavía.                                                                                                                                      |
| **En apelación**                | No se puede enviar hasta que se apruebe la apelación. Espera y sincroniza.                                                                                                                    |
| **Aprobada**                    | Confirma que ese registro corresponde a la línea desde la que vas a enviar.                                                                                                                   |
| **Rechazada**                   | Lee el motivo, corrige el contenido y vuelve a enviarla. Si no se puede editar, usa **Duplicar para Editar**.                                                                                 |
| **Pausada** o **Deshabilitada** | Es una restricción de WhatsApp. Corrige el problema de fondo: copiar la plantilla para enviar igual solo lo empeora. Las Secuencias que usan una plantilla pausada se pausan automáticamente. |
| **Desconocido**                 | WhatsApp ya no confirma esta plantilla, así que no se puede enviar. Vuelve a sincronizar, o duplícala y envía la copia a aprobación.                                                          |

**Duplicar para Editar** crea una plantilla aparte que necesita su propia aprobación. Las Secuencias que apuntaban a la original siguen apuntando a la original. **Duplicar**, en la tabla de plantillas, hace lo mismo y te pide un nombre para la copia.

## Envía una a mano desde la Bandeja de entrada

1. Abre **Agentes de Texto → Bandeja de entrada → Nueva conversación**.
2. En **Enviar desde**, elige la línea de WhatsApp y escribe el número del destinatario en formato internacional.
3. Elige una de las plantillas que se ofrecen para esa línea, completa sus campos personalizados y, si lo necesitas, reemplaza el archivo del encabezado por otro del mismo servidor.
4. Revisa el destinatario, la vista previa y la línea de envío, y pulsa **Enviar** una sola vez.
5. Hasta que la persona conteste, la conversación aparece como **Iniciada por ti, sin respuesta** en la Bandeja de entrada y como **Esperando primera respuesta** en el historial.

Dentro de una conversación existente, **Enviar plantilla** hace lo mismo con la línea de esa conversación. Los controles que aparecen dependen de la línea y del estado de la conversación.

## La ventana de 24 horas

Cada mensaje entrante de un cliente abre — o reinicia — una ventana de 24 horas en la que tu agente puede responder libremente. Fuera de ella, volver a escribirle exige una plantilla aprobada, y enviar esa plantilla no reabre la ventana: solo la reabre la respuesta del cliente.

Es una regla de WhatsApp, distinta del [tiempo de espera de tu agente](https://docs.dapta.ai/dapta-docs-es/agentes-de-texto/comportamiento-de-la-conversacion.md) y del [calendario de una Secuencia](https://docs.dapta.ai/dapta-docs-es/agentes-de-texto/campanas/logica-de-mensajes-y-limites.md). La referencia de Meta es su página de [ventana de atención al cliente](https://developers.facebook.com/documentation/business-messaging/whatsapp/pricing/non-template-messages).

Cuánto cuesta un mensaje dentro o fuera de esa ventana depende de cómo esté conectada tu línea. Mira [Facturación de WhatsApp: líneas legacy y directas](https://docs.dapta.ai/dapta-docs-es/agentes-de-texto/canales/facturacion-de-whatsapp-lineas-legacy-y-directas.md).

## Cuando un envío falla

Los selectores de plantillas solo ofrecen las plantillas que la línea elegida puede enviar, incluidas las que están guardadas en carpetas. Los campos personalizados vacíos se detectan antes de enviar, una secuencia no puede empezar con una plantilla que su línea no puede usar, y los errores de envío nombran la plantilla o el campo personalizado que falló.

| Problema                                                            | Revisa                                                                                                                                                       |
| ------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Aún no hay plantillas aprobadas para esta línea.**                | El espacio de trabajo, a qué cuenta pertenece la línea, el idioma de la plantilla, su estado de aprobación y cuándo se sincronizó por última vez.            |
| Un registro funciona y otro no                                      | El error de la cuenta que falla. No borres el registro que sí funciona.                                                                                      |
| **Esta plantilla ya no está disponible en esta línea. Elige otra.** | La plantilla ya no se puede enviar desde esa línea. Revisa su estado para esa línea y elige otra plantilla o corrige la original.                            |
| Faltan campos personalizados o archivos                             | Completa todos los valores pedidos y respeta el formato del encabezado.                                                                                      |
| La actualización de estado falla                                    | Trata el último estado conocido como no confirmado, revisa tus accesos y reintenta.                                                                          |
| El envío falla, o no sabes si salió                                 | Abre el historial de la conversación antes de reintentar, para no enviarlo dos veces. Para soporte, anota la línea, la plantilla, la hora y el error exacto. |

*Revisión del código fuente: 13 de octubre de 2026. La aprobación y el acceso a la cuenta determinan lo que está disponible.*

{% content-ref url="/pages/Lia8RQnFOFMk4rYGGft5" %}
[Bandeja de entrada](https://docs.dapta.ai/dapta-docs-es/agentes-de-texto/operar-conversaciones.md)
{% endcontent-ref %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.dapta.ai/dapta-docs-es/agentes-de-texto/canales/plantillas-de-mensajes.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
