Una conferma d'ordine può riutilizzare la stessa formulazione cambiando il numero d'ordine per ogni destinatario. Questo mantiene il flusso di lavoro coerente mentre i dati cambiano.
Cosa contiene un template?
Un template contiene testo fisso, definizioni delle variabili e la categoria del messaggio, che classifica il motivo dell'invio. Una destinazione può applicare quella classificazione dei contenuti alle proprie regole di registrazione.
Ogni variabile indica un valore che cambia tra un invio e l'altro, come un numero d'ordine. Il template definisce il tipo accettato, se è obbligatoria e qualsiasi vincolo sul suo valore.
I contenuti e modelli delle campagne combinano testo riutilizzabile con valori specifici del destinatario. Il catalogo dei modelli di Bird include modelli di sistema per messaggi di autenticazione e transazionali. I modelli dello spazio di lavoro consentono di pubblicare il proprio testo in più lingue. La creazione avviene tramite l’API di gestione dei modelli.
Leggi le variabili prima di scegliere un template. Un'anteprima dall'aspetto familiare non garantisce che i valori richiesti corrispondano ai dati di cui dispone la tua applicazione.
I template SMS richiedono approvazione?
I modelli integrati sono pronti per l’invio. Pubblicare un modello dello spazio di lavoro ne convalida il testo e le variabili. La versione pubblicata è disponibile subito, senza approvazione di Meta. Le regole della destinazione possono comunque richiedere la registrazione dei contenuti.
Si tratta di processi separati. Il corpo riutilizzabile di un provider non garantisce di per sé la conformità alle regole di una destinazione.
Ad esempio, le linee guida di TRAI per i mittenti richiedono la registrazione dei template di contenuto per le comunicazioni tramite identità mittente registrate in India. Quel requisito riguarda la struttura del messaggio, comprese le parti fisse e variabili.
Verifica la destinazione prima di scegliere il flusso di invio. La registrazione del mittente riguarda l'identità di invio e può coesistere con un requisito sui contenuti.
Come sceglie Bird la categoria e il mittente?
Il modello fornisce la categoria, ossia la classificazione del contenuto in base al motivo dell’invio. I modelli integrati selezionano un mittente per la destinazione; quelli dello spazio di lavoro usano il mittente che fornisci.
Un invio tramite modello rifiuta text, category e media_urls insieme a template. Ometti from per un modello integrato e forniscilo per un modello dello spazio di lavoro. Il contratto di invio tramite modello documenta questi requisiti.
Usa un modello dello spazio di lavoro o testo libero quando l’applicazione deve scegliere un mittente specifico.
Controlla from e category nella risposta. Quei campi indicano quale mittente e quale classificazione dei contenuti Bird ha selezionato per quel messaggio.
Come invio un template in Bird?
Identifica un modello pubblicato e fornisci i valori delle sue variabili nell’oggetto template dell’invio.
Usa slug o id per identificarlo. Consulta GET /v1/sms/templates/{template_ref} per ottenere la sua live_version_id, poi GET /v1/sms/templates/{template_ref}/versions/{version_id} per il contenuto e le definizioni delle variabili.
Inserisci i valori in parameters, indicizzati per nome di variabile. Valori obbligatori mancanti, chiavi non dichiarate o formati non validi restituiscono 422, quindi valida i valori prima di lanciare l'invio.
L'oggetto parametri serializzato deve rientrare in 16 KB. Bird rifiuta una richiesta che supera quel limite, quindi limitati ai valori dichiarati dal template.
Scegli language quando necessario. Le impostazioni di lingua del template determinano la lingua predefinita e l'eventuale fallback, quindi controlla quelle impostazioni invece di dare per scontato che ogni lingua richiesta esista.
I template cambiano la fatturazione di SMS?
Il testo renderizzato viene conteggiato come qualsiasi altro corpo SMS.
Inserisci i valori reali prima di stimare i segmenti. Un riferimento d'ordine lungo o un nome fuori dall'alfabeto compatto può aumentare il conteggio.
Un riferimento a un template non è un prezzo fisso per ogni destinatario. Il campo segments.count nella risposta riporta le parti fatturabili per quel messaggio renderizzato.
Quando conviene scegliere un template?
Scegli un template dal catalogo quando il suo corpo, le variabili e il comportamento di selezione del mittente si adattano al tuo flusso di lavoro.
- Usa un template quando il corpo fornito corrisponde al messaggio e disponi dei valori richiesti.
- Pubblica un modello dello spazio di lavoro per testo riutilizzabile con il tuo mittente, oppure usa testo libero per un singolo messaggio.
- Applica i requisiti di registrazione della destinazione a entrambe le scelte.
In breve
I modelli contengono testo riutilizzabile e definizioni di variabili.
Scegli un modello integrato o usa un modello pubblicato dello spazio di lavoro, quindi fornisci i valori richiesti.
La selezione del mittente dipende dall’ambito del modello.
I modelli integrati usano un mittente selezionato da Bird. I modelli dello spazio di lavoro richiedono un mittente di tua proprietà. Il modello fornisce la categoria.
La pubblicazione nello spazio di lavoro non richiede una verifica di Meta.
La pubblicazione di un modello dello spazio di lavoro convalida la bozza. La versione pubblicata è subito disponibile per l’invio. Le regole di registrazione dei contenuti della destinazione restano separate.
I valori sostituiti influiscono comunque sul conteggio dei segmenti.
Controlla il messaggio renderizzato perché valori più lunghi possono aumentare i segmenti fatturabili.