> ## 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.
# Configura i messaggi marketing
> Apri l'editor dei modelli, avvia il pacchetto iniziale GB Viaggi, definisci le aspettative di approvazione e risolvi i rifiuti.
Questa guida accompagna un owner o admin dell'area di lavoro attraverso la configurazione end-to-end dei messaggi marketing: apertura dell'editor dei modelli, avvio del pacchetto iniziale GB Viaggi, definizione delle aspettative sulla timeline di revisione di Meta e risoluzione dei rifiuti più comuni.
## Prerequisiti
Prima di iniziare:
* Un'area di lavoro con un WhatsApp Business Account (WABA) Meta collegato. Consulta [Connetti WhatsApp](/it/platform/connect-whatsapp).
* Un access token System User di Meta archiviato nel vault dell'area di lavoro sotto `meta-access-token`. Consulta [Configurazione delle credenziali Meta](/it/operations/meta-credential-setup).
* Ruolo `owner` o `admin` sull'area di lavoro (il pacchetto iniziale è riservato agli admin).
## Come accedere all'editor dei modelli
Dalla barra laterale sinistra, clicca **Modelli**. Vedrai la tua libreria di modelli raggruppata per stato. Le aree di lavoro nuove mostrano una card di stato vuoto con un bottone di avvio rapido.
Tre punti di ingresso:
* **Nuovo modello** — editor vuoto, per bozze singole.
* **Dalla libreria** — clona un modello approvato in un'altra lingua.
* **Avvia pacchetto iniziale** (solo admin) — carica in blocco il pacchetto GB Viaggi con un click.
L'editor ha quattro pannelli: metadati (nome, lingua, categoria), componenti (header, corpo, footer, bottoni), anteprima live che riflette il rendering di WhatsApp, e i risultati della validazione.
Ogni campo ha un'icona informativa che collega alla regola esatta su [Regole dei modelli](/it/whatsapp/template-rules).
## Avvia il pacchetto iniziale GB Viaggi
Il pacchetto iniziale è una libreria curata di 13 modelli di livello produttivo (8 `UTILITY` + 5 `MARKETING`, italiano + inglese) che coprono i flussi più comuni di GB Viaggi: conferma prenotazione, fattura, cancellazione, winback, offerta stagionale, referral, flash sale e altro. L'avvio è idempotente — è sicuro rieseguirlo se un sottoinsieme fallisce a un primo tentativo.
Vai su **Impostazioni → Canale** e verifica che `waba_id` sia popolato. In caso contrario, l'avvio fallirà con `no_waba`.
Sulla pagina **Modelli**, clicca **Avvia pacchetto iniziale** (visibile solo a owner/admin). Un modale riassume cosa verrà inviato e chiede di confermare.
Il seeder invia ogni modello a Meta in sequenza. Ogni riga nella tabella dei risultati riporta `submitted`, `pending_approval`, oppure `error` con il messaggio di Meta. Gli errori vengono archiviati anche nella riga `templates` come `rejection_reason` per un successivo tentativo.
Sotto il cofano, l'interfaccia chiama `POST /api/templates/seed-starter-pack` — consulta [Endpoint dei modelli](/it/api-reference/template-endpoints) se vuoi attivarlo da uno script.
## Aspettative sulla timeline di approvazione
La pipeline di revisione di Meta è quasi sempre rapida, ma "rapida" varia in base alla categoria e al carico:
| Categoria | Tempo di revisione tipico | Casi limite |
| ---------------- | ------------------------- | -------------------- |
| `AUTHENTICATION` | Meno di 5 minuti | Fino a 1 ora |
| `UTILITY` | 5–30 minuti | 1–2 ore sotto carico |
| `MARKETING` | 15 minuti – 2 ore | Fino a 24 ore |
Regole pratiche:
* **I modelli puliti e ben formati vengono approvati in pochi minuti.** Se il tuo è in attesa da più di 2 ore, un revisore lo ha segnalato per una revisione manuale.
* **I weekend e le festività Meta-US rallentano le revisioni.** Invia nei giorni lavorativi se sei in una fase critica per una campagna.
* **Gli invii massivi vengono limitati.** Meta applica un rate limit di 100 modelli/ora per WABA. L'avvio del pacchetto da 13 modelli usa meno del 15% di quel budget.
Non serve fare polling sull'API di Meta. Il worker webhook di Switchbord ascolta `message_template_status_update` e aggiorna la riga del modello in tempo reale. L'interfaccia si aggiorna tramite Supabase Realtime.
## Risoluzione dei rifiuti
Quando un modello viene rifiutato, Switchbord archivia il messaggio leggibile di Meta in `rejection_reason` e lo mostra in evidenza in alto nell'editor e sulla riga del modello.
### Mappa dei rifiuti comuni → correzione
| Messaggio Meta (parafrasato) | Regola | Correzione |
| ------------------------------------------------------------ | ---------------------------------------------------------------------------- | --------------------------------------------------------------- |
| Variable parameters cannot be next to each other | [adjacent-variables](/it/whatsapp/template-rules#adjacent-variables) | Aggiungi una parola tra i placeholder |
| Body text cannot begin with a variable parameter | [leading-variable](/it/whatsapp/template-rules#leading-variable) | Aggiungi un saluto prima di `{{1}}` |
| Body text cannot end with a variable parameter | [trailing-variable](/it/whatsapp/template-rules#trailing-variable) | Aggiungi testo fisso dopo l'ultimo placeholder |
| Number of parameter examples does not match variables | [example-count-mismatch](/it/whatsapp/template-rules#example-count-mismatch) | Fornisci un esempio per ogni `{{n}}` |
| Examples must be representative — numeric/symbol not allowed | [numeric-only-example](/it/whatsapp/template-rules#numeric-only-example) | Usa esempi alfanumerici realistici (includi l'unità nei valori) |
| Template name must contain only lowercase letters… | [name-regex](/it/whatsapp/template-rules#name-regex) | Rinomina in `snake_case` |
| Body text exceeds the 1024 character limit | [length-caps](/it/whatsapp/template-rules#length-caps) | Riduci il corpo a ≤ 1024 caratteri |
| Template cannot have more than 3 quick reply buttons | [button-limits](/it/whatsapp/template-rules#button-limits) | Limita le quick reply a 3 |
### Flusso di reinvio
L'originale è bloccato. Clicca **Duplicate** per ottenere una bozza nuova con lo stesso corpo e componenti.
Il pannello del validatore evidenzia ogni regola violata dalla bozza. Correggile finché il pannello non diventa verde.
Clicca **Validate** per rieseguire solo il linter lato client. Diversamente da **Submit for approval**, questo non consuma uno slot del tuo budget di rate limit su Meta.
Clicca **Submit for approval**. Il webhook aggiorna lo stato del modello in background.
### Quando fare escalation
Se un modello viene rifiutato con un messaggio Meta che non riconosci, o se lo stesso modello viene rifiutato per motivi diversi a ogni tentativo:
1. Recupera il JSON completo dell'errore Meta dalla riga `rejection_reason` del modello (include l'`fbtrace_id`).
2. Apri un issue Linear con tag `whatsapp-templates` indicando il nome del modello, il corpo e l'errore.
3. Se il problema blocca una campagna, apri un caso di Meta Business Support con l'`fbtrace_id` — il tempo di risposta è di solito 24–48 ore.
## Vedi anche
* [Il tuo primo modello](/it/getting-started/first-template) — percorso end-to-end.
* [Riferimento alle regole dei modelli](/it/whatsapp/template-rules) — ogni regola del validatore.
* [Modelli marketing](/it/whatsapp/marketing-templates) — albero decisionale sulle categorie e opt-out.
* [Endpoint dei modelli](/it/api-reference/template-endpoints) — automatizza dagli script.