---
title: Plantillas
description: Plantillas de correo reutilizables para tus envíos masivos, que gestionas en el panel o con la API.
seo:
  title: Plantillas de correo
ai:
  exclude: true
---

Una plantilla de correo es contenido de email reutilizable: un asunto, HTML y una parte opcional de texto sin formato. Ten una lista para tu próximo [envío masivo](/docs/es/concepts/broadcasts). En el panel, **Plantillas** te permite crearla con el editor de bloques o escribir el HTML tú mismo.

En el editor de envíos masivos, elegir una plantilla copia su contenido como punto de partida. Editar o eliminar la plantilla más tarde no cambia los envíos masivos que ya hiciste.

## Campos de combinación

Las plantillas pueden llevar valores por contacto:

```html
<p>Hi {{{FIRST_NAME|there}}},</p>
```

- `{{{FIRST_NAME}}}`, `{{{LAST_NAME}}}` y `{{{EMAIL}}}` vienen integrados. Cualquier otro nombre lee la [propiedad del contacto](/docs/es/concepts/contacts) con ese nombre.
- `{{{NAME|fallback}}}` usa el texto alternativo cuando el contacto no tiene valor.
- `{{{UNSUBSCRIBE_URL}}}` se convierte en el enlace de baja propio de cada destinatario. Consulta [Bajas](/docs/es/concepts/unsubscribes).

## Editor de bloques y HTML para plantillas de correo

- Una plantilla creada con el editor de bloques se puede pasar a HTML con **Editar como HTML**. Obtienes una copia o la cambias en el mismo sitio. Hasta que guardes, **Volver a bloques** restaura los bloques.
- Una plantilla creada con `html` a través de la API se abre en modo HTML, y tu HTML se conserva exactamente como lo escribiste. Convertirla a bloques es decisión tuya, como copia o en el mismo sitio, y aplana los diseños basados en tablas.
- En modo HTML, una parte de texto sin formato generada a partir del HTML sigue tus cambios. Una parte de texto sin formato que definas con la API se envía tal como está guardada.

## Publicación y versiones

Por la API, cada guardado queda activo: cada `POST /templates` y `PATCH /templates/{id}` publica una versión nueva, así que `status` siempre vale `published`, y `POST /templates/{id}/publish` no hace nada y responde con éxito. En el panel, el editor guarda una copia de trabajo: tus cambios son un borrador hasta que eliges **Publicar**, que publica una versión nueva. El **Historial de versiones** lista todas las versiones publicadas, y **Restaurar como borrador** recupera una como copia de trabajo.

## API

Los SDK llaman a los endpoints de plantillas como `templates.*`.

```bash
curl -X POST https://api.billionsend.com/templates \
  -H "Authorization: Bearer $BILLIONSEND_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Welcome",
    "subject": "Welcome to Acme",
    "html": "<p>Hi {{{FIRST_NAME|there}}}</p>",
    "alias": "welcome"
  }'
```

- `POST /templates` acepta `name`, `html` y, opcionalmente, `subject`, `text` y `alias`.
- `GET /templates` lista las plantillas, las más recientes primero. `GET /templates/{id}` devuelve el contenido completo.
- `PATCH /templates/{id}` cambia cualquiera de los campos. Una cadena vacía o `null` borra `subject` o `text`. Escribir `html` o `text` convierte una plantilla del editor de bloques en una de HTML.
- `DELETE /templates/{id}` la elimina.
- `POST /templates/{id}/duplicate` hace una copia llamada `<name> (copy)`, sin el alias.

Un `alias` se compone de letras, dígitos, `.`, `_` y `-`, hasta 100 caracteres, y es único en tu equipo. Todas las rutas anteriores aceptan el alias en lugar del id. Un alias ya en uso responde `409`. No se permite un alias que parezca un UUID.

## No compatible

- `from`, `reply_to` y `variables` en una plantilla responden `422`. Define el remitente y el reply-to en el envío masivo, y usa los campos de combinación directamente: las propiedades de los contactos no necesitan declararse.
- No se puede enviar el id de una plantilla con `POST /emails` ni con `POST /broadcasts`. Envía tú mismo `html` o `text`. El selector de plantillas del editor de envíos masivos copia el contenido.
