DocumentaciónSDK en GitHub

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.

typescript
// 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.

typescript
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.
¿Necesitas ayuda? Escríbenos