# Plantillas

> Diseña un email una vez y reutilízalo en envíos por API, automatizaciones y campañas. Alias, versiones, tres editores, variables de Temple y la API de plantillas.

Una plantilla guarda el asunto, los datos del remitente y el contenido de un email para que lo diseñes una vez y lo reutilices. Crea plantillas en el panel con un editor de arrastrar y soltar, de texto enriquecido o HTML, o gestiónalas con la API; después, envíalas por alias y rellena los datos personales en el momento del envío.

## Cómo funciona

1. **Crea una plantilla** en **Email Marketing → Templates** o con la API. Dale un nombre y un alias, como `welcome-email`.
2. **Diseña el contenido** en uno de los tres editores, con marcadores como `{{first_name}}` donde van los datos personales.
3. **Publícala.** La primera plantilla con un alias nuevo se publica automáticamente. Las plantillas que añadas después con el mismo alias se convierten en versiones en borrador que publicas cuando están listas.
4. **Envíala.** Llama a `POST /emails` con `"template": "welcome-email"` y un objeto `variables`. Emailit renderiza la versión publicada con [Temple](/es/docs/templates/temple/) y la envía.

Como tu código hace referencia al alias y no a una plantilla concreta, puedes cambiar el diseño y publicar una versión nueva sin desplegar código.

## Qué contiene una plantilla

| Campo | Detalles |
| --- | --- |
| Nombre | Una etiqueta para tu equipo, de hasta 191 caracteres. |
| Alias | El identificador que usa tu código, de hasta 191 caracteres entre `a–z`, `0–9`, `_` y `-`. Todas las versiones de una plantilla comparten un alias. |
| Editor | **Dragit** (arrastrar y soltar), **Rich Text** o **HTML**. |
| Asunto | La línea de asunto por defecto, de hasta 191 caracteres. Puede contener marcadores. |
| From | El remitente por defecto, como `Acme <hello@acme.com>`. |
| Reply-To | Una o varias direcciones de respuesta opcionales. |
| Contenido | El cuerpo HTML, un cuerpo de texto plano opcional (mediante la API) y, en las plantillas de Dragit, el diseño como JSON de Dragit. |

## Dónde puedes usar las plantillas

| Dónde | Cómo usa la plantilla | Marcadores |
| --- | --- | --- |
| [API de email](/es/docs/email-api/send-email/#send-with-a-template) | `template` admite un alias (la versión publicada) o un ID `tem_` (esa versión exacta). El asunto, el HTML, el texto y la dirección de respuesta salen de la plantilla, salvo que la petición los sobrescriba. El `from` de la petición es siempre obligatorio. | [Temple](/es/docs/templates/temple/), con los valores de `variables` |
| [Automatizaciones](/es/docs/automations/steps/) | El paso **Send email** envía una plantilla. Se usan el From, el asunto y el Reply-To de la plantilla, salvo que el paso los sobrescriba. | Temple, con los datos del contacto y del disparador |
| [Campañas](/es/docs/campaigns/create/) | **Choose from templates** copia el contenido de una plantilla en la campaña como punto de partida. **Save as template** convierte una campaña en una plantilla. | [Etiquetas de combinación de las campañas](/es/docs/campaigns/merge-tags/) |
| [SMTP relay](/es/docs/smtp/) | No disponible. El SMTP envía el mensaje exactamente como lo has creado. | Ninguno |

## Qué puedes hacer

  - [Editores](/es/docs/templates/editors/): Crea plantillas y diséñalas con Dragit, Rich Text o HTML.
  - [Lenguaje Temple](/es/docs/templates/temple/): Variables, valores por defecto y condicionales, y dónde se renderizan.
  - [Versiones](/es/docs/templates/versions/): Prepara un borrador de una versión nueva con el mismo alias y publícalo cuando esté listo.
  - [Importar y exportar](/es/docs/templates/import-export/): Importa JSON de Dragit, HTML o paquetes ZIP, y vuelve a exportarlos.

## API de plantillas

Gestiona las plantillas desde el código con la [API de plantillas](/es/docs/api-reference/templates/):

| Endpoint | Para qué sirve |
| --- | --- |
| [Crear una plantilla](/es/docs/api-reference/templates/create/) | Añade una plantilla o una versión nueva de un alias existente. |
| [Obtener una plantilla](/es/docs/api-reference/templates/get/) | Obtiene una versión, con su contenido y la lista de las demás versiones. |
| [Actualizar una plantilla](/es/docs/api-reference/templates/update/) | Cambia los campos o el contenido de una versión. |
| [Listar plantillas](/es/docs/api-reference/templates/list/) | Lista la versión publicada de cada alias. |
| [Publicar una plantilla](/es/docs/api-reference/templates/publish/) | Convierte una versión en la versión activa de su alias. |
| [Eliminar una plantilla](/es/docs/api-reference/templates/delete/) | Elimina una versión. |

La API necesita una clave **Full Access**. Los cambios emiten los eventos de webhook `template.created`, `template.updated` y `template.deleted`. La importación y la exportación de archivos solo están disponibles en el panel.

## Disponibilidad

Las plantillas están disponibles en todos los planes sin coste adicional. Guardar plantillas no consume créditos; cada email que envías con una de ellas se cobra como cualquier otro envío.

## Primeros pasos

  - [Crear una plantilla](/es/docs/templates/editors/#create-a-template): Define el nombre, el alias y el editor, y después diséñala.
  - [Enviar con una plantilla](/es/docs/email-api/send-email/#send-with-a-template): Envía por alias con variables desde tu código.

---
Fuente: https://emailit.com/es/docs/templates/