Questo documento delinea i modi comuni in cui i nostri clienti utilizzano Bird per l'integrazione generale. Queste integrazioni coprono argomenti essenziali come "come invio email?" e "come faccio a sapere cosa è successo all'email?" Per le organizzazioni che mantengono configurazioni ibride on-premise e cloud con requisiti di sicurezza, la nostra guida all'implementazione S/MIME per piattaforme on-premise copre le configurazioni di PowerMTA e Momentum per una consegna email sicura. Se stai effettuando la transizione da Postfix, Sendmail o Exim, questo documento dovrebbe spiegare tutto ciò che devi sapere sui fondamenti dell'invio e del report delle email. Il resto di questo documento presuppone che tu abbia un account SparkPost esistente.

Come invio email?

Bird accetterà la posta per il trasferimento in un paio di modi. Di gran lunga, il più comune è SMTP (Simple Mail Transfer Protocol) e Bird si presenta esattamente come qualsiasi altro agente di posta sicuro sulla porta 587. Se attualmente hai software di generazione o fusione di posta che crea un'email per la consegna, Bird lo accetterà come un messaggio SMTP standard e tenterà di consegnarlo. Avrai bisogno di un sistema con un certificato TLS valido in grado di generare messaggi SMTP e inviarli tramite la porta 587. Postfix, Sendmail e Exim hanno questa capacità nativamente.

Esempio 1:

Hai un server web che genera un messaggio fuso per la consegna tramite Postfix.
· Regola il software di generazione del server web per inviare il messaggio SMTP al tuo server SparkPost assegnato anziché al server Postfix
· Sì, è davvero così semplice

Esempio 2:

Hai del codice di gestione che deve utilizzare la funzione “Mail” del server locale.
· Se stai usando Sendmail, modifica il file /etc/mail/sendmail.mc per aggiungere una definizione di "smart-host".
Esempio: define(`SMART_HOST’,`smtp.MyMessageBirdServer.com’)
· Se stai usando Postfix, modifica il file /etc/postfix/transport per aggiungere una definizione di relay smtp.
Esempio: * smtp:MyMessageBirdServer.com
· Assicurati di abilitare TLS e imposta la porta di uscita su 587.
· Applica le modifiche e riavvia i servizi di posta locali
· Esegui il codice di gestione e la posta verrà instradata a MessageBird per la consegna

E l'iniezione REST?

Per i clienti che utilizzano HTTP(S) per trasportare dati nelle loro reti, convertire un messaggio in SMTP può essere oneroso. Bird ha un completo REST API che può accettare un modello JSON, un elenco di destinatari e dati di sostituzione su HTTPS e quindi convertirlo in email generata (fusa) da inviare al mondo tramite SMTP standard. Questo è particolarmente utile per scaricare il lavoro di generazione dai server web al motore di posta.

Esempio:

I tuoi server generano una newsletter per 50.000 destinatari giornalieri fondendo dati personali poi inviano ciascuno individualmente tramite Postfix.
· Crea oggetti JSON per i destinatari, i dati di sostituzione e il modello di contenuto.
· Usa il REST API per POSTare gli oggetti JSON all'API di trasmissione di Bird. Facendo questo si scarica il processo di generazione su SparkPost per una consegna più veloce.
· Puoi anche mettere il JSON in un file e usare cURL:

curl -v -H "Content-Type: application/json" -X POST \ https://api.bird.com/api/v1transmissions -d@./newsletter.json

Come ottengo le informazioni di consegna?

Bird raccoglie abbondanti quantità di informazioni di consegna e le rende disponibili a te in formato JSON che può essere "spinto" come un webhook o "richiesto" con una chiamata API. I dati per una consegna appaiono qualcosa di simile a questo:

{      "campaign_id":"Welcome_Letter",    "customer_id":"108",    "delv_method":"esmtp",    "event_id":"84769964978165188",    "friendly_from":"bounce@sp-send.com",    "ip_address":"50.116.50.117",    "ip_pool":"default",    "message_id":"00046a82565a6d39451a",    "msg_from":"abc-bounces-108@sp-send..com",    "msg_size":"2164",    "num_retries":"0",    "queue_time":"1759",    "raw_rcpt_to":"fakespark+32@deadboltemail.com",    "rcpt_meta":{      },    "rcpt_tags":[      ],    "rcpt_to":"fakespark+32@deadboltemail.com",    "routing_domain":"deadboltemail.com",    "sending_ip":"52.38.47.118",    "subject":"Welcome Letter Template",    "tdate":"2018-01-10T21:15:24.000Z",    "template_id":"welcome-letter",    "template_version":"5",    "transmission_id":"84769964922735103",    "type":"delivery",    "timestamp":"2018-01-10T14:15:24.000-07:00" }

Questi sono probabilmente molti più dati di quelli a cui sei abituato a vedere in un log Postfix e sono già in un formato facilmente consumabile. È relativamente banale convertire quei dati JSON nel formato di log Postfix se necessario. Le informazioni su consegna, rimbalzo, rifiuto, reclamo spam, apertura, clic e ritardi possono essere lette allo stesso modo.

Esempi:

1) Solitamente esporti i log di Postfix su Excel per poterli ordinare e analizzare.
A) Esegui una chiamata API message_events e gestisci i dati JSON risultanti tramite JSON2CSV.

2) Ti piace convertire i tuoi log Postfix in JSON, poi portarli a un servizio web per la lettura e l'analisi.
A) Usa l'API di metriche di MessageBird per sondare SparkPost per i dati di cui hai bisogno, ed è automaticamente esportato come JSON

3) Hai un processo separato che traccia e analizza i log in tempo reale e aggiorna un database di destinatari separato.
A) SparkPost può fornire un webhook in tempo reale che può alimentare il tuo processo di reclami spam e cancellazioni di iscrizioni specificamente per questo scopo. L'implementazione è banale.

-Tom