Plantillas
Plantillas de correo reutilizables para tus envíos masivos, que gestionas en el panel o con la API.
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. 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:
<p>Hi {{{FIRST_NAME|there}}},</p>
{{{FIRST_NAME}}},{{{LAST_NAME}}}y{{{EMAIL}}}vienen integrados. Cualquier otro nombre lee la propiedad del contacto 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.
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
htmla 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.*.
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 /templatesaceptaname,htmly, opcionalmente,subject,textyalias.GET /templateslista 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 onullborrasubjectotext. Escribirhtmlotextconvierte una plantilla del editor de bloques en una de HTML.DELETE /templates/{id}la elimina.POST /templates/{id}/duplicatehace 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_toyvariablesen una plantilla responden422. 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 /emailsni conPOST /broadcasts. Envía tú mismohtmlotext. El selector de plantillas del editor de envíos masivos copia el contenido.