> ## Documentation Index
> Fetch the complete documentation index at: https://knowledge.flowella.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Variabili dei template e contenuti dinamici

> Come usare le variabili in intestazioni, corpo, pulsanti e URL dei modelli WhatsApp: sintassi, esempi, token HubSpot e trappole comuni di rifiuto Meta.

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](/it/app/template-reference). Per la creazione dei modelli passo dopo passo, vedere [Templates](/it/app/templates).

## Sintassi

I template WhatsApp utilizzano **variabili posizionali** con doppie parentesi graffe e un indice a base 1:

```text theme={null}
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.

<Note>
  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.
</Note>

## Dove possono apparire le variabili

| Componente                                               | Variabili ammesse               | Note                                                               |
| -------------------------------------------------------- | ------------------------------- | ------------------------------------------------------------------ |
| **Header (TEXT)**                                        | 1                               | Solo 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.  |
| **Corpo**                                                | Fino a \~10 in pratica          | Ogni variabile conta per il limite di caratteri del corpo di Meta. |
| **Footer**                                               | Nessuno                         | Il footer è solo testo statico.                                    |
| **Tasto URL**                                            | 1                               | Aggiunto alla fine di un URL statico di base.                      |
| **PulsanteCOPY\_CODE**                                   | 1                               | Il valore completo del codice.                                     |
| **Pulsanti risposta rapida, telefono, flusso, catalogo** | Nessuno                         | Configurazione statica.                                            |
| **Carosello di schede**                                  | Fino a 3 per corpo della scheda | Le 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:

<Steps>
  <Step title="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.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </Step>
</Steps>

<Warning>
  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.
</Warning>

## Suggerimenti per la formattazione delle variabili

**Nomi**

```text theme={null}
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:

```text theme={null}
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.

<Tip>
  Per il ciclo di vita completo dell'invio, della modifica e della sospensione dei template, vedere [Templates](/it/app/templates) e [Template reference](/it/app/template-reference). Per una guida specifica sul rifiuto, vedere [Template rejected](/it/troubleshooting/template-rejected).
</Tip>