> ## 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 di marketing

> Approfondimento sui modelli di categoria MARKETING — albero decisionale, fatturazione, opt-out, migrazione di categoria e testi di esempio già validati.

`MARKETING` è la categoria di modelli con il livello di controllo più alto e il costo più elevato. Meta la usa per qualsiasi contenuto promozionale — offerte, campagne, re-engagement, newsletter — e la fattura a un prezzo premium. Ottenere l'approvazione dei modelli di marketing al primo invio richiede di comprendere i confini tra categorie, il requisito di opt-out e il comportamento di migrazione di categoria.

Questa pagina è il complemento pratico alla [Guida di riferimento alle regole dei modelli](/it/whatsapp/template-rules).

## MARKETING vs UTILITY vs AUTHENTICATION

Meta classifica ogni modello in esattamente una di tre categorie. Scegliere quella sbagliata significa un rifiuto, una ri-categorizzazione silenziosa, oppure un costo che non avevi previsto.

### Albero decisionale

```
Il messaggio è un codice usa e getta, un OTP o un MFA?
├── SÌ → AUTHENTICATION
└── NO
    └── Il messaggio è un aggiornamento transazionale su qualcosa che il cliente
        ha già richiesto o acquistato? (ordine, prenotazione, fattura, appuntamento,
        spedizione, cancellazione, conferma di rimborso)
        ├── SÌ → UTILITY
        └── NO → MARKETING
```

### Parole segnale

| Segnale nel corpo                                                           | Categoria probabile |
| --------------------------------------------------------------------------- | ------------------- |
| "confermato", "spedito", "il tuo ordine", "fattura", "ricevuta", "rimborso" | `UTILITY`           |
| "sconto", "% di sconto", "saldi", "tempo limitato", "esclusivo", "promo"    | `MARKETING`         |
| "codice", "OTP", "verifica", "usa e getta"                                  | `AUTHENTICATION`    |

Se un corpo `UTILITY` contiene parole segnale di marketing, Meta lo rifiuterà oppure lo migrerà a `MARKETING`. Scrivere "Il tuo ordine è stato spedito — ed ecco il 20% di sconto sul prossimo!" è un modello `MARKETING`, indipendentemente da come lo etichetti.

## Differenze di fatturazione

Meta è passata a un prezzo per conversazione nel 2024 e i prezzi variano in base al paese del destinatario. In ogni mercato, l'ordine relativo rimane stabile:

* **`AUTHENTICATION`** — la più economica, prezzata per messaggio in alcune regioni.
* **`UTILITY`** — fascia intermedia, tariffa transazionale avviata dall'azienda.
* **`MARKETING`** — premium, tipicamente **da 2 a 5 volte la tariffa UTILITY** a seconda del mercato.
* **Servizio (avviato dall'utente, finestra di 24 ore)** — gratuito nella maggior parte delle regioni.

Consulta la [pagina dei prezzi della piattaforma WhatsApp Business di Meta](https://developers.facebook.com/docs/whatsapp/pricing) per il listino prezzi corrente per mercato. Poiché una migrazione silenziosa di categoria da `UTILITY` a `MARKETING` può moltiplicare il costo di invio, controlla sempre la categoria post-approvazione — non solo lo stato — quando revisioni un modello.

## Requisito del bottone di opt-out

Le normative europee e brasiliane (GDPR, LGPD) richiedono che ogni messaggio di marketing offra un percorso di opt-out chiaro e a basso attrito. Il team di revisione di Meta applica questa regola nella fase di revisione dei contenuti per i modelli destinati a quei mercati e la incoraggia fortemente a livello globale.

Il pattern canonico è una riga nel footer più un bottone `QUICK_REPLY`:

```json theme={null}
{
  "type": "FOOTER",
  "text": "Rispondi STOP per non ricevere più offerte."
}
```

E nell'array dei bottoni:

```json theme={null}
{
  "type": "BUTTONS",
  "buttons": [
    { "type": "QUICK_REPLY", "text": "Scopri" },
    { "type": "QUICK_REPLY", "text": "Non mi interessa" }
  ]
}
```

Il worker webhook di Switchbord riconosce i token di opt-out localizzati (`STOP`, `FERMA`, `PARAR`, `BLOQUEAR`) e contrassegna automaticamente il contatto come `marketing_opt_out = true`. I successivi pubblici delle campagne li escludono di default.

<Warning>
  Un footer di opt-out da solo non basta se l'utente non può agire su di esso. Assicurati che la tua casella di posta abbia un'automazione che gestisca effettivamente la risposta — vedi [Webhook e opt-out](/it/operations/webhooks).
</Warning>

## Migrazione di categoria

Meta può ri-categorizzare un modello durante la revisione. Con `allow_category_change: true` (l'impostazione predefinita di Switchbord per le bozze `MARKETING`), il modello viene spostato in silenzio invece di essere rifiutato.

### Quando accade

* Invii come `UTILITY` ma il contenuto contiene parole segnale di marketing.
* Invii come `MARKETING` ma il contenuto è in realtà un aggiornamento `UTILITY` (meno comune, ma accade).
* Meta riesegue la classificazione su modelli già approvati e li riclassifica a posteriori.

### L'evento webhook

Meta invia `message_template_status_update` sul webhook WABA quando lo stato o la categoria cambiano:

```json theme={null}
{
  "entry": [{
    "changes": [{
      "field": "message_template_status_update",
      "value": {
        "event": "APPROVED",
        "message_template_id": 123456789,
        "message_template_name": "flash_sale",
        "message_template_language": "it",
        "reason": "NONE",
        "previous_category": "UTILITY",
        "new_category": "MARKETING"
      }
    }]
  }]
}
```

Rileva un cambio di categoria confrontando `previous_category` e `new_category`. Nella v22+ Meta emette anche `message_template_category_update` per la riclassificazione post-approvazione di un modello attivo.

Il worker webhook di Switchbord:

1. Memorizza sia la categoria inviata sia la categoria assegnata da Meta nella riga della tabella `templates`.
2. Registra ogni migrazione in `audit_log` per la riconciliazione della fatturazione.
3. Genera un avviso interno quando un modello `UTILITY` viene migrato a `MARKETING` (impatto di costo da 2 a 5 volte).

## Buone pratiche per alti tassi di approvazione

1. **Metti il mittente nella prima riga.** `"Ciao Marco, GB Viaggi ha pensato a te..."` — il revisore di Meta deve identificare immediatamente l'azienda.
2. **Evita emoji impilate e punti esclamativi eccessivi.** Pattern come 🎉🔥💥!!! attivano il classificatore antispam.
3. **Nessun link grezzo nel corpo.** Metti gli URL nei bottoni, dove Meta può analizzarli in modo pulito.
4. **Un'unica idea promozionale per modello.** Un modello che propone una svendita E annuncia nuovi orari E chiede una recensione verrà rifiutato perché troppo vago.
5. **Esempi realistici.** Non usare `"20"` accanto a un `%` — incorpora l'unità di misura nell'esempio (`"20%"`). Vedi [numeric-only-example](/it/whatsapp/template-rules#numeric-only-example).
6. **Opt-out ovunque.** Riga nel footer + risposta rapida, non solo una delle due.
7. **Imposta `allow_category_change: true`.** Meglio un'approvazione migrata che un rifiuto.
8. **Testa prima in italiano, poi traduci.** Il mercato principale di GB Viaggi è l'Italia; i modelli IT approvati si clonano in modo pulito verso EN/DE. La direzione opposta spesso incappa in problemi legati alla fraseologia specifica dell'italiano.

## Modelli di marketing di esempio

Questi sono i testi corretti del ticket BORD-336. Tutti e quattro sono stati approvati al primo reinvio. Usali come punto di partenza e adatta le variabili.

### Winback — cliente inattivo da 30 giorni

```json theme={null}
{
  "name": "winback_30d",
  "language": "it",
  "category": "MARKETING",
  "allow_category_change": true,
  "components": [
    { "type": "HEADER", "format": "TEXT", "text": "Ci manchi" },
    { "type": "BODY",
      "text": "Ciao {{1}}, è passato un po' dall'ultima volta. Abbiamo selezionato {{2}} idee viaggio pensate per te — dai un'occhiata quando vuoi.",
      "example": { "body_text": [["Marco", "tre"]] } },
    { "type": "FOOTER", "text": "Rispondi STOP per non ricevere più offerte." },
    { "type": "BUTTONS", "buttons": [
      { "type": "QUICK_REPLY", "text": "Mostrami" },
      { "type": "QUICK_REPLY", "text": "Più tardi" }
    ] }
  ]
}
```

### Stagionale — campagna estiva

```json theme={null}
{
  "name": "seasonal_campaign",
  "language": "it",
  "category": "MARKETING",
  "allow_category_change": true,
  "components": [
    { "type": "HEADER", "format": "TEXT", "text": "Estate 2025" },
    { "type": "BODY",
      "text": "Ciao {{1}}! Abbiamo pensato a te per {{2}}. Scopri di più rispondendo a questo messaggio.",
      "example": { "body_text": [["Marco", "una vacanza al mare a giugno"]] } },
    { "type": "FOOTER", "text": "GB Viaggi — Rispondi STOP per uscire." },
    { "type": "BUTTONS", "buttons": [
      { "type": "QUICK_REPLY", "text": "Mare" },
      { "type": "QUICK_REPLY", "text": "Montagna" },
      { "type": "QUICK_REPLY", "text": "Città d'arte" }
    ] }
  ]
}
```

### Referral — richiesta di condivisione

```json theme={null}
{
  "name": "referral_ask",
  "language": "it",
  "category": "MARKETING",
  "allow_category_change": true,
  "components": [
    { "type": "BODY",
      "text": "Ciao {{1}}, grazie per aver viaggiato con noi a {{2}}. Se ti è piaciuto, passa il link a chi vuoi — un regalo per entrambi al prossimo viaggio.",
      "example": { "body_text": [["Marco", "Parigi"]] } },
    { "type": "FOOTER", "text": "Rispondi STOP per non ricevere più offerte." },
    { "type": "BUTTONS", "buttons": [
      { "type": "URL", "text": "Condividi",
        "url": "https://gbviaggi.it/refer/{{1}}",
        "example": ["https://gbviaggi.it/refer/abc123"] }
    ] }
  ]
}
```

### Flash sale — offerta a tempo limitato

```json theme={null}
{
  "name": "flash_sale",
  "language": "it",
  "category": "MARKETING",
  "allow_category_change": true,
  "components": [
    { "type": "BODY",
      "text": "48 ore soltanto: sconto del {{1}} su viaggi verso {{2}}. Prenota entro il {{3}}. Codice promo: {{4}}.",
      "example": { "body_text": [["20%", "Parigi", "15 maggio 2025", "FLASH20"]] } },
    { "type": "FOOTER", "text": "GB Viaggi — offerte limitate. Rispondi STOP per uscire." },
    { "type": "BUTTONS", "buttons": [
      { "type": "QUICK_REPLY", "text": "Voglio saperne di più" },
      { "type": "QUICK_REPLY", "text": "Non mi interessa" }
    ] }
  ]
}
```

Nota come `"20%"` sia inserito nell'esempio con il `%` già incorporato — vedi [numeric-only-example](/it/whatsapp/template-rules#numeric-only-example).

## Vedi anche

* [Guida di riferimento alle regole dei modelli](/it/whatsapp/template-rules)
* [Il tuo primo modello](/it/getting-started/first-template)
* [Configurare i messaggi di marketing](/it/getting-started/configure-marketing)
* [Endpoint API dei modelli](/it/api-reference/template-endpoints)