Ejemplos del formato de plantillas

Para desarrolladores

Cada ejemplo es una plantilla completa y válida, escrita como vista esencial: solo lleva lo que difiere de los valores por defecto. Son piezas neutras para componer y no diseños terminados. El esqueleto es el punto de partida; los demás muestran un tipo de módulo cada uno.

Son el material con que un asistente de IA compone un diseño: el servidor MCP le entrega cada ejemplo por el nombre que acompaña a su título, y el asistente parte de él, cambia sus valores y lo valida antes de guardarlo. Todos son válidos. Los que muestran un solo módulo no llevan el pie con los enlaces especiales, así que la validación advierte que faltan (missing_special_link): agréguelos, como los lleva el esqueleto, antes de usar el diseño en un correo. La estructura y las reglas del documento están en Formato de plantillas.

La API de plantillas no acepta la vista esencial: con ella se envía el documento completo, como lo devuelve GET /v1/mail-templates/{template_id}. El módulo de ejemplo de cada tipo, ya completo, lo entrega GET /v1/mail-templates/format/modules/{kind}. Ver Plantillas por API.

Esqueleto (skeleton)

{
  "page": {
    "title": "Esqueleto",
    "body": {
      "type": "fidelizador-page-properties",
      "container": {
        "style": {
          "background-color": "#F4F5F7"
        }
      },
      "content": {
        "style": {
          "font-family": "Arial, 'Helvetica Neue', Helvetica, sans-serif",
          "color": "#1F2933"
        },
        "computedStyle": {
          "linkColor": "#0C6CC7",
          "messageBackgroundColor": "#FFFFFF",
          "messageWidth": "600px"
        }
      }
    },
    "rows": [
      {
        "uuid": "d8821e6a-d48b-5af9-8dea-6ae8d5d55b68",
        "type": "one-column-empty",
        "columns": [
          {
            "uuid": "d198ba03-ec45-5365-9ee1-08330e1ea761",
            "grid-columns": 12,
            "modules": [
              {
                "uuid": "ae5863fd-e860-51a7-983d-9e048f600188",
                "type": "heading",
                "descriptor": {
                  "heading": {
                    "text": "Título del correo",
                    "title": "h1",
                    "style": {
                      "color": "#1F2933"
                    }
                  }
                }
              },
              {
                "uuid": "79fd3fb4-c967-5b85-8d93-70a7c78b15b2",
                "type": "paragraph",
                "descriptor": {
                  "paragraph": {
                    "html": "<p>Un párrafo que presenta el contenido.</p>",
                    "style": {
                      "color": "#1F2933"
                    }
                  }
                }
              },
              {
                "uuid": "dc0af782-89e0-5501-9e7f-544d968a6e88",
                "type": "button",
                "descriptor": {
                  "button": {
                    "label": "Ver más",
                    "href": "https://example.com"
                  }
                }
              }
            ]
          }
        ]
      },
      {
        "uuid": "d509b948-a515-51b6-b77c-bb062b6fa63e",
        "type": "one-column-empty",
        "columns": [
          {
            "uuid": "82963943-8e72-5123-b5bb-1b90cfb095bb",
            "grid-columns": 12,
            "modules": [
              {
                "uuid": "9c4e0d79-0a35-56ee-8783-b39ce54d9a76",
                "type": "paragraph",
                "descriptor": {
                  "paragraph": {
                    "html": "<p>Recibes este correo porque te suscribiste. <a href=\"fide:browser-view\">Ver en el navegador</a> · <a href=\"fide:unsubscribe\">Darte de baja</a> · <a href=\"fide:complaint\">Reportar abuso</a></p>",
                    "style": {
                      "color": "#6B7280",
                      "font-size": "12px",
                      "text-align": "center"
                    }
                  }
                }
              }
            ]
          }
        ]
      }
    ]
  }
}

Botón (button)

{
  "page": {
    "title": "Botón",
    "body": {
      "type": "fidelizador-page-properties",
      "container": {
        "style": {
          "background-color": "#F4F5F7"
        }
      },
      "content": {
        "style": {
          "font-family": "Arial, 'Helvetica Neue', Helvetica, sans-serif",
          "color": "#1F2933"
        },
        "computedStyle": {
          "linkColor": "#0C6CC7",
          "messageBackgroundColor": "#FFFFFF",
          "messageWidth": "600px"
        }
      }
    },
    "rows": [
      {
        "uuid": "f08e1754-ca3d-5514-962c-7e1378921f0a",
        "type": "one-column-empty",
        "columns": [
          {
            "uuid": "306d5876-a64d-58b4-8a4a-8fe7696f2e61",
            "grid-columns": 12,
            "modules": [
              {
                "uuid": "2693031c-af59-57c1-b3d7-96fed98dfb6d",
                "type": "button",
                "descriptor": {
                  "button": {
                    "label": "Comprar ahora",
                    "href": "https://example.com"
                  }
                }
              }
            ]
          }
        ]
      }
    ]
  }
}

Cuenta atrás (countdown)

{
  "page": {
    "title": "Cuenta atrás",
    "body": {
      "type": "fidelizador-page-properties",
      "container": {
        "style": {
          "background-color": "#F4F5F7"
        }
      },
      "content": {
        "style": {
          "font-family": "Arial, 'Helvetica Neue', Helvetica, sans-serif",
          "color": "#1F2933"
        },
        "computedStyle": {
          "linkColor": "#0C6CC7",
          "messageBackgroundColor": "#FFFFFF",
          "messageWidth": "600px"
        }
      }
    },
    "rows": [
      {
        "uuid": "f08e1754-ca3d-5514-962c-7e1378921f0a",
        "type": "one-column-empty",
        "columns": [
          {
            "uuid": "306d5876-a64d-58b4-8a4a-8fe7696f2e61",
            "grid-columns": 12,
            "modules": [
              {
                "uuid": "2693031c-af59-57c1-b3d7-96fed98dfb6d",
                "type": "countdown",
                "descriptor": {
                  "countdown": {
                    "until": "2030-01-01T00:00:00Z",
                    "alt": "Faltan pocos días"
                  }
                }
              }
            ]
          }
        ]
      }
    ]
  }
}

Separador (divider)

{
  "page": {
    "title": "Divisor",
    "body": {
      "type": "fidelizador-page-properties",
      "container": {
        "style": {
          "background-color": "#F4F5F7"
        }
      },
      "content": {
        "style": {
          "font-family": "Arial, 'Helvetica Neue', Helvetica, sans-serif",
          "color": "#1F2933"
        },
        "computedStyle": {
          "linkColor": "#0C6CC7",
          "messageBackgroundColor": "#FFFFFF",
          "messageWidth": "600px"
        }
      }
    },
    "rows": [
      {
        "uuid": "f08e1754-ca3d-5514-962c-7e1378921f0a",
        "type": "one-column-empty",
        "columns": [
          {
            "uuid": "306d5876-a64d-58b4-8a4a-8fe7696f2e61",
            "grid-columns": 12,
            "modules": [
              {
                "uuid": "2693031c-af59-57c1-b3d7-96fed98dfb6d",
                "type": "divider",
                "descriptor": {}
              }
            ]
          }
        ]
      }
    ]
  }
}

Título (heading)

{
  "page": {
    "title": "Encabezado",
    "body": {
      "type": "fidelizador-page-properties",
      "container": {
        "style": {
          "background-color": "#F4F5F7"
        }
      },
      "content": {
        "style": {
          "font-family": "Arial, 'Helvetica Neue', Helvetica, sans-serif",
          "color": "#1F2933"
        },
        "computedStyle": {
          "linkColor": "#0C6CC7",
          "messageBackgroundColor": "#FFFFFF",
          "messageWidth": "600px"
        }
      }
    },
    "rows": [
      {
        "uuid": "f08e1754-ca3d-5514-962c-7e1378921f0a",
        "type": "one-column-empty",
        "columns": [
          {
            "uuid": "306d5876-a64d-58b4-8a4a-8fe7696f2e61",
            "grid-columns": 12,
            "modules": [
              {
                "uuid": "2693031c-af59-57c1-b3d7-96fed98dfb6d",
                "type": "heading",
                "descriptor": {
                  "heading": {
                    "text": "Un encabezado",
                    "title": "h2",
                    "style": {
                      "color": "#1F2933"
                    }
                  }
                }
              }
            ]
          }
        ]
      }
    ]
  }
}

HTML (html)

{
  "page": {
    "title": "HTML",
    "body": {
      "type": "fidelizador-page-properties",
      "container": {
        "style": {
          "background-color": "#F4F5F7"
        }
      },
      "content": {
        "style": {
          "font-family": "Arial, 'Helvetica Neue', Helvetica, sans-serif",
          "color": "#1F2933"
        },
        "computedStyle": {
          "linkColor": "#0C6CC7",
          "messageBackgroundColor": "#FFFFFF",
          "messageWidth": "600px"
        }
      }
    },
    "rows": [
      {
        "uuid": "f08e1754-ca3d-5514-962c-7e1378921f0a",
        "type": "one-column-empty",
        "columns": [
          {
            "uuid": "306d5876-a64d-58b4-8a4a-8fe7696f2e61",
            "grid-columns": 12,
            "modules": [
              {
                "uuid": "2693031c-af59-57c1-b3d7-96fed98dfb6d",
                "type": "html",
                "descriptor": {
                  "html": {
                    "html": "<div style=\"text-align:center;color:#1F2933\">Bloque HTML propio</div>"
                  }
                }
              }
            ]
          }
        ]
      }
    ]
  }
}

Íconos (icons)

{
  "page": {
    "title": "Íconos",
    "body": {
      "type": "fidelizador-page-properties",
      "container": {
        "style": {
          "background-color": "#F4F5F7"
        }
      },
      "content": {
        "style": {
          "font-family": "Arial, 'Helvetica Neue', Helvetica, sans-serif",
          "color": "#1F2933"
        },
        "computedStyle": {
          "linkColor": "#0C6CC7",
          "messageBackgroundColor": "#FFFFFF",
          "messageWidth": "600px"
        }
      }
    },
    "rows": [
      {
        "uuid": "f08e1754-ca3d-5514-962c-7e1378921f0a",
        "type": "one-column-empty",
        "columns": [
          {
            "uuid": "306d5876-a64d-58b4-8a4a-8fe7696f2e61",
            "grid-columns": 12,
            "modules": [
              {
                "uuid": "2693031c-af59-57c1-b3d7-96fed98dfb6d",
                "type": "icons",
                "descriptor": {
                  "iconsList": {
                    "icons": [
                      {
                        "image": "/mail-templates/icon-placeholder.png",
                        "href": "https://example.com",
                        "alt": "Envío gratis",
                        "text": "Envío gratis",
                        "textPosition": "bottom",
                        "target": "_blank",
                        "width": "32px",
                        "height": "32px"
                      }
                    ]
                  }
                }
              }
            ]
          }
        ]
      }
    ]
  }
}

Imagen (image)

{
  "page": {
    "title": "Imagen",
    "body": {
      "type": "fidelizador-page-properties",
      "container": {
        "style": {
          "background-color": "#F4F5F7"
        }
      },
      "content": {
        "style": {
          "font-family": "Arial, 'Helvetica Neue', Helvetica, sans-serif",
          "color": "#1F2933"
        },
        "computedStyle": {
          "linkColor": "#0C6CC7",
          "messageBackgroundColor": "#FFFFFF",
          "messageWidth": "600px"
        }
      }
    },
    "rows": [
      {
        "uuid": "f08e1754-ca3d-5514-962c-7e1378921f0a",
        "type": "one-column-empty",
        "columns": [
          {
            "uuid": "306d5876-a64d-58b4-8a4a-8fe7696f2e61",
            "grid-columns": 12,
            "modules": [
              {
                "uuid": "2693031c-af59-57c1-b3d7-96fed98dfb6d",
                "type": "image",
                "descriptor": {
                  "image": {
                    "src": "/mail-templates/logo.png",
                    "alt": "Logo de la marca",
                    "href": "https://example.com"
                  }
                }
              }
            ]
          }
        ]
      }
    ]
  }
}

Lista (list)

{
  "page": {
    "title": "Lista",
    "body": {
      "type": "fidelizador-page-properties",
      "container": {
        "style": {
          "background-color": "#F4F5F7"
        }
      },
      "content": {
        "style": {
          "font-family": "Arial, 'Helvetica Neue', Helvetica, sans-serif",
          "color": "#1F2933"
        },
        "computedStyle": {
          "linkColor": "#0C6CC7",
          "messageBackgroundColor": "#FFFFFF",
          "messageWidth": "600px"
        }
      }
    },
    "rows": [
      {
        "uuid": "f08e1754-ca3d-5514-962c-7e1378921f0a",
        "type": "one-column-empty",
        "columns": [
          {
            "uuid": "306d5876-a64d-58b4-8a4a-8fe7696f2e61",
            "grid-columns": 12,
            "modules": [
              {
                "uuid": "2693031c-af59-57c1-b3d7-96fed98dfb6d",
                "type": "list",
                "descriptor": {
                  "list": {
                    "html": "<ul><li>Primero</li><li>Segundo</li></ul>",
                    "style": {
                      "color": "#1F2933"
                    }
                  }
                }
              }
            ]
          }
        ]
      }
    ]
  }
}

Menú (menu)

{
  "page": {
    "title": "Menú",
    "body": {
      "type": "fidelizador-page-properties",
      "container": {
        "style": {
          "background-color": "#F4F5F7"
        }
      },
      "content": {
        "style": {
          "font-family": "Arial, 'Helvetica Neue', Helvetica, sans-serif",
          "color": "#1F2933"
        },
        "computedStyle": {
          "linkColor": "#0C6CC7",
          "messageBackgroundColor": "#FFFFFF",
          "messageWidth": "600px"
        }
      }
    },
    "rows": [
      {
        "uuid": "f08e1754-ca3d-5514-962c-7e1378921f0a",
        "type": "one-column-empty",
        "columns": [
          {
            "uuid": "306d5876-a64d-58b4-8a4a-8fe7696f2e61",
            "grid-columns": 12,
            "modules": [
              {
                "uuid": "2693031c-af59-57c1-b3d7-96fed98dfb6d",
                "type": "menu",
                "descriptor": {
                  "menuItemsList": {
                    "items": [
                      {
                        "text": "Inicio",
                        "link": {
                          "href": "https://example.com",
                          "target": "_self",
                          "title": ""
                        }
                      },
                      {
                        "text": "Contacto",
                        "link": {
                          "href": "https://example.com/contacto",
                          "target": "_self",
                          "title": ""
                        }
                      }
                    ]
                  }
                }
              }
            ]
          }
        ]
      }
    ]
  }
}

Párrafo (paragraph)

{
  "page": {
    "title": "Párrafo",
    "body": {
      "type": "fidelizador-page-properties",
      "container": {
        "style": {
          "background-color": "#F4F5F7"
        }
      },
      "content": {
        "style": {
          "font-family": "Arial, 'Helvetica Neue', Helvetica, sans-serif",
          "color": "#1F2933"
        },
        "computedStyle": {
          "linkColor": "#0C6CC7",
          "messageBackgroundColor": "#FFFFFF",
          "messageWidth": "600px"
        }
      }
    },
    "rows": [
      {
        "uuid": "f08e1754-ca3d-5514-962c-7e1378921f0a",
        "type": "one-column-empty",
        "columns": [
          {
            "uuid": "306d5876-a64d-58b4-8a4a-8fe7696f2e61",
            "grid-columns": 12,
            "modules": [
              {
                "uuid": "2693031c-af59-57c1-b3d7-96fed98dfb6d",
                "type": "paragraph",
                "descriptor": {
                  "paragraph": {
                    "html": "<p>Texto con un <a href=\"https://example.com\">link</a>.</p>",
                    "style": {
                      "color": "#1F2933"
                    }
                  }
                }
              }
            ]
          }
        ]
      }
    ]
  }
}

Redes sociales (social)

{
  "page": {
    "title": "Redes sociales",
    "body": {
      "type": "fidelizador-page-properties",
      "container": {
        "style": {
          "background-color": "#F4F5F7"
        }
      },
      "content": {
        "style": {
          "font-family": "Arial, 'Helvetica Neue', Helvetica, sans-serif",
          "color": "#1F2933"
        },
        "computedStyle": {
          "linkColor": "#0C6CC7",
          "messageBackgroundColor": "#FFFFFF",
          "messageWidth": "600px"
        }
      }
    },
    "rows": [
      {
        "uuid": "f08e1754-ca3d-5514-962c-7e1378921f0a",
        "type": "one-column-empty",
        "columns": [
          {
            "uuid": "306d5876-a64d-58b4-8a4a-8fe7696f2e61",
            "grid-columns": 12,
            "modules": [
              {
                "uuid": "2693031c-af59-57c1-b3d7-96fed98dfb6d",
                "type": "social",
                "descriptor": {
                  "iconsList": {
                    "icons": [
                      {
                        "name": "facebook",
                        "type": "follow",
                        "text": "",
                        "image": {
                          "src": "/mail-templates/social-icons/circle-color/facebook.png",
                          "alt": "facebook",
                          "title": "facebook",
                          "href": "https://www.facebook.com/",
                          "prefix": "https://www.facebook.com/",
                          "target": "_self"
                        }
                      },
                      {
                        "name": "instagram",
                        "type": "follow",
                        "text": "",
                        "image": {
                          "src": "/mail-templates/social-icons/circle-color/instagram.png",
                          "alt": "instagram",
                          "title": "instagram",
                          "href": "https://www.instagram.com/",
                          "prefix": "https://www.instagram.com/",
                          "target": "_self"
                        }
                      }
                    ]
                  }
                }
              }
            ]
          }
        ]
      }
    ]
  }
}

Espaciador (spacer)

{
  "page": {
    "title": "Espaciador",
    "body": {
      "type": "fidelizador-page-properties",
      "container": {
        "style": {
          "background-color": "#F4F5F7"
        }
      },
      "content": {
        "style": {
          "font-family": "Arial, 'Helvetica Neue', Helvetica, sans-serif",
          "color": "#1F2933"
        },
        "computedStyle": {
          "linkColor": "#0C6CC7",
          "messageBackgroundColor": "#FFFFFF",
          "messageWidth": "600px"
        }
      }
    },
    "rows": [
      {
        "uuid": "f08e1754-ca3d-5514-962c-7e1378921f0a",
        "type": "one-column-empty",
        "columns": [
          {
            "uuid": "306d5876-a64d-58b4-8a4a-8fe7696f2e61",
            "grid-columns": 12,
            "modules": [
              {
                "uuid": "2693031c-af59-57c1-b3d7-96fed98dfb6d",
                "type": "spacer",
                "descriptor": {
                  "spacer": {
                    "style": {
                      "height": "24px"
                    }
                  }
                }
              }
            ]
          }
        ]
      }
    ]
  }
}

Tabla (table)

{
  "page": {
    "title": "Tabla",
    "body": {
      "type": "fidelizador-page-properties",
      "container": {
        "style": {
          "background-color": "#F4F5F7"
        }
      },
      "content": {
        "style": {
          "font-family": "Arial, 'Helvetica Neue', Helvetica, sans-serif",
          "color": "#1F2933"
        },
        "computedStyle": {
          "linkColor": "#0C6CC7",
          "messageBackgroundColor": "#FFFFFF",
          "messageWidth": "600px"
        }
      }
    },
    "rows": [
      {
        "uuid": "f08e1754-ca3d-5514-962c-7e1378921f0a",
        "type": "one-column-empty",
        "columns": [
          {
            "uuid": "306d5876-a64d-58b4-8a4a-8fe7696f2e61",
            "grid-columns": 12,
            "modules": [
              {
                "uuid": "2693031c-af59-57c1-b3d7-96fed98dfb6d",
                "type": "table",
                "descriptor": {
                  "table": {
                    "content": {
                      "headers": [
                        {
                          "cells": [
                            {
                              "html": "Producto"
                            },
                            {
                              "html": "Precio"
                            }
                          ]
                        }
                      ],
                      "rows": [
                        {
                          "cells": [
                            {
                              "html": "Polera"
                            },
                            {
                              "html": "$9.990"
                            }
                          ]
                        }
                      ]
                    }
                  }
                }
              }
            ]
          }
        ]
      }
    ]
  }
}

Dos columnas (two-columns)

{
  "page": {
    "title": "Dos columnas",
    "body": {
      "type": "fidelizador-page-properties",
      "container": {
        "style": {
          "background-color": "#F4F5F7"
        }
      },
      "content": {
        "style": {
          "font-family": "Arial, 'Helvetica Neue', Helvetica, sans-serif",
          "color": "#1F2933"
        },
        "computedStyle": {
          "linkColor": "#0C6CC7",
          "messageBackgroundColor": "#FFFFFF",
          "messageWidth": "600px"
        }
      }
    },
    "rows": [
      {
        "uuid": "f08e1754-ca3d-5514-962c-7e1378921f0a",
        "type": "2-columns",
        "columns": [
          {
            "uuid": "306d5876-a64d-58b4-8a4a-8fe7696f2e61",
            "grid-columns": 6,
            "modules": [
              {
                "uuid": "8d9580f0-b7a5-52b6-99d8-b072f79a6949",
                "type": "image",
                "descriptor": {
                  "image": {
                    "src": "/mail-templates/logo.png",
                    "alt": "Producto"
                  }
                }
              }
            ]
          },
          {
            "uuid": "97599c28-a564-5ac7-8c1b-9f42505ec55d",
            "grid-columns": 6,
            "modules": [
              {
                "uuid": "0f970245-084c-5db4-b659-bbc659beae78",
                "type": "paragraph",
                "descriptor": {
                  "paragraph": {
                    "html": "<p>Descripción del producto.</p>",
                    "style": {
                      "color": "#1F2933"
                    }
                  }
                }
              }
            ]
          }
        ]
      }
    ]
  }
}

Video (video)

{
  "page": {
    "title": "Video",
    "body": {
      "type": "fidelizador-page-properties",
      "container": {
        "style": {
          "background-color": "#F4F5F7"
        }
      },
      "content": {
        "style": {
          "font-family": "Arial, 'Helvetica Neue', Helvetica, sans-serif",
          "color": "#1F2933"
        },
        "computedStyle": {
          "linkColor": "#0C6CC7",
          "messageBackgroundColor": "#FFFFFF",
          "messageWidth": "600px"
        }
      }
    },
    "rows": [
      {
        "uuid": "f08e1754-ca3d-5514-962c-7e1378921f0a",
        "type": "one-column-empty",
        "columns": [
          {
            "uuid": "306d5876-a64d-58b4-8a4a-8fe7696f2e61",
            "grid-columns": 12,
            "modules": [
              {
                "uuid": "2693031c-af59-57c1-b3d7-96fed98dfb6d",
                "type": "video",
                "descriptor": {
                  "video": {
                    "src": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
                    "thumbSrc": "/mail-templates/logo.png"
                  }
                }
              }
            ]
          }
        ]
      }
    ]
  }
}