Categorie
Ogni email che invii ha una categoria che indica il motivo dell'invio, impostata con il campo category su POST /v1/email/messages. Accetta uno di due valori, marketing o transactional, e ha un solo effetto: decide quali record di soppressione e preferenze di disiscrizione possono bloccare il messaggio.
Una disiscrizione da una newsletter dice qualcosa sulla posta marketing e nulla sui reset delle password. La categoria è il modo in cui distinguiamo questi due intenti.
Le due categorie
- marketing: posta che il destinatario ha scelto di ricevere e può scegliere di non ricevere più. Campagne, newsletter, annunci di prodotto, offerte promozionali. Tutto ciò per cui "I don't want this anymore" è una risposta che devi rispettare.
- transactional: posta richiesta da un'azione del destinatario stesso. Reset delle password, verifica email, codici monouso, ricevute di ordini, avvisi di sicurezza e relativi all'account. Questi messaggi devono arrivare indipendentemente dalle preferenze marketing del destinatario.
Chiediti cosa succede se il messaggio non arriva mai. Se un flusso avviato dal destinatario si interrompe, è transazionale. Se la conversazione l'hai avviata tu, è marketing.
Queste due sono l'insieme completo: nessuna API crea o configura una categoria, e il campo è validato rispetto a quei valori. Per una segmentazione più fine, usa i tag insieme alla categoria.
Come la categoria determina la politica di soppressione
Il contratto si riassume in una riga: marketing è bloccato da qualsiasi motivo di soppressione e da qualsiasi opt-out, mentre transactional viene recapitato nonostante una soppressione per reclamo o un opt-out solo marketing. Hard bounce, soppressioni manuali e un opt-out registrato per tutti i messaggi bloccano entrambe le categorie.
L'asimmetria deriva dal significato di ciascun motivo. Un hard bounce indica che l'indirizzo non esiste, quindi inviare è inutile qualunque sia la categoria. Una soppressione manuale è una decisione del tuo team, che non mettiamo mai in discussione. Reclami e disiscrizioni sono preferenze sulla posta indesiderata: bloccano i tuoi invii marketing, mentre un destinatario che ha segnalato la tua newsletter come spam continua a ricevere il reset della password. L'eccezione è altrettanto intenzionale: un opt-out può essere registrato per tutti i messaggi anziché solo per il marketing (la scelta Messaggi da interrompere nella finestra Registra preferenza, oppure coverage: all su POST /v1/preferences), e in quel caso il destinatario chiede il silenzio, quindi blocca anche la posta transazionale.
I destinatari bloccati vengono rifiutati in modo visibile, una riga per destinatario con il motivo allegato. Soppressioni contiene la tabella motivo per motivo e spiega come gli indirizzi finiscono nella lista.
Il valore predefinito e perché gli invii transazionali devono rinunciarvi
Se ometti category, l'invio è marketing. Questo fallisce nella direzione sicura: la posta inviata senza una categoria esplicita rispetta disiscrizioni e reclami e include un link di disiscrizione, quindi una campagna è conforme senza lavoro aggiuntivo.
Due percorsi di invio prendono la categoria da un'altra fonte. Un invio che usa un template salvato e omette category adotta la classificazione del template stesso, quindi un template creato come transactional viene inviato come transazionale. Imposta category sull'invio per classificare un singolo messaggio diversamente: il valore dell'invio prevale. La posta inviata tramite SMTP prende la categoria dalla configurazione SMTP della chiave API, che è transactional per una chiave non configurata.
Quindi la posta operativa deve rinunciare al valore predefinito. Un reset della password inviato senza categoria viene trattato come marketing: include un link di disiscrizione che non dovrebbe avere, e una disiscrizione dalla newsletter lo blocca anche se il destinatario lo ha richiesto. Imposta category: "transactional" su ricevute, reset, codici di verifica e avvisi relativi all'account:
Esempio di codice
{
"from": "no-reply@yourdomain.com",
"to": ["delivered@messagebird.dev"],
"subject": "Reset your password",
"html": "<p>Click the link below to reset your password...</p>",
"category": "transactional"
}Le categorie come dimensione di analisi
La categoria resta associata al messaggio e ricompare ovunque il messaggio appaia, suddividendo i numeri di recapito, bounce e coinvolgimento in traffico marketing e operativo senza che tu debba taggare ogni invio. La lista messaggi filtra per categoria, le statistiche API scompongono le metriche per categoria e il log email della dashboard offre lo stesso filtro.
Prossimi passi
- Invio di email: il payload POST /v1/email/messages completo, incluso category
- Soppressioni: la lista di soppressione, i tre motivi e la matrice completa delle categorie
- Link di disiscrizione: i dettagli di opt-out inclusi in un invio marketing
- Riferimento API: schemi completi di richiesta e risposta
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 integrationGuida all'implementazioneSend your first email
Prova l'esercitazione e ottieni un brief di implementazione