Documentación Guías
Etiquetas y condiciones
Ofrece texto, enlaces y diseños para cada destinatario. Resuélvelos en tu flujo de envío.
En esta página
Define etiquetas de personalización
Define mergeTags en el panel o el SDK. Cada etiqueta tiene un id estable, un label, el token exacto de tu plataforma y un kind: text o url. sampleValue es opcional y solo se usa en las vistas previas.
// Run on your mounted editor instance.
editor.updateConfig({
mergeTags: [
{ id: 'first_name', label: 'First name', token: '{{first_name}}', kind: 'text', sampleValue: 'Alex' },
{ id: 'account_url', label: 'Account URL', token: '{{account_url}}', kind: 'url', sampleValue: 'https://example.com/account' },
],
});
const output = await editor.exportHTML();
console.log(output.mergeTags, output.mergeTagIssues);
// Exports retain literal tokens. Resolve recipient values before delivery.Define diseños condicionales
Define displayConditions con id, label, before y after. Usa la sintaxis de apertura y cierre de tu plataforma. Los autores aplican una regla con Mostrar si en una sección o un diseño completo de columnas. Deben cumplirse todas las reglas superiores.
Weavour conserva la sintaxis; tu sistema de envío la evalúa. Los escenarios de vista previa usan ejemplos y no cambian las exportaciones habituales. Las condiciones requieren el SDK 0.1.6 o posterior y un editor alojado compatible.
editor.updateConfig({
displayConditions: [{
id: 'free_account', label: 'Free accounts', category: 'Account',
before: "{% if account.plan == 'free' %}", after: '{% endif %}',
}],
});
const output = await editor.exportHTML();
// Evaluate the host syntax before delivering HTML and plain text.
console.log(output.displayConditions, output.displayConditionIssues);
// Persist onDocumentChange envelopes; reopen with emailDocument.Actualiza definiciones y conserva las reglas guardadas
Las definiciones del SDK se combinan por ID con las del panel. [] no añade cambios; undefined elimina los del SDK. Las etiquetas y condiciones guardadas conservan su sintaxis original. Cambiar una definición no reescribe los emails existentes.
Guarda el documento completo de onDocumentChange y ábrelo con emailDocument. Los emails condicionales usan schemaVersion: 2; no elimines ni reduzcas esa versión.
Resuelve la personalización antes de enviar
- Revisa mergeTagIssues y displayConditionIssues de exportHTML(). Comprueba las definiciones modificadas o ausentes.
- Evalúa la sintaxis de condiciones y sustituye los tokens en HTML, texto, asunto y preencabezado con tu sistema de envío.
- También puedes renderizar el JSON con mergeValues y conditionValues booleanos desde tu backend.