Un aggiornamento su un ordine richiede un testo fisso e dettagli specifici dell'acquisto. Un template mantiene il testo approvato separato da valori come il numero d'ordine.
Quando serve un template?
Usa un template approvato quando invii al di fuori della finestra di servizio di 24 ore del cliente.
All'interno di una finestra aperta puoi rispondere con contenuto libero. L'invio di un template non riapre quella finestra da solo; è la risposta del cliente a riaprirla.
L'approvazione non sostituisce il consenso del cliente. Segui la policy di messaggistica di Meta per il messaggio che intendi inviare.
Cosa contiene un template in Bird?
Un template identifica il contenuto riutilizzabile, mentre le sue versioni contengono il testo per ciascuna lingua.
Usa slug durante l'invio. Il nome visualizzato è l'etichetta del template, ma non è l'handle usato per risolvere un invio.
Scegli authentication, marketing o utility quando crei il template. Bird mantiene la categoria dichiarata e lo slug fissi dopo la creazione.
Il contenuto di una lingua include un blocco body obbligatorio. Può anche includere un header, footer, buttons o carousel, in base alle regole di contenuto del template.
Per ispezionare il contenuto approvato, leggi live_version_id dal template. Poi recupera la lingua di quella versione tramite il comando lingua.
Un template senza una versione live non può inviare. La sua bozza può ancora contenere contenuto che non ha superato la revisione.
Quale lingua e categoria userà un invio?
Controlla available_languages per le lingue disponibili all'invio. Controlla category della lingua stessa per la classificazione tariffaria di Meta.
status del template riassume le sue lingue. Un template active ha almeno una lingua disponibile all'invio. Un'altra lingua può essere rifiutata, sospesa o disabilitata.
Meta può revocare l'approvazione o la disponibilità di una lingua dopo il lancio. Controlla lo stato della lingua al momento dell'invio anziché mantenere un elenco permanente dal deployment.
Meta può anche riclassificare una lingua senza modificare la categoria che hai dichiarato. Usa la classificazione di quella lingua insieme alle tariffe WhatsApp pubblicate per stimare i costi.
Usa degli esempi per verificare la categoria prima di inviare una lingua:
| Contenuto di esempio | Lezione sulla categoria prevista |
|---|---|
Your order {{reference}} has shipped. | Un aggiornamento specifico su una transazione è il pattern utility |
Your code is {{code}}. | Un messaggio di autenticazione usa la categoria authentication e le sue regole di composizione |
Get 20% off your next order. | Un'offerta promozionale appartiene al percorso marketing |
Mantieni gli esempi illustrativi. Meta esamina la lingua inviata e può classificarla in modo diverso dalla categoria che hai selezionato.
Imposta on_missing_language per decidere cosa succede quando la lingua richiesta non ha una copia disponibile. Bird imposta i nuovi template WhatsApp su fail per impostazione predefinita. Ogni lingua è approvata e tariffata separatamente, quindi una sostituzione silenziosa potrebbe inviare contenuto inatteso a una tariffa non prevista.
Quella policy consente comunque un tag più ampio: pt può soddisfare una richiesta per pt-BR. Non sostituisce la variante correlata pt-PT.
Scegli fallback solo quando sostituire la lingua predefinita configurata è accettabile per i tuoi destinatari. I template gestiti da Bird mantengono la loro policy fissa per lingua mancante.
Come modifico contenuto già inviato?
Crea una nuova bozza. Scrivi la lingua corretta. Invia quella versione per la revisione.
Bird mantiene le versioni inviate immutabili, quindi modificare l'etichetta del template non altera il contenuto approvato del messaggio.
| Campo | Cosa indica |
|---|---|
draft_version_id | Esiste una bozza non inviata |
pending_version_id | Una versione inviata ha ancora lingue non risolte |
live_version_id | Questa versione fornisce il contenuto usato per gli invii |
L'approvazione di una lingua può rendere live l'intera versione. Altre lingue sulla stessa versione possono essere ancora in attesa o rifiutate.
Controlla la lingua della versione inviata per seguire una revisione. Il template può ancora mostrare una versione live precedente mentre una sostituzione è in attesa di approvazione.
Come invio un template?
Specifica il template. Fornisci le variabili richieste dalla lingua che intendi inviare.
Trova i template disponibili con:
bird whatsapp templates listUsa bird whatsapp templates get per ispezionare il template selezionato. Recupera il contenuto della sua lingua prima di assemblare i components dell'invio, che contengono i valori per le variabili di quel template.
Nella dashboard, il dettaglio del template fornisce un esempio cURL con i valori di esempio di quel template. Sostituisci destinatario, credenziali e variabili con i valori che intendi usare prima dell'invio.
Un template creato richiede un mittente sullo stesso WhatsApp Business Account. Segui la procedura di invio. Traccia l'identificatore del messaggio restituito tramite gli eventi di consegna.
Una risposta 202 accetta la richiesta per l'elaborazione. Conferma la consegna dall'esito successivo prima di considerare il messaggio come ricevuto.
In breve
Controlla la lingua prima dell'invio.
Un template attivo può contenere lingue non disponibili. Usa
available_languagesper verificare se la lingua del destinatario può essere inviata.Leggi la categoria della lingua.
Meta può classificare una lingua in modo diverso dalla categoria che hai dichiarato. Il prezzo segue la classificazione di Meta.
Modifica tramite una nuova bozza.
Bird congela le versioni inviate. Crea una nuova bozza per modificare il contenuto. Invia la lingua corretta per la revisione.
Invia il contenuto approvato con le sue variabili.
Specifica il template e fornisci i valori attesi dalla lingua. Una richiesta accettata non garantisce la consegna.