Saltar al contenido
Esc
↑↓navegar↵abrir⌘Jvista previa
En esta página

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 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.*.

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.

¿Te ha resultado útil esta página?