Vai al contenuto principale
Le variabili consentono a un singolo modello approvato di inviare messaggi personalizzati a migliaia di contatti senza doverli ripresentare a Meta. Questa pagina è un approfondimento su come funzionano le variabili in Flowella, dove possono comparire e come collegarle ai dati di HubSpot. Per una panoramica di alto livello sulla struttura dei template, vedere Template reference. Per la creazione dei modelli passo dopo passo, vedere Templates.

​
Sintassi

I template WhatsApp utilizzano variabili posizionali con doppie parentesi graffe e un indice a base 1: 
Hi {{1}}, your booking on {{2}} is confirmed. Reference: {{3}}.
Regole:
  • Gli indici iniziano da {{1}} e devono essere sequenziali - non è possibile saltare da {{1}} a {{3}}.
  • Lo stesso indice può essere riutilizzato all’interno di un singolo componente (corpo, intestazione o URL), ma Flowella invierà lo stesso valore a ogni occorrenza.
  • Gli spazi bianchi all’interno delle parentesi graffe non sono ammessi: {{ 1 }} non è valido.
  • Le variabili sono solo testo. Numeri, date e valute sono inviati come stringhe: formattarli a monte in HubSpot prima dell’invio.
Meta sta introducendo variabili con nome ({{first_name}}) per i nuovi modelli. Flowella supporta entrambi, ma gli indici posizionali rimangono il formato più affidabile per tutti i tipi di template e le versioni di Cloud API.

​
Dove possono apparire le variabili

ComponenteVariabili ammesseNote
Header (TEXT)1Solo valori brevi - nessuna interruzione di riga.
Header (media)1 (l’handle del media o l’URL)La variabile è il media stesso, non il testo.
Header (LOCATION)4 (lat, long, nome, indirizzo)Tutti e quattro sono necessari quando l’intestazione è variabile.
CorpoFino a ~10 in praticaOgni variabile conta per il limite di caratteri del corpo di Meta.
FooterNessunoIl footer è solo testo statico.
Tasto URL1Aggiunto alla fine di un URL statico di base.
PulsanteCOPY_CODE1Il valore completo del codice.
Pulsanti risposta rapida, telefono, flusso, catalogoNessunoConfigurazione statica.
Carosello di schedeFino a 3 per corpo della schedaLe variabili di ogni scheda sono numerate in modo indipendente.

​
Valori di esempio

Quando si invia un modello a Meta, ogni variabile ha bisogno di un valore di esempio. Meta utilizza i campioni per:
  1. Decidere se il contenuto del modello corrisponde alla categoria scelta (Marketing, Utilità, Autenticazione).
  2. Stimare la qualità e il rischio di spam.
  3. Visualizzare un’anteprima ai revisori.
I valori dei campioni non vengono utilizzati al momento dell’invio, ma solo per la revisione. Ma sono importanti:
  • Utilizzate valori realistici. {{1}} = "John" va bene; {{1}} = "xxx" spesso causa il rifiuto.
  • Mantenete i campioni brevi. Incollare un paragrafo in una singola variabile è un classico segnale di rifiuto.
  • Assicuratevi che il campione sia adeguato al tipo. Se {{2}} è una data, usate una data. Se è un numero d’ordine, usate qualcosa che assomigli a un numero d’ordine.

​
Cablaggio delle variabili ai dati HubSpot

In un flusso di lavoro HubSpot che utilizza l’azione Invia modello WhatsApp di Flowella:
1

Scegliere il modello

Flowella mostra tutti i modelli approvati per il vostro canale. Le variabili vengono rilevate automaticamente dal corpo del template, dall’intestazione e dai pulsanti.
2

Mappare ogni variabile con un valore HubSpot

Per ogni {{n}}, scegliete una proprietà HubSpot di contatto, azienda, affare o biglietto, oppure digitate un valore statico. È possibile combinare token di personalizzazione e testo letterale nella stessa mappatura.
3

Impostare un fallback per i valori vuoti

Se un contatto non ha un valore per la proprietà mappata, il messaggio fallirà, a meno che non si fornisca una soluzione di ripiego. Ricadute comuni: "there" per il nome, "your account" per il nome del conto.
4

Test prima della messa in funzione

Invia il flusso di lavoro a un singolo contatto di prova. Meta rifiuta gli invii in cui una variabile è vuota, contiene solo spazi bianchi o contiene una nuova linea.
Le variabili vuote vengono rifiutate al momento dell’invio, non all’approvazione del modello. Un flusso di lavoro che viene eseguito su migliaia di contatti può essere interrotto silenziosamente se manca una proprietà critica. Impostate sempre dei fallback.

​
Suggerimenti per la formattazione delle variabili

Nomi 
Hi {{1}},
Scrivere in maiuscolo la proprietà in HubSpot a monte, oppure utilizzare una fase del flusso di lavoro HubSpot per copiare firstname in una proprietà “Nome (formattato)”. Date I modelli WhatsApp non formattano le date. Se la proprietà HubSpot è 2026-05-24T00:00:00Z, è quella che arriva nel messaggio. Utilizzare una proprietà calcolata HubSpot o un’azione del flusso di lavoro per formattare le date come 24 May 2026 prima di mapparle. Valuta Come per le date - formattazione a monte. Includere il simbolo della valuta nel testo statico (Total: £{{1}}) in modo che la variabile sia solo il numero. URL nel testo del corpo È possibile includere l’URL completo all’interno di una variabile del corpo, ma l’anteprima del link non verrà visualizzata e l’URL verrà conteggiato nel limite di caratteri del corpo. Utilizzare invece un pulsante URL con un suffisso variabile: 
Base URL: https://acme.com/orders/
Variable: {{1}}
At send time: https://acme.com/orders/AB-1234

​
Motivi comuni di rifiuto relativi alle variabili

  • Indici saltati ({{1}} poi {{3}}). Rinumerare sempre.
  • Variabile all’inizio o alla fine del corpo senza testo circostante (solo {{1}}). Aggiungere una parola prima o dopo.
  • Due variabili adiacenti ({{1}}{{2}}). Separarle con almeno uno spazio o con la punteggiatura.
  • Valori di esempio che sembrano segnaposto - "test", "xxx", "123" - soprattutto nei modelli di marketing.
  • Variabili nel piè di pagina - non consentite.
  • Più di una variabile in un pulsante URL** - ne è consentita solo una e deve trovarsi alla fine dell’URL.

​
Modelli avanzati

​
Riutilizzo di un valore tra i vari componenti

Se il nome di un cliente compare sia nell’intestazione che nel corpo, definitelo una volta nel flusso di lavoro e mappate sia {{1}} (intestazione) che {{1}} (corpo) sulla stessa proprietà HubSpot. Flowella invia a ciascun componente il proprio elenco di parametri, quindi gli indici sono indipendenti: il valore viene mappato due volte, ma viene memorizzato una sola volta in HubSpot.

​
Contenuto condizionale

I modelli WhatsApp non supportano la logica if/else all’interno del modello. Per inviare contenuti diversi a segmenti di contatti diversi, creare modelli separati e ramificarli nel flusso di lavoro HubSpot, ad esempio “Benvenuto VIP” e “Benvenuto standard”.

​
Modelli multilingue

Il nome e la struttura di un modello sono condivisi tra le varie lingue, ma ogni lingua viene inviata, approvata e archiviata separatamente. Le variabili devono essere nelle stesse posizioni in ogni versione linguistica. Flowella sceglie la lingua giusta in base alla proprietà hs_language del contatto (o a un fallback configurato dall’utente).

​
Risoluzione dei problemi

  • Template approvato ma i messaggi falliscono con “parameter mismatch ” - Meta e Flowella non sono d’accordo sul numero di variabili del template. Recuperare il template in Flowella (Templates → refresh) in modo da sincronizzare il conteggio delle variabili.
  • La variabile mostra il letterale {{1}} nel messaggio consegnato - il flusso di lavoro non ha mappato un valore a quell’indice. Controllare l’elenco dei parametri dell’azione del flusso di lavoro.
  • Il messaggio è stato rifiutato all’invio con “violazione dei criteri ”** - una variabile contiene un URL o un contenuto che non corrisponde alla categoria del modello. Il contenuto di tipo marketing non può essere iniettato in un modello di utilità tramite variabili.
Per il ciclo di vita completo dell’invio, della modifica e della sospensione dei template, vedere Templates e Template reference. Per una guida specifica sul rifiuto, vedere Template rejected.