Código promocional

Un código promocional en un cupón: lo que ofrece, el código tan grande como permita el cupón y nunca abreviado, cuánto tiempo es válido, dónde usarlo, la letra pequeña y un botón: 10 segundos. En diez estilos, cada uno con los colores, fuentes, logo, presentador y fondo de su marca.

ID de la plantilla	tpl_ca13747efacd
Sectores	Todos los sectores
Variantes	Corporate glass, Bento grid, Editorial, Swiss grid, Neo-brutalist, Soft friendly, Lock screen, Flashy, Promo flyer, Keynote minimal
Feeds predefinidos	Ninguno

Casos de uso

• Un código de descuento para unas rebajas, un lanzamiento o un boletín, con lo que ofrece.
• Cuánto tiempo es válido y dónde usarlo, con la letra pequeña.
• El código exactamente como lo envía, en el mayor tamaño que admite el cupón.

Variantes

Una variante es esta plantilla con otro diseño, y existe en versiones: compilaciones inmutables, la más reciente primero. Un canal sigue la versión más reciente de su variante, salvo que esté fijado a una.

Variante	Qué es	Versiones	Más reciente
Corporate glass	Tarjetas de cristal esmerilado sobre una aurora en los colores de su marca: tranquilo y premium.	1	1.0.0
Bento grid	Recuadros redondeados en los colores de su marca, cada uno con su propio movimiento: un aspecto moderno de producto.	1	1.0.0
Editorial	Una página de revista con el tono de papel y la tipografía con serifa de su marca: cabecera, líneas finas y firma.	1	1.0.0
Swiss grid	Una cuadrícula estricta, tipografía grande y el color de su marca como único acento. Nada rebota.	1	1.0.0
Neo-brutalist	Bloques planos llamativos en sus colores con bordes gruesos y sombras duras.	1	1.0.0
Soft friendly	Formas suaves y tarjetas redondeadas en matices del color de su marca: cálido y cercano.	1	1.0.0
Lock screen	La pantalla de bloqueo de un teléfono con su fondo de pantalla, con las noticias llegando como notificaciones de su aplicación.	1	1.0.0
Flashy	Cambios de color llamativos entre los colores de su marca, tipografía contundente y explosiones: pensado para noticias de última hora y redes sociales.	1	1.0.0
Promo flyer	Un folleto de tienda en sus colores: estallidos, etiquetas y cifras gruesas, con su logo como protagonista.	1	1.0.0
Keynote minimal	Un escenario de lanzamiento: una cosa cada vez, tipografía enorme y un barrido de luz en su color.	1	1.0.0

Qué acepta

Todas las variantes aceptan el mismo contenido, así que un documento se genera en cualquiera de ellas.

A promo code on a coupon with a dashed edge: what it gives, the code set as large as the coupon allows and never shortened, how long it is valid, where to use it and the small print, with the picture of what it is for and a button that is pressed near the end. metaData is the post's title, descriptions and hashtags and is never drawn.

Campo	Tipo	Obligatorio	Límite	Qué es
clipData	group	yes		Clip data: Everything drawn: a kicker, the title, the code with what it gives, how long it is valid and where to use it, the small print, the button, the picture and the look. The validity is required, because a discount has to say how long it runs.
clipData.kicker	text		up to 20 characters	Kicker: A word or two above the title, such as NEW CUSTOMERS or THIS WEEKEND.
clipData.title	text	yes	up to 80 characters	Title: What the offer is about. Shown from the first frame.
clipData.code	text	yes	up to 20 characters	Code: Drawn exactly as written, every character, as large as the coupon allows and never shortened or broken over two lines, in a face that tells 0 from O and 1 from I and l.
clipData.benefit	text	yes	up to 48 characters	What it gives: The discount or the extra, written as it should be read, above the code. Nothing is worked out from it.
clipData.validUntil	datetime	yes		Valid until: The last moment the code works, always shown on the coupon. The date and time are drawn as they are written here, in the channel's language.
clipData.validLabel	text		up to 24 characters	Before the date: Written before the last moment the code works, such as Valid until. Left out, the date stands alone.
clipData.where	text		up to 60 characters	Where to use it: The shop, the app or the website.
clipData.terms	text		up to 200 characters	Small print: Who may use it, how often, the minimum order and what is left out. Drawn small but always readable.
clipData.button	text		up to 28 characters	Button: The button under the coupon, pressed near the end. Left out, no button is drawn.
clipData.picture	video		media:// picture or video from the media library, alt text up to 120 characters	Picture or video: What the offer is for, beside or above the coupon. Left out, the coupon stands alone and is set larger. A video from the media library plays in its place, without its sound, and from its start again whenever it ends.
clipData.pictureFit	enum		auto, fill, whole	Picture fit: Automatic, the default, fills the frame when a picture is close to its shape and shows it whole when filling would cut off more than a sixth of it, so no picture is cropped away. Fill the frame always crops to the frame, right for photographs; Show it whole never crops, right for logos and cut-out products.
clipData.pictureFocus	enum		centre, top, bottom, left, right	Picture focus: Which part of a picture stays in view when it fills its frame and its edges are cropped: the middle, or one side.
clipData.styleWords	group			Style words: The few words some styles write into their own frame, each drawn exactly as written, in the language you write it in. A word left out is not drawn: no template adds a word of its own. The same keys in every format of the collections; each style draws only its own.
clipData.styleWords.live	text		up to 16 characters	Live marker (Broadcast news): Written beside the light in Broadcast news' channel bug, such as LIVE. Left out, the light stands alone.
clipData.styleWords.byline	text		up to 12 characters	Byline (Editorial): Written before the presenter's name in Editorial, such as By. Left out, the name stands alone.
clipData.styleWords.functionKeys	list		up to 4	Function keys (Data terminal): Data terminal's row of keys F1 to F4, one word each, in order, such as HELP, DATA, CHART and NEWS; the second is drawn held down, and a key that does not fit the row is left out. Left out, no keys are drawn.
clipData.styleWords.functionKeys[]	text		up to 12 characters	Key
clipData.styleWords.commandKey	text		up to 10 characters	Command key (Data terminal): The key at the end of Data terminal's row, in the rise colour, such as GO. Left out, none is drawn.
clipData.styleWords.realTime	text		up to 12 characters	Real-time light (Data terminal): Written beside the blinking light in Data terminal's status bar, such as RT. Left out, the light stands alone.
clipData.styleWords.messageLabel	text		up to 12 characters	Message window label (Data terminal): The tab on Data terminal's message window round the presenter, such as MSG. Left out, the window has no tab.
clipData.styleWords.pictureLabel	text		up to 12 characters	Picture panel label (Data terminal): Written in the strip along the top of Data terminal's picture panels, such as IMG. Left out, the strip stays empty.
clipData.look	group			Look: How the clip looks and moves within its style. The same switches in every format of the collections. Leave a switch out, or set it to the style's own, and the style decides.
clipData.look.theme	enum		auto, brand, light, dark, bold	Theme: The style's own choice; your brand's own colours and background; a light or dark page tinted with your brand colour; or your brand colour as the page.
clipData.look.pace	enum		auto, calm, standard, punchy	Pace: How things arrive: the style's own rhythm, calm fades, a standard rhythm, or punchy slams and cuts.
clipData.look.corners	enum		auto, square, soft, round	Corners: The shape of cards, panels and marks.
clipData.look.align	enum		auto, start, centre	Text alignment: Where the text lines up.
clipData.look.logo	enum		auto, free	Logo: The style's own: the logo on the style's plate (a card, a disc, a badge) so it reads on any page. As it is: the logo whole, with no plate, frame or crop, for a logo made to stand on the page, such as one with a transparent background. As it is, make sure your logo reads on the page of the theme you choose.
clipData.look.logoSize	enum		auto, small, large	Logo size: Standard is the style's own size. Small draws the logo a fifth smaller, with its plate. Large draws it a quarter larger wherever the style has room for it, and at the standard size where it has none.
clipData.look.hideHeader	boolean			Hide logo and title: Leaves out the line at the top of the clip: your logo, the title line and the style's decoration around them, so the content starts at the top. To leave it out of every clip, switch Logo and title line off in your brand's settings.
clipData.look.hideFooter	boolean			Hide footer line: Leaves out your footer line at the foot of the clip, with whatever the style draws only to carry it, so the content reaches further down. Your presenter and the source line stay. To leave it out of every clip, switch Footer line off in your brand's settings.
clipData.look.pattern	enum		auto, none, dots, grid, lines	Background pattern: The fine texture behind the content. The style's own keeps what the style draws there, and some styles draw none. None leaves the background plain. Dots, Grid and Diagonal lines draw that pattern faintly instead, the same in every style, in the colour of your page.
metaData	group			Meta data: Everything about the post that is never drawn in the clip: its title, its description in four lengths, one per kind of platform, and its hashtags. Reelwire adds the brand's description, link and hashtags after it. Left out, the post text is generated from the clip data.
metaData.title	text		up to 100 characters	Title: Used where the platform has a title of its own: Facebook Feed, LinkedIn, Pinterest and YouTube. Up to 100 characters, which every one of them takes.
metaData.captionTiny	text		up to 200 characters	Tiny description (Pinterest, Threads, X): Up to 200 characters. The brand's description, link and hashtags follow it within the platform's limit.
metaData.captionShort	text		up to 500 characters	Short description (Telegram, Threema, WeChat, WhatsApp): Up to 500 characters. The brand's description, link and hashtags follow it within the platform's limit.
metaData.captionMedium	text		up to 1500 characters	Medium description (Discord, Facebook Reels, Instagram, LinkedIn, Signal, Slack, TikTok): Up to 1500 characters. The brand's description, link and hashtags follow it within the platform's limit.
metaData.captionLong	text		up to 4000 characters	Long description (Facebook Feed, YouTube): Up to 4000 characters. The brand's description, link and hashtags follow it within the platform's limit.
metaData.hashtags	list		up to 15	Hashtags: Written without the #. Up to 15, which every platform takes.
metaData.hashtags[]	text		up to 60 characters	Hashtag

locales contiene otros idiomas: bajo cada código de idioma, las partes de clipData y metaData que cambian, superpuestas al contenido predeterminado, así que un idioma sin copia propia también se renderiza.

Una imagen es siempre un archivo de su biblioteca multimedia: media:// seguido de su ID o su nombre. Todo lo que la tabla no enumera se rechaza, y también todo lo que supera su límite, con un error 400 schema_validation que nombra el campo.

Pida a Reelwire, sin iniciar sesión, el JSON Schema completo, el documento con el que se valida su contenido:

curl "https://app.reelwire.io/v1/formats/template/tpl_ca13747efacd?variant=Corporate%20glass&version=1.0.0"

JSON de entrega

Su propio sistema envía esto a uno de sus streams, POST /v1/stream, y cada canal que recibe ese stream lo genera con su plantilla. data es el documento descrito arriba; un stream con una asignación de campos vacía lo pasa a la plantilla sin cambios. Pruébelo primero con POST /v1/stream/validate, que responde igual sin publicar nada. Streams y feeds explica el resto, incluido cómo asignar en su lugar un documento con su propia forma.

{
  "streamId": "st_your_stream_id",
  "eventId": "01M2SQMKK3G1NVFXV31DCBVB95",
  "occurredAt": "2026-09-23T07:00:00Z",
  "locale": "en",
  "data": {
    "clipData": {
      "kicker": "This weekend",
      "title": "New season, new walls: 20% off every roll of the Dunes wallpaper collection",
      "code": "AUTUMN20OFF",
      "benefit": "20% off every roll of Dunes wallpaper",
      "validUntil": "2026-11-01T23:59:00+01:00",
      "validLabel": "Valid until",
      "where": "In every Halden Interiors shop and at halden.example",
      "terms": "Full-price rolls of the Dunes collection only, once per customer. Not valid on paint, tools or samples, and cannot be combined with other codes or offers.",
      "button": "Shop the collection",
      "picture": {
        "alt": "Soft waves of blue, violet and orange, the Dunes pattern",
        "url": "media://example-image.jpg"
      },
      "pictureFit": "auto",
      "pictureFocus": "centre",
      "styleWords": {
        "live": "LIVE",
        "byline": "By",
        "functionKeys": [
          "HELP",
          "DATA",
          "CHART",
          "NEWS"
        ],
        "commandKey": "GO",
        "realTime": "RT",
        "messageLabel": "MSG",
        "pictureLabel": "IMG"
      },
      "look": {
        "theme": "auto",
        "pace": "auto",
        "corners": "auto",
        "align": "auto",
        "logo": "auto",
        "logoSize": "auto",
        "hideHeader": false,
        "hideFooter": false,
        "pattern": "auto"
      }
    },
    "metaData": {
      "title": "20% off every roll of Dunes wallpaper this weekend with the code AUTUMN20OFF",
      "captionTiny": "New season, new walls: the code AUTUMN20OFF takes 20% off every roll of Dunes wallpaper, in our shops and at halden.example, until Sunday 1 November.",
      "captionShort": "New season, new walls. This weekend the code AUTUMN20OFF takes 20% off every full-price roll of the Dunes wallpaper collection: soft waves of colour in four colourways, from sand to midnight blue. Use it at the till in any Halden Interiors shop or at checkout on halden.example until Sunday 1 November at 23:59. Once per customer; not valid on paint, tools or samples, and not combinable with other codes or offers.",
      "captionMedium": "New season, new walls. This weekend the code AUTUMN20OFF takes 20% off every full-price roll of the Dunes wallpaper collection, our new range of soft, layered waves of colour in four colourways, from warm sand to midnight blue. Dunes is a non-woven wallpaper, so it goes up with paste on the wall rather than on the paper, it is washable, and it comes off again in whole strips when you next fancy a change. Order free samples first if you are choosing between colourways, then use the code at checkout on halden.example or show it at the till in any Halden Interiors shop. Our shop teams will work out how many rolls your room needs from its measurements, and every roll in an order is from the same print batch, so the colour matches from one strip to the next. The code works until Sunday 1 November at 23:59, once per customer, on full-price rolls of the Dunes collection only. It is not valid on paint, tools or samples and cannot be combined with other codes or offers. The shop and the code in this clip are illustrative.",
      "captionLong": "New season, new walls. This weekend the code AUTUMN20OFF takes 20% off every full-price roll of the Dunes wallpaper collection, our new range of soft, layered waves of colour in four colourways, from warm sand through dusk violet to midnight blue. Dunes is a non-woven wallpaper: it goes up with paste on the wall rather than on the paper, so there is no soaking and no waiting, the strips can be slid into place before the paste sets, and it comes off again dry and in whole strips when you next fancy a change. It is washable, it does not shrink as it dries, and each roll covers about five square metres. If you are choosing between colourways, order free samples first: they arrive within two working days, and a sample on the wall in your own light tells you more than any photograph. Then use the code at checkout on halden.example, or show it at the till in any Halden Interiors shop, where our teams will work out from your room's measurements how many rolls you need, pattern repeat included. Every roll in one order comes from the same print batch, so the colour matches from one strip to the next, and unopened rolls can be returned within thirty days. The code works until Sunday 1 November at 23:59. It is valid once per customer, on full-price rolls of the Dunes collection only, and not on paint, tools, paste or samples. It cannot be combined with other codes or offers, or with the trade discount. Delivery is free on orders over 60 euros, and every order can be collected from your nearest shop the next working day instead. The shop and the code in this clip are illustrative.",
      "hashtags": [
        "promocode",
        "wallpaper",
        "interiors",
        "homedecor",
        "deal"
      ]
    }
  }
}

La entrega no nombra ninguna versión: qué compilación la genera lo elige el canal, la más reciente de su variante o la que tenga fijada. eventId es un ULID que usted crea una vez por evento: enviar el mismo otra vez no cambia nada. occurredAt es cuándo ocurrió el hecho, no cuándo lo envió. locale es el idioma del texto en data, y data.locales contiene otros idiomas junto a él.