Descripción general
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
- Crea una plantilla en Email MarketingTemplates o con la API. Dale un nombre y un alias, como
welcome-email. - Diseña el contenido en uno de los tres editores, con marcadores como
{{first_name}}donde van los datos personales. - 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.
- Envíala. Llama a
POST /emailscon"template": "welcome-email"y un objetovariables. Emailit renderiza la versión publicada con 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 | 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, con los valores de variables |
| Automatizaciones | 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 | 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 |
| SMTP relay | No disponible. El SMTP envía el mensaje exactamente como lo has creado. | Ninguno |
Qué puedes hacer
API de plantillas
Gestiona las plantillas desde el código con la API de plantillas:
| Endpoint | Para qué sirve |
|---|---|
| Crear una plantilla | Añade una plantilla o una versión nueva de un alias existente. |
| Obtener una plantilla | Obtiene una versión, con su contenido y la lista de las demás versiones. |
| Actualizar una plantilla | Cambia los campos o el contenido de una versión. |
| Listar plantillas | Lista la versión publicada de cada alias. |
| Publicar una plantilla | Convierte una versión en la versión activa de su alias. |
| Eliminar una plantilla | 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.