Broadcast

Un broadcast invia una singola email a un intero pubblico: una newsletter, un annuncio o qualsiasi contenuto singolo destinato a molti destinatari contemporaneamente. I membri del pubblico vengono risolti nella lista destinatari al momento dell'invio, quindi il broadcast raggiunge chiunque sia membro del pubblico in quel preciso istante.

Crea i broadcast in Email > Broadcasts nella dashboard, tramite l'API broadcasts, con bird email broadcasts, o tramite il server MCP. Gli SDK TypeScript, Python, Go e PHP espongono una risorsa broadcasts per l'intero ciclo di vita: crearne una bozza, modificarla finché è ancora in bozza, inviarla subito o in un secondo momento, elencare i broadcast dello spazio di lavoro, leggerne uno con i suoi contatori, annullarne uno programmato o in corso di invio, eliminarne uno ancora in bozza, e consultare i suoi destinatari, eventi, link cliccati, il limite di invio da cui un invio attinge, e i conteggi dell'audience rispetto a cui un invio viene risolto. Per una lista di destinatari una tantum, usa l'invio in batch o gli invii singoli.

Parti dalla lista Broadcasts con New broadcast. Il compositore è un'unica pagina: una barra con audience e mittente in alto, il contenuto dell'email sotto e un controllo impostazioni per categoria, tracciamento e tag. Non c'è un passaggio di salvataggio separato. Ogni modifica viene salvata automaticamente non appena il broadcast ha un'audience e un mittente, quindi una bozza esiste dal momento in cui questi due sono impostati, e l'invio successivo è un'azione separata ed esplicita.

Usa il campo To per scegliere un'audience, oppure seleziona New per crearne una senza uscire dal compositore.

Apri il controllo impostazioni nell'intestazione del compositore per altre tre cose:

Un broadcast viene inviato da un indirizzo su un dominio di invio verificato. Abbina una parte locale a uno dei tuoi domini verificati e aggiungi un nome visualizzato se lo desideri. Aggiungi un indirizzo Reply-To se vuoi che le risposte vengano instradate altrove. Selezionando Review ricevi un avviso se il dominio non è verificato.

Un broadcast punta a uno dei template email del tuo spazio di lavoro, e il template contiene l'oggetto e il corpo che il broadcast invia. Le proprietà del contatto di ciascun destinatario compilano le variabili del template al momento dell'invio, quindi un singolo broadcast personalizza il contenuto per ogni destinatario. Un broadcast può compilare solo proprietà del contatto, quindi una variabile del template che fa riferimento a qualcos'altro viene rifiutata al momento dell'invio, e l'errore indica quale variabile.

Scrivi il contenuto direttamente nel canvas sotto la riga dell'oggetto, oppure seleziona Choose a template per partire da uno esistente. Questa opzione è disponibile solo finché il broadcast è vuoto, perché scegliere un template dopo aver scritto un oggetto o un corpo lo sovrascriverrebbe. Un broadcast invia la versione pubblicata del template, quindi un template che ha solo una bozza non può supportare un invio.

Un template con più di una lingua ne invia una sola a tutta l'audience. Indicala come template.language quando crei o aggiorni il broadcast, oppure omettila per inviare la lingua predefinita del template. Cambiare solo la lingua mantiene il broadcast sulla versione a cui è ancorato, una volta che ne ha una. Un broadcast viene ancorato a una versione quando è preparato per l'invio, quindi un broadcast programmato invia la versione pubblicata in quel momento, indipendentemente dal fatto che tu ne cambi la lingua prima.

L'invio è un'azione separata ed esplicita, disponibile dal pulsante Review del composer o dalla pagina di dettaglio del broadcast tramite Send or reschedule. Entrambi aprono un dialogo che verifica che il broadcast sia completo, avvisa di eventuali problemi che potrebbero far fallire l'invio, e ti permette di scegliere Send now o selezionare un orario fino a un anno in avanti. Un broadcast programmato resta modificabile, e puoi riprogrammarlo fino a quando l'invio non è effettivamente iniziato.

L'invio verifica che l'audience abbia ancora qualcuno da raggiungere. Un'audience in cui nessuno ha un indirizzo email, o in cui ogni indirizzo è soppresso, viene rifiutata in quel momento anziché fallire in seguito.

Due limiti a livello di organizzazione vengono verificati al momento dell'invio.

Il primo riguarda quanti broadcast puoi inviare in un periodo di fatturazione. Il tuo piano stabilisce il numero. Le bozze salvate non vengono conteggiate e annullare un broadcast non restituisce la quota. Una volta esaurita, puoi attendere il periodo di fatturazione successivo oppure passare a un piano con un limite più alto.

Il secondo limita i broadcast simultanei. Se selezioni Send now mentre il limite è raggiunto, la richiesta viene rifiutata. Un broadcast programmato attende che si liberi uno slot.

Cerca nella lista per tag o nome del template, oppure filtra per stato, audience o intervallo di date. L'intervallo di date filtra in base a quando ogni broadcast è stato creato, non a quando è stato inviato, quindi un broadcast programmato la settimana scorsa per un invio il mese prossimo compare comunque sotto "Last 7 days."

Esporta la vista corrente come CSV dal pulsante sopra la tabella, oppure chiama Esporta broadcast come CSV, che accetta gli stessi filtri. Oltre 50.000 righe, l'esportazione viene rifiutata anziché troncata silenziosamente. Restringi i filtri e riprova.

Un broadcast si trova sempre in uno dei quattro stadi, e il filtro Status nella lista usa questi quattro:

Il badge di ogni riga mostra lo stato esatto all'interno del suo stadio. Quello stesso valore è ciò che il campo status della API restituisce.

Annulla un broadcast programmato o in corso di invio dalla sua pagina di dettaglio, con bird email broadcasts cancel, oppure con Annulla un broadcast e il metodo broadcasts.cancel SDK. I destinatari non ancora raggiunti vengono saltati, e qualsiasi messaggio già in transito non può essere richiamato. L'eliminazione funziona solo su una bozza ed è permanente, attraverso le stesse tre vie: la pagina di dettaglio, bird email broadcasts delete, o Elimina un broadcast.

Un broadcast fallito mostra il motivo nella sua pagina di dettaglio: la ragione, seguita da una frase che indica la causa esatta. Tramite la API, queste due informazioni sono i campi failure_reason e failure_detail. failure_detail è ciò che ti indica quale tra le diverse cause di una ragione hai effettivamente riscontrato.

La configurazione di invio di un broadcast viene verificata solo quando l'invio inizia. Se il dominio di invio era verificato al momento della programmazione ma ha perso la verifica prima dell'invio, il broadcast fallisce in quel momento. Verifica il dominio e invia di nuovo il broadcast.

Broadcast e invii singoli attingono alla stessa quota email. La scheda del piano nella panoramica di fatturazione della tua organizzazione mostra quanto ne hai utilizzato. Piani e prezzi descrive cosa include ogni piano.

Una volta avviato l'invio, la scheda Overview del broadcast mostra i contatori di destinatari e messaggi inviati, poi i tassi di consegna, apertura, clic, bounce e reclamo con i relativi contatori. La scheda Recipients elenca ogni destinatario con il suo stato di consegna, il motivo in caso di mancata consegna, quando è stato consegnato, e le sue aperture e i clic. La casella di ricerca richiede un indirizzo email completo e valido; un indirizzo parziale o un dominio non supera la validazione, segna la casella come non valida e lascia la tabella con il contenuto precedente. Un pulsante sopra la tabella esporta la scheda come CSV, e Esporta i destinatari di un broadcast come CSV restituisce lo stesso file a una chiave API; entrambi hanno un limite di 500.000 righe con lo stesso comportamento di rifiuto anziché troncamento dell'esportazione della lista broadcast. La scheda Events è il feed di eventi grezzi del broadcast, con i tipi di evento descritti in eventi e webhook.

Inserisci un indirizzo sandbox nell'audience e quel contatto viene simulato invece che effettivamente inviato: delivered@messagebird.dev riporta la consegna avvenuta, bounce@messagebird.dev genera un bounce, e ciascuno produce gli stessi eventi e webhook di un destinatario reale. È così che puoi testare una campagna, e il gestore che ne legge gli eventi, senza inviare email a nessuno. Un'audience può combinare contatti sandbox e reali; ogni contatto ottiene il proprio esito. Un destinatario simulato viene comunque conteggiato nella tua quota di invio, quindi la prova copre la stessa quota dell'invio reale.