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

# Modelli

> Modelli di messaggio WhatsApp — categorie, approvazione e dove crearli in Switchbord.

WhatsApp richiede che ogni messaggio avviato dall'azienda inviato fuori da una finestra di servizio clienti aperta utilizzi un **modello** pre-approvato. I modelli sono il modo in cui Switchbord invia conferme di prenotazione, offerte di marketing, OTP e qualsiasi altro messaggio in uscita che non sia una risposta diretta a un messaggio in ingresso. Meta esamina e approva (o rifiuta) ogni modello prima che possa essere utilizzato.

Questa pagina è il punto di partenza. Per le regole esatte del validatore, le regole di categoria e l'editor visivo, consulta le pagine di approfondimento collegate in tutto il testo.

## Categorie

Ogni modello appartiene a esattamente una categoria assegnata da Meta, e la categoria determina sia quali contenuti sono ammessi sia quanto Meta fattura per ogni messaggio consegnato:

<CardGroup cols={3}>
  <Card title="Utility" icon="receipt">
    Aggiornamenti transazionali su qualcosa che il cliente ha già richiesto — conferme d'ordine, ricevute, promemoria di appuntamento.
  </Card>

  <Card title="Marketing" icon="bullhorn">
    Contenuti promozionali — offerte, campagne, re-engagement. Massimo livello di controllo e costo più elevato.
  </Card>

  <Card title="Authentication" icon="key">
    Codici usa e getta, OTP e messaggi MFA. Categoria più economica, formato rigidamente limitato.
  </Card>
</CardGroup>

Scegliere la categoria sbagliata non comporta solo il rischio di rifiuto — Meta può ri-categorizzare silenziosamente un modello approvato in un secondo momento, il che cambia quanto ti viene fatturato. Consulta [Modelli di marketing](/it/whatsapp/marketing-templates) per l'albero decisionale, le differenze di fatturazione e come Switchbord mostra gli eventi di migrazione di categoria.

## Dove risiedono i modelli

I modelli sono memorizzati per area di lavoro con uno `status` pari a `draft`, `pending`, `approved` o `rejected`, e sono versionati per lingua — lo stesso nome di modello può avere una variante in italiano e una in inglese, ciascuna esaminata indipendentemente da Meta.

La creazione avviene nel **Template Studio** — un builder visivo a 3 pannelli con un'anteprima pixel-perfect iOS/Android che ti permette di vedere esattamente come verranno visualizzati intestazione, corpo, piè di pagina e pulsanti prima dell'invio. Consulta [Editor visivo dei modelli](/it/whatsapp/visual-builder) per la guida completa all'editor, inclusa la mappatura delle variabili e il caricamento dei contenuti multimediali.

## Variabili e regole di struttura

I modelli usano segnaposto `{{1}}`, `{{2}}`, … nell'intestazione e nel corpo, compilati al momento dell'invio con dati reali del contatto o dell'ordine. Meta applica regole strutturali rigide — i segnaposto non possono trovarsi all'inizio o alla fine del corpo, non possono essere adiacenti tra loro, e ogni segnaposto necessita di un valore di esempio realistico. Il validatore lato client di Switchbord controlla tutto questo prima dell'invio, quindi la maggior parte dei rifiuti viene intercettata nell'editor piuttosto che dalla coda di revisione di Meta.

L'insieme completo delle regole — con esempi DO/DON'T per ogni controllo del validatore — si trova in [Guida di riferimento alle regole dei modelli](/it/whatsapp/template-rules).

## Flusso di approvazione

1. Crea la bozza del modello nel Template Studio.
2. Invialo — Switchbord esegue il validatore lato client, poi trasmette l'invio a Meta.
3. Meta esamina (di solito da pochi minuti a qualche ora) e restituisce `APPROVED` o `REJECTED` con una motivazione.
4. I modelli approvati diventano immediatamente disponibili in Campagne, Journeys e nell'API di invio transazionale.

<Info>
  I modelli approvati possono essere ri-categorizzati da Meta in seguito (ad esempio, un modello `UTILITY` riclassificato successivamente come `MARKETING`). Switchbord registra ogni migrazione nel registro di audit per la riconciliazione della fatturazione — consulta [Migrazione di categoria](/it/whatsapp/marketing-templates#migrazione-di-categoria).
</Info>

## Utilizzo dei modelli

* **Broadcast / [Campagne](/it/features/campaigns)** — associa le variabili del modello ai campi del contatto per un intero pubblico.
* **[Journeys](/it/features/journeys)** — invia un modello come passaggio in un flusso automatizzato.
* **API** — invia un modello approvato in modo programmatico; consulta [Endpoint API dei modelli](/it/api-reference/template-endpoints).
* **Margaret** — chiedi a Margaret di redigere un nuovo modello a partire da una descrizione in linguaggio naturale; lei propone una bozza che rivedi prima della creazione (consulta [Margaret](/it/features/margaret)).

## Vedi anche

* [Guida di riferimento alle regole dei modelli](/it/whatsapp/template-rules) — ogni regola strutturale del validatore con esempi.
* [Modelli di marketing](/it/whatsapp/marketing-templates) — albero decisionale delle categorie, requisiti di opt-out, fatturazione.
* [Editor visivo dei modelli](/it/whatsapp/visual-builder) — l'editor a 3 pannelli e l'anteprima.
* [Il tuo primo modello](/it/getting-started/first-template) — guida end-to-end per una nuova area di lavoro.
