Editor di modello

L'editor di modello decide come viene scritto il messaggio di ogni offerta: quali dati compaiono, in quale ordine, con quale formattazione e quando. Il messaggio si compone con dei blocchi che puoi ordinare, attivare, disattivare e condizionare uno per uno.

10 minuti di lettura

In questa pagina

L'essenziale

  1. Premi un blocco dell'elenco per aprirlo, oppure Aggiungi blocco per crearne uno.
  2. Scrivi il suo Contenuto: il testo, la formattazione con i pulsanti della barra e le variabili, come {{title}} o {{price}}, che si inseriscono anche da Variabile….
  3. Se il blocco deve uscire solo a volte, aggiungi le Condizioni di visualizzazione.
  4. Premi Conferma e guarda il risultato nell'Anteprima.
  5. Premi Salva.

Ogni canale ha il suo modello

Il modello del messaggio appartiene a ogni canale: l'editor lavora sul canale attivo, quello indicato dal selettore del menu laterale. Cambia canale da lì per modificare il modello di un altro. Quando crei un canale puoi copiare il modello di uno che hai già con Copia la configurazione di.

La schermata

  1. Blocchi: i blocchi del messaggio nel loro ordine, con quanti sono («11 nel modello») e il pulsante Aggiungi blocco. Sopra l'elenco compaiono gli avvisi di validazione, se ce ne sono.
  2. Lo spazio tra due blocchi: premilo per cambiarlo.
  3. Modelli predefiniti, importa e esporta.
  4. Anteprima: il messaggio così come apparirà su Telegram, con dati di esempio. Senza nessun blocco attivo dice «Senza contenuto».
  5. Scarta e Salva, spenti finché non cambia qualcosa rispetto a ciò che è salvato.

La prima volta che apri l'Editor di modello, un tour guidato indica i suoi elementi. Puoi saltarlo e rifarlo quando vuoi dal pulsante dell'intestazione, con Ripeti il tour.

Qualsiasi modifica si riflette nell'anteprima senza salvare nulla, con un'offerta di esempio: un iPhone 15 Pro Max di Amazon a 1099,99 con un listino di 1399,99, un'intestazione, una chiusura, una descrizione e due coupon. L'anteprima non ha mai la foto: l'immagine delle offerte la decide il modello di immagine.

Su uno schermo stretto l'anteprima resta in vista sul bordo inferiore: la freccia della sua intestazione (Vedi l'anteprima) scende fino a lei e la freccia (Torna al modulo) ti riporta su.

I blocchi

Il messaggio finale è la somma dei blocchi attivi le cui condizioni sono soddisfatte, nell'ordine dell'elenco.

Premi una riga, fuori dai suoi controlli, per aprire il blocco; con la tastiera, raggiungi la riga con il tabulatore e premi Invio o la barra spaziatrice.

Azione Che cosa fa
Trascina Sposta il blocco in un'altra posizione. Su uno schermo tattile, tieni premuto un istante prima di trascinare.
Sposta su e Sposta giù Lo stesso, di una posizione alla volta. Compaiono solo sul telefono, dove la maniglia non c'è e le frecce sono l'unico modo di riordinare.
Vedi la condizione L'imbuto dice che il blocco esce solo a volte; premendolo si legge la condizione con i nomi dell'editor, per esempio «Solo se Negozio uguale a Amazon e Sconto maggiore di 30».
Altre azioni Un menu con Blocco attivo, Spazio prima, Spazio dopo — tre interruttori che si cambiano senza aprire il blocco —, Duplica ed Elimina.
Trascinare un blocco dalla maniglia per cambiarne l'ordine
  • Aggiungi blocco ne crea uno vuoto in fondo, con lo spazio dopo acceso, e ne apre la finestra, Nuovo blocco, perché tu scriva il contenuto. Se la chiudi senza scrivere nulla, il blocco non resta nell'elenco.
  • Duplica mette la copia subito sotto l'originale, con il nome seguito da «(copia)».
  • Elimina cancella il blocco senza chiedere. Se ti penti, Scarta prima di salvare lo restituisce.
  • Un blocco disattivato appare attenuato, non esce nel messaggio e non viene nemmeno validato: un errore dentro un blocco spento non impedisce di salvare. Almeno un blocco deve restare attivo.
  • Non c'è un limite di blocchi.

Lo spazio tra i blocchi

Il vuoto tra due righe dice che cosa mette il messaggio tra quei due blocchi. Premilo per cambiarlo: passa per tre stati, senza interruzione (i due testi vanno di seguito, sulla stessa riga), a capo (ognuno sulla sua riga) e riga vuota (una riga vuota tra loro). Il vuoto è più alto quanto più separa.

Premere lo spazio tra due blocchi per cambiare ciò che li separa

I blocchi che non escono non separano

Se un blocco è spento o la sua condizione non è soddisfatta, sparisce dal messaggio e lo spazio che resta è quello che c'è tra i blocchi che escono. Un blocco con il testo vuoto non scrive nulla nemmeno lui, ma i suoi a capo contano: il modello di fabbrica ne usa uno così, chiamato «Spazio», per lasciare una riga vuota fissa.

Gli interruttori Prima e Dopo

Ogni blocco ha due interruttori, Prima e Dopo, e ognuno aggiunge un a capo. Premere il vuoto cambia il Dopo del blocco sopra e il Prima di quello sotto. Tra due blocchi non c'è mai più di una riga vuota, e non si scrive nulla prima del primo blocco né dopo l'ultimo.

Modificare un blocco

Premendo una riga si apre la finestra Modifica blocco. Nella sua intestazione c'è l'interruttore Attivo; sotto, tre parti:

  • Nome (facoltativo) e le Interruzioni di riga (Prima e Dopo). Il nome serve solo a te: identifica la riga e apre i suoi avvisi di validazione. Non arriva mai a Telegram.
  • Contenuto: il testo del blocco.
  • Condizioni di visualizzazione.

Si chiude con Conferma, che applica le modifiche all'elenco (ancora senza salvare), oppure con Annulla, la × o Esc. Se avevi toccato qualcosa, prima ti chiede conferma. Premere fuori dalla finestra non la chiude.

Contenuto e formattazione

La casella di testo ammette più righe e i tag di formattazione che Telegram capisce. I pulsanti della barra — grassetto, corsivo, sottolineato, barrato, monospaziato, codice, link, spoiler e citazione — applicano la formattazione al testo selezionato; senza nulla di selezionato, inseriscono i tag nel cursore e lo lasciano in mezzo (Link scrive <a href="">testo</a> e lascia il cursore tra le virgolette, per l'indirizzo).

Il tag di ogni pulsante, e per chi vuole andare oltre la barra
Pulsante Tag
Grassetto <b>…</b>
Corsivo <i>…</i>
Sottolineato <u>…</u>
Barrato <s>…</s>
Monospaziato <code>…</code>
Codice <pre>…</pre>
Link <a href="">…</a>
Spoiler <tg-spoiler>…</tg-spoiler>
Citazione <blockquote>…</blockquote>
  • Non ci sono scorciatoie da tastiera: la formattazione si mette con i pulsanti o scrivendo i tag.
  • Valgono anche i sinonimi di Telegram scritti a mano: <strong>, <em>, <ins>, <strike> e <del>.
  • Una citazione richiudibile si scrive a mano: <blockquote expandable>…</blockquote>. È l'unico attributo che ammette la citazione; in un link vale solo href e in <code> solo class. Qualsiasi altro attributo è un errore.
  • I link possono iniziare solo con http://, https://, mailto: o tg://. E possono avere una variabile dentro: <a href="{{url}}">Vai all'offerta</a> è ciò che fa il blocco «Link» di fabbrica.
  • Un tag che Telegram non ammette (<img>, <div>…) si vede scritto così com'è nell'anteprima e non permette di salvare.

Variabili

Le variabili si scrivono tra doppie parentesi graffe, {{title}}, oppure si inseriscono dal menu a tendina Variabile…, che le elenca con il loro nome in italiano. Quando si compone il messaggio vengono sostituite con i dati dell'offerta:

Variabile Nel menu a tendina Che cosa scrive
{{title}} Titolo Il titolo dell'offerta.
{{price}} Prezzo Il prezzo attuale, con valuta e separatori secondo la regione della tua organizzazione: «1.099,99 €».
{{pvp}} PVP Il prezzo prima dello sconto, formattato allo stesso modo. Vuoto se l'offerta non ce l'ha.
{{discount}} Sconto La percentuale di risparmio, solo il numero («21»): il % lo scrivi tu dopo. Vale 0 quando non c'è listino.
{{url}} URL Il link dell'offerta, già con il tuo tag di affiliazione se ce l'ha.
{{header}} Intestazione L'intestazione scritta in Crea offerta, oppure quella predefinita del canale.
{{footer}} Chiusura La chiusura del messaggio del modulo, oppure quella predefinita del canale.
{{description}} Descrizione La descrizione scritta nel modulo.
{{coupons}} Coupon I coupon, ciascuno in monospaziato per copiarlo con un tocco.
{{image_url}} Immagine L'indirizzo della foto, se l'offerta ce l'ha.
{{store}} Negozio Il nome del negozio secondo il catalogo dei negozi dell'applicazione. Vuoto se il negozio non è nel catalogo, anche se è un negozio tuo delle tue regole di affiliazione.

Il simbolo lo mette la variabile

{{price}} e {{pvp}} scrivono l'importo intero — valuta, separatori e decimali — come lo scrive la regione della tua organizzazione. Non aggiungere il simbolo dopo: uscirebbe due volte. In una condizione restano numeri: price > 20 confronta l'importo, non il testo.

Una variabile vuota o scritta male
  • Una variabile senza valore si scrive come niente e il blocco esce lo stesso. Se non vuoi che esca un blocco a metà, mettigli una condizione (Esiste).
  • Conta solo la forma esatta {{nome}}: con spazi dentro, {{ price }}, resta scritta così com'è.

Condizioni di visualizzazione

Le condizioni guardano i dati di ogni offerta e si organizzano in gruppi: Aggiungi gruppo ne crea uno con una condizione, Aggiungi condizione ne aggiunge un'altra allo stesso gruppo, e Invio nella casella del valore fa lo stesso. Il cestino toglie una condizione o l'intero gruppo; un gruppo che resta senza condizioni sparisce.

Ogni condizione ha tre parti: il campo (una variabile), l'operatore e il valore, che compare solo quando l'operatore ne ha bisogno. Gli operatori dipendono dal tipo di campo:

Operatore Campi numerici (Prezzo, PVP, Sconto) Campi di testo (gli altri)
Esiste / Non esiste Sì Sì
Uguale a / Diverso da Sì Sì
Maggiore di / Minore di Sì —
Contiene — Sì

Tra condizioni e tra gruppi c'è un'etichetta AND oppure OR che cambia premendola:

  • Dentro un gruppo le condizioni vanno con AND all'inizio: il blocco esce se si verificano tutte.
  • Un secondo gruppo si unisce al primo con OR all'inizio: il blocco esce se si verifica uno qualsiasi dei gruppi.
  • Se mescoli le due dentro un gruppo, AND si risolve prima di OR: a AND b OR c è «(a e b) o c».

Esempi

  • Solo su Amazon con più del 30 % di sconto: nello stesso gruppo, Negozio · Uguale a · Amazon AND Sconto · Maggiore di · 30.
  • Se lo sconto supera il 50 % o il prezzo scende sotto 10: le due condizioni e l'etichetta cambiata in OR.
  • Solo quando c'è un ribasso: PVP · Esiste. È ciò che fa il modello di fabbrica per scegliere tra il blocco «Prezzo» e il blocco «Prezzo con listino».
Le trappole che confondono di più
  • Esiste significa «ha un valore e non è vuoto». Il titolo, il prezzo, l'URL e lo sconto esistono sempre; lo sconto vale 0 senza listino, quindi «Sconto · Esiste» è sempre soddisfatta e ciò che vuoi è «Sconto · Maggiore di · 0».
  • I testi si confrontano così come sono, distinguendo le maiuscole: «Contiene amazon» non trova «Amazon».
  • Un valore che ha solo cifre si legge come numero anche se il campo è di testo, quindi «Titolo · Contiene · 2024» non funziona. Usa una parola oppure aggiungi altro al valore.
  • Una condizione a metà non permette di confermare il blocco: un avviso dice «Correggi gli errori nelle condizioni» e, se manca il valore, la sua casella si segna in rosso.

Validazione

L'editor controlla il modello ogni volta che aggiorna l'anteprima. I problemi compaiono sopra l'elenco dei blocchi, con il nome del blocco davanti quando ce l'ha. I più frequenti:

  • Un tag aperto senza chiuderlo, o chiuso in un altro ordine.
  • Un tag che Telegram non ammette, o un attributo non consentito.
  • Un link senza href.
  • Una variabile che non esiste, o un campo o un operatore sconosciuto in una condizione.
  • Nessun blocco attivo.

Gli avvisi in ambra non impediscono di salvare: ti dicono, per esempio, che {{title}} o {{url}} non si usano in nessun blocco attivo, nel caso sia una dimenticanza.

Non si può salvare con errori

Con degli errori, Salva avvisa — «Impossibile salvare: correggi gli errori di validazione» — e ti porta al pannello degli avvisi. Correggili e salva di nuovo.

Salvare, scartare e uscire

  • Salva e Scarta si accendono con qualsiasi modifica, anche di ordine o di uno spazio.
  • Ciò che salvi arriva anche ai messaggi che già aspettano nella coda di quel canale: la coda applica il modello del canale quando li invia; lo racconta Coda di pubblicazione.
  • Scarta chiede prima conferma e riporta il modello a com'era salvato.
  • Se provi a uscire dalla schermata con modifiche in sospeso — dal menu, dal selettore di canale o con la freccia indietro del browser —, ti viene chiesto: Esci senza salvare o Continua a modificare. Se chiudi la scheda o ricarichi, chiede il browser stesso.
Se un'altra persona o un'altra scheda salva nello stesso momento

Qualsiasi persona dell'organizzazione con accesso al canale può modificare e salvare il suo modello. Se qualcuno — o un'altra tua scheda — lo salva dopo che hai aperto la schermata, o se in un'altra scheda hai cambiato canale, quando premi Salva o importi ti avvisa e non si salva niente: ricarica per vedere ciò che è stato salvato e rifai la tua modifica.

Modelli predefiniti

apre il pannello Modelli predefiniti. Ce n'è uno, Predefinito, che è lo stesso con cui nasce ogni canale. Premi Carica e conferma: i suoi blocchi sostituiscono i tuoi nell'elenco.

Caricare non è salvare

Il modello predefinito si applica sullo schermo: puoi guardarlo nell'anteprima e, se non ti convince, premere Scarta per tornare al tuo. Solo quando premi Salva si perde quello precedente. Caricare Predefinito è il modo di tornare al modello di fabbrica.

Il modello di fabbrica, blocco per blocco

Ha undici blocchi: Intestazione ({{header}}, solo se esiste), Titolo, Negozio (#{{store}}, solo se esiste), Spazio (vuoto, con i suoi due a capo), Descrizione (solo se esiste), Prezzo (solo senza listino), Prezzo con listino (prezzo e listino barrato, solo con listino), Sconto ({{discount}}%, solo con listino), Coupon (solo se ce ne sono), Link (<a href="{{url}}">Vai all'offerta</a>) e Chiusura ({{footer}}, solo se esiste).

Esportare e importare

  • Esporta modello scarica il modello salvato come template.json. Ciò che hai non salvato non va nel file: salva prima.
  • Importa modello apre una finestra con la casella JSON del modello: incolla lì il contenuto di un file esportato e premi Importa. Sostituisce tutti i blocchi e, a differenza del resto della schermata, si salva subito: non serve premere Salva dopo. Se ciò che incolli non è un modello, o contiene un errore, la finestra dice perché sopra la casella e non si importa niente.

Serve per fare copie di sicurezza, per portare il modello da un canale a un altro e per condividerlo con un'altra organizzazione.

Salva una copia prima di sperimentare

Esportare prima di caricare un modello predefinito o di rifare il modello ti dà un punto a cui tornare.

Installa Codingram Si apre come un'app, senza passare da uno store