This document outlines common ways our customers use Bird for general integration.  These integrations cover essential topics like “Comment envoyer un courrier électronique ?” and “Comment puis-je savoir ce qu'il est advenu de l'e-mail ?”  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.  Le rest of this document assumes you have an existing SparkPost account.

Comment envoyer un courrier électronique ?

Bird accepte le courrier à transférer de plusieurs manières. La plus courante est de loin le SMTP (Simple Mail Transfer Protocol) et Bird se présente précisément comme n'importe quel autre agent de messagerie sécurisé sur le port 587. Si vous disposez actuellement d'un logiciel de génération ou de fusion de courrier qui crée un courrier électronique à livrer, Bird l'acceptera comme un message SMTP standard et tentera de le livrer. Vous aurez besoin d'un système doté d'un certificat TLS valide, capable de générer des messages SMTP et de les envoyer sur le port 587. Postfix, Sendmail et Exim ont tous cette capacité en natif.

Exemple 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
· Oui, c'est aussi simple que cela

Exemple 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

Qu'en est-il de l'injection REST ?

Pour les clients qui utilisent HTTP(S) pour transporter des données dans leurs réseaux, la conversion d'un message en SMTP peut être fastidieuse. Bird dispose d'une API REST complète qui peut accepter un modèle JSON, une liste de destinataires et des données de substitution via HTTPS, puis les convertir en courriels générés (fusionnés) à envoyer au monde entier via SMTP standard. Ceci est particulièrement utile pour décharger le travail de génération des serveurs web vers le moteur de messagerie.

Exemple :

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

Comment puis-je obtenir des informations sur les livraisons ?

Bird recueille une grande quantité d'informations sur les livraisons et les met à votre disposition au format JSON, qui peut être "poussé" sous la forme d'un webhook ou "tiré" par un appel API. Les données relatives à une livraison ressemblent à ceci :

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

C'est probablement beaucoup plus de données que ce que vous avez l'habitude de voir dans un journal Postfix et c'est déjà dans un format qui est facilement consommable. Il est relativement trivial de convertir ces données JSON au format de journalisation Postfix si nécessaire. Les données de livraison, de rebond, de rejet, de spam_complaint, d'ouverture, de clic et de délai peuvent être lues de la même manière.

Exemples :

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