Prerequisiti
Prima di iniziare:- Un’area di lavoro con un WhatsApp Business Account (WABA) Meta collegato. Consulta Connetti WhatsApp.
- Un access token System User di Meta archiviato nel vault dell’area di lavoro sotto
meta-access-token. Consulta Configurazione delle credenziali Meta. - Ruolo
owneroadminsull’area di lavoro (il pacchetto iniziale è riservato agli admin).
Come accedere all’editor dei modelli
1
Apri 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.
2
Scegli una modalità di avvio
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.
3
Componi
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.
Avvia il pacchetto iniziale GB Viaggi
Il pacchetto iniziale è una libreria curata di 13 modelli di livello produttivo (8UTILITY + 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.
1
Conferma che il WABA sia collegato
Vai su Impostazioni → Canale e verifica che
waba_id sia popolato. In caso contrario, l’avvio fallirà con no_waba.2
Clicca Avvia pacchetto iniziale
Sulla pagina Modelli, clicca Avvia pacchetto iniziale (visibile solo a owner/admin). Un modale riassume cosa verrà inviato e chiede di confermare.
3
Rivedi i risultati per singolo modello
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.POST /api/templates/seed-starter-pack — consulta Endpoint dei modelli 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:
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.
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 inrejection_reason e lo mostra in evidenza in alto nell’editor e sulla riga del modello.
Mappa dei rifiuti comuni → correzione
Flusso di reinvio
1
Duplica il modello rifiutato
L’originale è bloccato. Clicca Duplicate per ottenere una bozza nuova con lo stesso corpo e componenti.
2
Applica la correzione
Il pannello del validatore evidenzia ogni regola violata dalla bozza. Correggile finché il pannello non diventa verde.
3
Valida (opzionale, chiamata no-op)
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.
4
Invia per l'approvazione
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:- Recupera il JSON completo dell’errore Meta dalla riga
rejection_reasondel modello (include l’fbtrace_id). - Apri un issue Linear con tag
whatsapp-templatesindicando il nome del modello, il corpo e l’errore. - 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 — percorso end-to-end.
- Riferimento alle regole dei modelli — ogni regola del validatore.
- Modelli marketing — albero decisionale sulle categorie e opt-out.
- Endpoint dei modelli — automatizza dagli script.