> ## 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.

# Regole dei template WhatsApp: nomi, variabili e limiti

> Le regole di ogni template WhatsApp: nomi, lingue, variabili numerate e con nome, stati, quanti template potete avere e time-to-live.

Un template WhatsApp è un messaggio che Meta ha approvato in anticipo. I template sono gli unici messaggi che potete inviare a qualcuno al di fuori della [finestra di assistenza clienti di 24 ore](https://knowledge.flowella.io/it/whatsapp/messaging/customer-service-window.md), quindi ogni campagna, promemoria e primo contatto ne usa uno. Ogni template appartiene a un WhatsApp Business Account, ha una sola categoria e una sola lingua, e deve essere **Approved** prima che possiate inviarlo.

> [!NOTE]
>
> **In Flowella.** Supportato. Create i template nell'[editor dei template](https://knowledge.flowella.io/it/app/templates.md), oppure partite dalla libreria di Meta o da uno starter Flowella. Flowella li invia a Meta, mostra lo stato di Meta e spedisce i template approvati dall'Inbox, dall'invio in massa, dai workflow HubSpot e dall'API. Anche i template creati in WhatsApp Manager compaiono in Flowella, perché l'elenco dei template li legge da Meta.

## Di cosa è composto un template

| Parte | Obbligatoria | Limite |
| - | - | - |
| **Intestazione** | No | Testo (60 caratteri, una variabile), immagine, video, documento o posizione |
| **Corpo** | Sì | 1.024 caratteri, con variabili |
| **Piè di pagina** | No | 60 caratteri |
| **Pulsanti** | No | Fino a 10 in totale, con limiti per tipo di pulsante |

Alcuni template di marketing aggiungono parti proprie, come le card di un carosello o il conto alla rovescia di un'offerta. Per i dettagli di ogni parte e i limiti applicati dall'editor di Flowella, consultate il [Riferimento dei template](https://knowledge.flowella.io/it/app/template-reference.md). Per i file multimediali, consultate [Specifiche dei media](https://knowledge.flowella.io/it/whatsapp/messaging/media-specs.md).

## Nomi

* Usate solo lettere minuscole, numeri e trattini bassi, ad esempio `order_shipped_v2`. Meta consente fino a 512 caratteri.
* I nomi non devono essere univoci. Potete dare lo stesso nome a template in lingue diverse: è così che offrite un messaggio in più lingue.
* Lo stesso nome nella **stessa** lingua viene rifiutato. Meta restituisce l'errore 2388024, che Flowella mostra come **Content in This Language Already Exists**. Modificate invece il template esistente, oppure scegliete un nuovo nome.
* Dopo aver eliminato un template approvato, non potete riutilizzarne il nome per 30 giorni. Consultate [Gestione dei template](https://knowledge.flowella.io/it/whatsapp/templates/template-housekeeping.md#delete-a-template).

## Lingue

Ogni template ha un [codice lingua](https://knowledge.flowella.io/it/whatsapp/templates/supported-languages.md), come `en_GB` o `pt_BR`. Meta non traduce nulla: testo e valori di esempio li scrivete voi in quella lingua. Ogni versione linguistica è un template separato, revisionato a sé e conteggiato separatamente ai fini del vostro limite.

## Variabili

Le variabili sono segnaposto che compilate al momento dell'invio, come un nome o un numero d'ordine. Meta supporta due formati:

| Formato | Aspetto | Regole |
| - | - | - |
| **Posizionale** (numerata) | `{{1}}`, `{{2}}` | I numeri partono da 1 e seguono l'ordine. I valori vengono inviati nello stesso ordine. È il formato predefinito di Meta. |
| **Con nome** | `{{first_name}}`, `{{order_number}}` | Lettere minuscole e trattini bassi, ogni nome usato una sola volta. I valori vengono inviati per nome, in qualsiasi ordine. |

Un template usa un solo formato in tutto il testo. Ogni variabile richiede un valore di esempio all'invio a Meta, così il revisore può vedere un messaggio realistico. Un corpo non può iniziare o finire con una variabile, e troppe variabili rispetto alla lunghezza del testo fanno rifiutare il template. Consultate [Revisione dei template](https://knowledge.flowella.io/it/whatsapp/templates/template-review.md#common-rejection-reasons).

> [!NOTE]
>
> **In Flowella.** L'editor crea variabili posizionali e chiede un **Fallback value** per ciascuna, che Meta valuta come esempio. Flowella può anche inviare template che usano variabili con nome, come quelli creati in WhatsApp Manager. Consultate [Variabili dei template](https://knowledge.flowella.io/it/app/template-variables.md).

## Stati

Meta revisiona ogni template nuovo o modificato, di solito in pochi minuti e sempre entro 24 ore. Lo stato poi cambia nel corso della vita del template.

| Stato Meta | Cosa significa | Mostrato in Flowella come |
| - | - | - |
| In revisione (`PENDING`) | Meta lo sta revisionando | **Pending** |
| Approvato (`APPROVED`) | Pronto per l'invio. WhatsApp Manager aggiunge un'etichetta di qualità, come **Active - Quality pending**. | **Approved** |
| Rifiutato (`REJECTED`) | Meta lo ha rifiutato | **Rejected** |
| In pausa (`PAUSED`) | Fermato per il momento, dopo feedback negativi o bassi tassi di lettura | **Paused** |
| Disattivato (`DISABLED`) | Fermato dopo feedback negativi ripetuti | **Disabled** |
| Ricorso richiesto, archiviato, in attesa di eliminazione, eliminato, segnalato, bloccato o oltre il limite | Non inviabile | **Disabled** |

I template salvati in Flowella ma non ancora pubblicati compaiono come **Draft**. Meta non ne sa nulla finché non li pubblicate. Per la messa in pausa, consultate [Pacing e pausa dei template](https://knowledge.flowella.io/it/whatsapp/limits/template-pacing-and-pausing.md). Per le azioni dell'editor legate agli stati, consultate [Stati dei template](https://knowledge.flowella.io/it/app/template-reference.md#template-statuses).

## Quanti template potete avere

| Il vostro portfolio aziendale | Template per WhatsApp Business Account |
| - | - |
| Non verificato | 250 |
| [Verificato](https://knowledge.flowella.io/it/whatsapp/accounts/business-verification.md), con almeno un numero che ha un [nome visualizzato](https://knowledge.flowella.io/it/whatsapp/accounts/display-names.md) approvato | 6.000 |

Ogni versione linguistica conta come un template. Inoltre non potete creare più di 100 template in un WhatsApp Business Account nell'arco di un'ora.

Quando raggiungete il limite, Meta rifiuta i nuovi template con l'errore 2388019. Il messaggio di Flowella per questo errore indica 250, il limite per i portfolio non verificati. Per fare spazio, eliminate i template che non usate più, oppure verificate la vostra azienda per aumentare il limite. Consultate [Gestione dei template](https://knowledge.flowella.io/it/whatsapp/templates/template-housekeeping.md).

## Altri limiti di invio

L'approvazione non significa che ogni invio venga consegnato. Si applicano anche questi limiti:

* [Limiti di messaggistica](https://knowledge.flowella.io/it/whatsapp/limits/messaging-limits.md): con quante persone potete avviare conversazioni in 24 ore.
* [Pacing e pausa dei template](https://knowledge.flowella.io/it/whatsapp/limits/template-pacing-and-pausing.md): Meta trattiene o ferma i template che ricevono feedback negativi.
* [Limite di marketing per utente](https://knowledge.flowella.io/it/whatsapp/limits/per-user-marketing-limit.md): WhatsApp limita quanti template di marketing riceve ogni persona.
* [Archiviazione](https://knowledge.flowella.io/it/whatsapp/templates/template-housekeeping.md#archival): i template non usati per 12 mesi vengono archiviati, poi eliminati.

## Time-to-live

Se WhatsApp non riesce a consegnare un template, ad esempio perché il telefono è spento, continua a provare per un periodo chiamato time-to-live (TTL). Trascorso questo periodo scarta il messaggio e non ricevete alcuno stato di consegna.

| Categoria | Valore predefinito di Meta | Intervallo consentito da Meta |
| - | - | - |
| Authentication | 10 minuti (30 giorni per i template creati prima del 23 ottobre 2024) | Da 30 secondi a 15 minuti |
| Utility | 30 giorni | Da 30 secondi a 12 ore |
| Marketing | 30 giorni | Da 12 ore a 30 giorni, solo tramite la Marketing Messages API |

> [!NOTE]
>
> **In Flowella.** Flowella non ha un'impostazione per il TTL, quindi i vostri template usano i valori predefiniti di Meta. Se Meta cambia la categoria di un template, cancella qualsiasi TTL personalizzato impostato in WhatsApp Manager.

## Ordine di consegna

Quando inviate più messaggi di seguito a una persona, WhatsApp non garantisce che arrivino nell'ordine di invio. Se l'ordine è importante, attendete lo stato **delivered** del primo messaggio prima di inviare il successivo. Consultate [Stati dei messaggi](https://knowledge.flowella.io/it/whatsapp/messaging/message-statuses.md).

## Correlati

> [card] [Categorie dei template](https://knowledge.flowella.io/it/whatsapp/templates/template-categories.md)
>
> Marketing, utility o authentication, e quando Meta la cambia.

> [card] [Revisione dei template](https://knowledge.flowella.io/it/whatsapp/templates/template-review.md)
>
> Perché i template vengono rifiutati e come fare ricorso.

> [card] [Template in Flowella](https://knowledge.flowella.io/it/app/templates.md)
>
> Create, testate e gestite i template.

> [card] [Prezzi di WhatsApp](https://knowledge.flowella.io/it/whatsapp/pricing/whatsapp-pricing.md)
>
> Quanto costa ogni categoria.

Verificato rispetto alla documentazione di Meta il 18 novembre 2026: [Template fundamentals](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/overview), [Template management](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/template-management) e [Time-to-live](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/time-to-live).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.