Panoramica su Email
Invia email transazionali e di marketing tramite POST /v1/email/messages. Usa una chiave bk_{region}_... con l'host regionale corrispondente: https://us1.platform.bird.com o https://eu1.platform.bird.com. Firmiamo il messaggio con DKIM, lo consegniamo e riportiamo l'esito per ciascun destinatario.
Per inviare qualcosa prima di proseguire, il quickstart ti porta da una chiave API a un messaggio consegnato. Questa pagina descrive il modello su cui si basa il resto della sezione e rimanda alla guida per ogni sua parte.
Come funziona l'invio
Un invio viene accettato in una sola chiamata e consegnato in modo asincrono. POST /v1/email/messages valida il payload e il dominio di invio, poi restituisce 202 Accepted con un ID messaggio em_. Leggi l'esito di ciascun destinatario tramite gli eventi webhook o gli endpoint dei messaggi. Invio di email descrive il payload, i limiti dei campi e la risposta.
Due conseguenze di questo modello definiscono il resto di questa sezione.
Un messaggio, molti destinatari, un ciclo di vita ciascuno. Un messaggio inviato a cinque indirizzi produce cinque esiti indipendenti, e lo stato a livello di messaggio che leggi è un aggregato di tutti. La soppressione viene valutata allo stesso modo: un indirizzo soppresso viene restituito come rejected mentre gli altri quattro vengono consegnati.
Ogni messaggio dichiara perché lo stai inviando. Una categoria di transactional o marketing decide quali soppressioni si applicano. Chi ha annullato l'iscrizione alla tua newsletter ha comunque bisogno di ricevere il reset della password, e la categoria è ciò che indica la differenza.
Un invio può anche arrivare per un'altra via, o partire più tardi. SMTP accetta richieste da qualsiasi cosa che parli il protocollo, e l'invio programmato trattiene un messaggio fino a un orario da te impostato.
La sezione Email della dashboard
Email è uno dei canali nella barra laterale della dashboard. Le sue pagine, nell'ordine in cui appaiono:
| Pagina | Contenuto |
|---|---|
| Onboarding | Una checklist in tre passaggi: crea una chiave API, invia un'email, aggiungi il tuo dominio. Rimane visibile finché non l'hai completata |
| Metrics | Tassi di consegna, apertura, bounce e reclami nel tempo; vedi Metriche email |
| Emails | Ogni messaggio inviato; vedi il log email. La scheda Receiving elenca ciò che è arrivato |
| Mailboxes | Caselle programmabili da cui il tuo codice legge e risponde; vedi Agent mailboxes |
| Templates | Oggetto e corpo riutilizzabili, con versione bozza e pubblicata; vedi Template email |
| Domains | I tuoi domini di invio, i relativi record DNS e lo stato di verifica in tempo reale; vedi Domini di invio |
| IP Pools | IP dedicati e i pool in cui si trovano; vedi IP dedicati e pool |
| Broadcasts | Un'email a un'audience salvata, con consegna tracciata per destinatario; vedi Broadcast |
| Suppressions | Indirizzi a cui non inviamo, e perché; vedi Soppressioni |
| Unsubscribe page | Branding della pagina ospitata a cui ogni email di marketing rimanda; vedi Link di annullamento iscrizione |
| SMTP | Impostazioni di connessione, valori di invio predefiniti per chiave e connessioni attive; vedi SMTP |
I destinatari si trovano fuori dalla sezione Email, in Contacts nella barra laterale: All contacts memorizza le persone con proprietà personalizzate tipizzate (vedi Contatti), e Audiences le raggruppa nelle liste riutilizzabili a cui un broadcast invia (vedi Audience).
Dove si colloca ogni guida
Invio. Invio di email è la guida da leggere per prima: contiene il payload su cui ogni altro percorso di invio è una variazione. Da lì, i template memorizzano contenuti da riutilizzare, gli allegati aggiungono file, l'invio in batch invia fino a 100 messaggi in una sola richiesta, e i broadcast inviano un'email a un'intera audience.
Domini e autenticazione. Domini di invio descrive come registrare un dominio e ottenerne la verifica. DKIM, SPF e DMARC spiega cosa dimostra ogni record al provider di posta ricevente, e BIMI mostra il tuo logo accanto ai tuoi messaggi nelle app email che lo supportano.
Reputazione. Soppressioni è l'elenco degli indirizzi a cui cessiamo di inviare, alimentato automaticamente da hard bounce e reclami; le cancellazioni fermano la consegna allo stesso modo, ma tramite una preferenza dichiarata invece di un record di soppressione. IP dedicati e pool e IP warmup coprono l'invio da indirizzi IP usati solo dalla tua organizzazione. Deliverability email li collega tutti.
Sapere cos'è successo. Il log email mostra un singolo messaggio e la sua cronologia per destinatario. Metriche email aggrega il tuo traffico. Eventi è il vocabolario degli eventi e come i webhook li recapitano al tuo endpoint.
Ricezione. Ricezione email copre entrambi i modi di ingresso: un indirizzo di inoltro che generiamo noi senza bisogno di DNS, oppure record MX su un sottodominio di tua proprietà. Agent mailboxes aggiunge caselle da cui il tuo codice invia e legge.
Test. La mail sandbox esercita la tua integrazione end-to-end senza consegnare nulla. Invia a bounce@messagebird.dev per generare un hard bounce attraverso la pipeline reale di eventi e webhook. Il test non scrive nulla nella tua lista di soppressione.
Per spostare le email di produzione da un altro provider, segui la guida alla migrazione. Copre la mappatura delle richieste, DNS, soppressioni, webhook, test in sandbox e cutover del traffico.
Risorse correlate
Prosegui con la documentazione, le guide e gli esempi per questo argomento. Le risorse sono in inglese.
Guarda la guidaGetting started with emailEsplora la funzionalitàEmailSegui il percorso di apprendimentoBuild your first integration
Prova l'esercitazione e ottieni un brief di implementazione