Vai al contenuto principale
Le variabili consentono a un unico template approvato di inviare messaggi personalizzati a migliaia di contatti senza un’ulteriore revisione da parte di Meta. Questa pagina spiega come funzionano le variabili in Flowella, come funzionano i valori di esempio e di fallback e come compilare le variabili da HubSpot. Per la struttura di un template, vedere Riferimento ai template. Per creare un template passo dopo passo, vedere Template.

​
Sintassi

I template WhatsApp usano variabili posizionali: doppie parentesi graffe con un numero.
  • Per aggiungere una variabile, fate clic su + Variable nell’editor del corpo, oppure su Variable accanto a Header text. Flowella inserisce per voi il numero successivo.
  • I numeri iniziano da {{1}} e devono essere consecutivi. Non potete passare da {{1}} a {{3}}.
  • Le variabili sono testo. Numeri, date e importi vengono inviati come testo, quindi formattateli prima che arrivino al template.
Meta supporta anche le variabili con nome, come {{first_name}}. Flowella può inviare template con variabili con nome creati in WhatsApp Manager, ma il suo editor crea solo variabili posizionali.

​
Dove possono comparire le variabili

​
Valori di esempio

Quando pubblicate un template, Meta richiede un esempio per ogni variabile. Meta usa gli esempi per:
  1. Verificare che il contenuto corrisponda alla categoria scelta (Marketing, Utility o Authentication).
  2. Valutare la qualità e il rischio di spam.
  3. Mostrare un’anteprima ai revisori.
In Flowella, l’esempio di una variabile è il suo Fallback value. Buoni esempi favoriscono l’approvazione:
  • Usate valori realistici. John va bene; xxx porta spesso al rifiuto.
  • Mantenete brevi gli esempi. Un paragrafo in una singola variabile è un classico segnale di rifiuto.
  • Rispettate il tipo. Se {{2}} è una data, usate una data. Se è un numero d’ordine, usate qualcosa che sembri un numero d’ordine.

​
Valori di fallback

Ogni variabile nell’editor ha un campo Fallback value:
  • Variabili del corpo: nel pannello Body variables dell’editor del corpo.
  • Variabile dell’intestazione di testo: in Header variables nella scheda Variables.
  • Variabile del pulsante URL: sotto l’indirizzo del pulsante.
Il valore di fallback ha tre funzioni:
  1. Viene mostrato nell’anteprima.
  2. Viene inviato a Meta come esempio della variabile quando pubblicate.
  3. Flowella lo invia quando il valore di un contatto manca o è vuoto, una volta confermati i valori di fallback.
Scegliete un valore che suoni naturale per chiunque, come there in Hi there. I valori di fallback non possono contenere interruzioni di riga. Quando pubblicate un template creato in Flowella, i suoi valori di fallback vengono confermati automaticamente.

​
Template con fallback non revisionati

Alcuni template mostrano un badge Fallbacks not reviewed nell’elenco dei template. Nessuno ha ancora confermato i loro valori di fallback, ad esempio perché il template è stato creato in WhatsApp Manager. Flowella precompila i loro valori di fallback con gli esempi del template. Finché non li confermate:
  • L’editor mostra un banner: Review fallback values. These are used when a contact’s data is empty. Until you confirm them, sends with missing data will fail.
  • Qualsiasi invio con un valore vuoto non riesce invece di usare il fallback.
Per trovare questi template, fate clic su Fallbacks not reviewed sopra l’elenco dei template. Per confermare i valori:
1

Aprite il template

Nella pagina Templates, aprite il template nell’editor.
2

Controllate ogni valore di fallback

Leggete ogni Fallback value e modificate quelli che non suonerebbero bene per tutti i contatti.
3

Confermate

Fate clic su Confirm fallback values nel banner. Se avete modificato un valore, fate invece clic su Save Template. In entrambi i casi, nulla viene inviato a Meta e il template non viene esaminato di nuovo.
Dopo aver fatto clic su Confirm fallback values, Flowella mostra Fallback values confirmed e il badge scompare.

​
Cosa succede al momento dell’invio

Questo vale per i workflow HubSpot, gli invii in blocco, l’API, gli invii di test e gli invii dalla Inbox. Flowella non invia mai una variabile vuota a Meta. Quando un invio non riesce a causa di una variabile vuota, l’errore indica la variabile e rimanda al template. Ad esempio: Variable {{2}} is empty and has no fallback value. In un workflow HubSpot, l’azione non riesce per quel contatto e la cronologia del workflow mostra il messaggio. Se la variabile non ha un valore di fallback, l’output Error code dell’azione è VARIABLE_EMPTY_NO_FALLBACK.

​
Mappare le variabili da HubSpot

In un workflow HubSpot, l’azione Send WhatsApp Template ha cinque slot per le variabili: da Template Variable 1 a Template Variable 5. Vedere Azioni di workflow.
1

Scegliete il template

Scegliete il template in Template Name. L’elenco mostra ogni template una sola volta, per nome.
2

Mappate le variabili in ordine

Flowella compila prima una variabile dell’intestazione di testo, poi le variabili del corpo in ordine. Ad esempio, un template ha {{1}} nell’intestazione e {{1}} e {{2}} nel corpo. Mappate Template Variable 1 sul valore dell’intestazione e Template Variable 2 e 3 sui valori del corpo. Le intestazioni immagine, video e documento non usano uno slot.
3

Pianificate i valori vuoti

Se una proprietà mappata è vuota per un contatto, Flowella invia il valore di fallback confermato. Se il template non ha un fallback confermato per quella variabile, l’azione non riesce per quel contatto. Se mappate meno slot di quante siano le variabili del template, Flowella considera vuote quelle mancanti.
4

Testate prima di andare live

Iscrivete prima un contatto di test e controllate il messaggio sul vostro telefono. Poi attivate il workflow per tutti.
Un template può avere più di cinque variabili, ma l’azione può mapparne solo cinque. Per ogni variabile dopo la quinta, Flowella invia il valore di fallback confermato, oppure l’invio non riesce se non ce n’è uno.

​
Date da HubSpot

HubSpot invia le proprietà di data e data-ora come timestamp. Flowella le converte in dd.MM.yyyy HH:mm in UTC, ad esempio 27.06.2026 14:30. Una proprietà di sola data mostra l’orario 00:00. Per mostrare una data nell’ora locale del contatto, o in un altro formato, memorizzate la data formattata in una proprietà di testo di HubSpot e mappate quella proprietà. Flowella invia le proprietà di testo esattamente come sono.

​
Lingua

L’elenco Template Name mostra ogni nome di template una sola volta. Se un template è approvato in più lingue, Flowella sceglie una versione in questo ordine:
  1. La lingua passata con l’azione del workflow, se presente.
  2. Una versione con il codice lingua en. Le versioni in en_US o en_GB non contano qui.
  3. La versione approvata aggiornata più di recente.
Flowella non usa la proprietà della lingua del contatto in HubSpot. Per inviare lingue diverse a contatti diversi, date a ogni versione linguistica un proprio nome di template e create diramazioni nel workflow in base alla lingua.

​
Intestazioni di posizione

Un template con un’intestazione di posizione richiede latitudine e longitudine per ogni invio. Il nome del luogo e l’indirizzo sono facoltativi. In un workflow HubSpot, mappate la posizione sugli slot Template Variable che seguono le variabili del corpo: prima la latitudine, poi la longitudine, poi il nome del luogo. Ad esempio, con due variabili del corpo, mappate la latitudine su Template Variable 3 e la longitudine su Template Variable 4.

​
Suggerimenti per la formattazione delle variabili

Nomi
Rendete prima maiuscola l’iniziale della proprietà in HubSpot, oppure usate un passaggio del workflow HubSpot per copiare firstname in una proprietà “First name (formatted)”. Date WhatsApp non formatta le date. Mappate una proprietà di testo che contenga la data come volete che appaia, ad esempio 24 May 2026. Vedere Date da HubSpot. Valuta Formattate gli importi prima che arrivino al template. Inserite il simbolo della valuta nel testo del template (Total: £{{1}}) in modo che la variabile contenga solo il numero. URL nel testo del corpo Potete inserire un URL completo in una variabile del corpo, ma l’anteprima del link non viene mostrata e l’URL conta ai fini del limite di caratteri del corpo. Usate invece un pulsante URL con una variabile alla fine:
Gli invii dai workflow HubSpot compilano solo le variabili del corpo, dell’intestazione e della posizione. Non possono assegnare a un pulsante URL un valore diverso per ogni contatto, quindi per link che cambiano da contatto a contatto in un workflow HubSpot, inserite invece l’URL completo in una variabile del corpo.

​
Motivi di rifiuto comuni legati alle variabili

  • Numeri saltati ({{1}} poi {{3}}). Numerate le variabili in ordine.
  • Una variabile all’inizio o alla fine del corpo senza testo intorno. Aggiungete una parola prima o dopo.
  • Due variabili una accanto all’altra ({{1}}{{2}}). Separatele almeno con uno spazio o un segno di punteggiatura.
  • Esempi che sembrano segnaposto, come test, xxx o 123, soprattutto nei template Marketing.
  • Variabili nel piè di pagina. I piè di pagina non possono avere variabili.
  • Più di una variabile in un pulsante URL. Ne è consentita una sola, e deve trovarsi alla fine dell’URL.

​
Schemi avanzati

​
Riutilizzare un valore tra componenti

Le variabili dell’intestazione e del corpo sono numerate separatamente, quindi un {{1}} nell’intestazione e un {{1}} nel corpo sono variabili diverse. Se il nome di un cliente compare in entrambi, mappate la stessa proprietà HubSpot su entrambi gli slot: Template Variable 1 per l’intestazione e Template Variable 2 per il corpo.

​
Contenuti condizionali

I template WhatsApp non supportano la logica if/else. Per inviare contenuti diversi a gruppi di contatti diversi, create template separati e create diramazioni nel workflow HubSpot, ad esempio “VIP welcome” e “Standard welcome”.

​
Template multilingue

Ogni versione linguistica di un template viene inviata, approvata e memorizzata separatamente. Mantenete le variabili nelle stesse posizioni in ogni lingua. Per sapere quale versione invia un workflow HubSpot, vedere Lingua.

​
Risoluzione dei problemi

Il valore del contatto era vuoto e il template non ha un valore di fallback per quella variabile. In HubSpot, l’Error code dell’azione è VARIABLE_EMPTY_NO_FALLBACK. Assicuratevi che la proprietà sia compilata per ogni contatto, oppure aggiungete un valore di fallback al template e confermatelo.
Il template ha un valore di fallback, ma nessuno lo ha confermato. Aprite il template e fate clic su Confirm fallback values. Vedere Template con fallback non revisionati.
La proprietà mappata era vuota per quel contatto, oppure il template ha più di cinque variabili. Controllate il record del contatto e la mappatura delle variabili nell’azione del workflow.
No. Flowella non invia mai una variabile vuota o non compilata. Un valore vuoto viene sostituito dal valore di fallback confermato, oppure l’invio non riesce.
Una variabile contiene un URL o un contenuto che non corrisponde alla categoria del template. Non potete aggiungere contenuti di tipo marketing a un template Utility tramite le sue variabili. Per cercare il codice di errore restituito da WhatsApp, vedere Codici di errore WhatsApp in Flowella.
Per l’invio, la modifica e la messa in pausa dei template, vedere Template e Riferimento ai template. Per assistenza specifica sui rifiuti, vedere Template rifiutato.
Ultima modifica il 24 ottobre 2026