This document outlines common ways our customers use Bird for general integration.  These integrations cover essential topics like “Hur skickar jag e-post?” and “Hur vet jag vad som hände med e-postmeddelandet?”  If you are transitioning from Postfix, Sendmail, or Exim, this document should explain everything you need to know about the basics of sending and reporting on email.  Den rest of this document assumes you have an existing SparkPost account.

Hur skickar jag e-post?

Bird tar emot e-post för överföring på ett par olika sätt. Det absolut vanligaste är SMTP (Simple Mail Transfer Protocol) och Bird presenterar sig precis som alla andra säkra e-postagenter på port 587. Om du för närvarande har ett genererings- eller e-postprogram som skapar ett e-postmeddelande för leverans, kommer Bird att acceptera det som ett standard SMTP-meddelande och försöka leverera det. Du behöver ett system med ett giltigt TLS-certifikat som kan generera SMTP-meddelanden och skicka dem över port 587. Postfix, Sendmail och Exim har alla denna inbyggda funktion.

Exempel 1:

You have a web server that generates a merged message for email delivery through Postfix.
· Adjust the web server’s generation software to send SMTP message to your assigned SparkPost server instead of the Postfix server
· Ja, det är verkligen så enkelt

Exempel 2:

You have some management code that needs to use the local server’s “Mail” function.
· If you are using Sendmail, edit the /etc/mail/sendmail.mc file to add a “smart-host” definition.
IE: define(`SMART_HOST’,`smtp.MyMessageBirdServer.com’)
· If you are using Postfix, edit the /etc/postfix/transport file to add an smtp relay definition.
IE: * smtp:MyMessageBirdServer.com
· Make sure you enable TLS and set your outbound port to 587.
· Apply the changes and restart the local mail services
· Execute the management code as, and the mail will route to MessageBird for delivery

Vad sägs om REST-injektion?

För kunder som använder HTTP(S) för att transportera data i sina nätverk kan det vara besvärligt att konvertera ett meddelande till SMTP. Bird har ett omfattande REST API som kan acceptera en JSON-mall, lista över mottagare och substitutionsdata över HTTPS och sedan konvertera detta till genererad (sammanslagen) e-post som kan skickas till världen över standard SMTP. Detta är särskilt användbart för att avlasta genereringsarbetet från webbservrar till e-postmotorn.

Exempel:

Your servers generate a newsletter to 50,000 recipients daily merging personal data then send each individually through Postfix.
· Create JSON objects for the recipients, substitution data, and content template.
· Use the REST API to POST the JSON objects to Bird’s Transmission API. Doing this offloads the generation process to SparkPost for faster delivery.
· You can even put the JSON in a file and use cURL:

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

Hur får jag leveransinformation?

Bird samlar in stora mängder leveransinformation och gör den tillgänglig för dig i JSON-format som kan "pushas" som en webhook eller "pullas" med ett API-anrop. Uppgifterna för en leverans ser ut ungefär så här:

{      "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" }

Det är förmodligen mycket mer data än du är van vid att se i en Postfix-logg och det är redan i ett format som är lätt att konsumera. Det är relativt trivialt att konvertera JSON-data till Postfix loggningsformat om det behövs. Leverans, bounce, reject, spam_complaint, open, click och fördröjningsdata kan läsas på samma sätt.

Exempel:

1) You usually export Postfix logs out to Excel so you can sort and analyze.
A) Execute a message_events API call and run the resulting JSON data through JSON2CSV.

2) You like to convert your Postfix logs to JSON, then pull them into a web service for reading and analysis.
A) Use the MessageBird metrics API to poll SparkPost for the data you need, and it is automatically exported as JSON

3) You have a separate process that tails and parses the logs in real-time and updates a separate recipient database.
A) SparkPost can provide a real-time webhook that can feed your process spam_complaintants and unsubscribes specifically for this purpose. Implementation is trivial.

-Tom