Ce document décrit les manières courantes dont nos clients utilisent Bird pour l'intégration générale. Ces intégrations couvrent des sujets essentiels tels que « comment envoyer un e-mail ? » et « comment savoir ce qui est arrivé à l'e-mail ? » Pour les organisations maintenant des configurations hybrides sur site et cloud avec des exigences de sécurité, notre guide de mise en œuvre S/MIME pour les plateformes sur site couvre les configurations PowerMTA et Momentum pour une livraison sécurisée des e-mails. Si vous passez de Postfix, Sendmail ou Exim, ce document devrait expliquer tout ce que vous devez savoir sur les bases de l'envoi et du rapport sur les e-mails.  Le reste de ce document suppose que vous avez déjà un compte SparkPost existant.

Comment envoyer un e-mail ?

Bird acceptera le courrier à transférer de plusieurs façons. De loin, la plus commune est SMTP (Simple Mail Transfer Protocol) et Bird se présente précisément comme tout autre agent de messagerie sécurisé sur le port 587. Si vous avez actuellement un logiciel de génération ou de fusion de courrier qui crée un e-mail pour la livraison, Bird l'acceptera comme un message SMTP standard et tentera de le livrer. Vous aurez besoin d'un système avec un certificat TLS valide capable de générer des messages SMTP et de les envoyer via le port 587. Postfix, Sendmail et Exim ont tous cette capacité nativement.

Exemple 1 :

Vous avez un serveur web qui génère un message fusionné pour la livraison d'e-mails via Postfix.
· Ajustez le logiciel de génération du serveur web pour envoyer le message SMTP à votre serveur SparkPost assigné au lieu du serveur Postfix
· Oui, c'est vraiment aussi simple que ça

Exemple 2 :

Vous avez un code de gestion qui doit utiliser la fonction « Mail » du serveur local.
· Si vous utilisez Sendmail, éditez le fichier /etc/mail/sendmail.mc pour ajouter une définition « smart-host ».
IE: define(`SMART_HOST',`smtp.MyMessageBirdServer.com’)
· Si vous utilisez Postfix, éditez le fichier /etc/postfix/transport pour ajouter une définition de relais smtp.
IE: * smtp:MyMessageBirdServer.com
· Assurez-vous d'activer TLS et de régler votre port sortant sur 587.
· Appliquez les modifications et redémarrez les services de messagerie locaux
· Exécutez le code de gestion, et le courrier sera acheminé vers MessageBird pour la livraison

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

Pour les clients qui utilisent HTTP(S) pour transporter des données dans leurs réseaux, convertir un message en SMTP peut être fastidieux. 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 et convertir cela en un e-mail généré (fusionné) à envoyer dans le monde via SMTP standard. Cela est particulièrement utile pour décharger le travail de génération des serveurs web vers le moteur de messagerie.

Exemple :

Vos serveurs génèrent chaque jour une newsletter pour 50 000 destinataires en fusionnant des données personnelles puis en envoyant chaque message individuellement via Postfix.
· Créez des objets JSON pour les destinataires, les données de substitution et le modèle de contenu.
· Utilisez l'API REST pour POST les objets JSON à l'API de transmission de Bird. Cela décharge le processus de génération vers SparkPost pour une livraison plus rapide.
· Vous pouvez même mettre le JSON dans un fichier et utiliser cURL :

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

Comment obtenir les informations de livraison ?

Bird collecte de vastes quantités d'informations sur la livraison et les met à votre disposition au format JSON pouvant être « poussé » via un webhook ou « tiré » avec un appel API. Les données pour 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 à quoi vous êtes habitué dans un journal Postfix et c'est déjà dans un format 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 plainte de spam, d'ouverture, de clic et de retard peuvent être lues de la même manière.

Exemples :

1) Vous exportez généralement les journaux Postfix vers Excel afin de pouvoir trier et analyser.
A) Exécutez un appel API message_events et faites passer les données JSON résultantes par JSON2CSV.

2) Vous aimez convertir vos journaux Postfix en JSON, puis les importer dans un service web pour lecture et analyse.
A) Utilisez l'API de métriques de MessageBird pour interroger SparkPost pour les données dont vous avez besoin, et elles sont automatiquement exportées au format JSON

3) Vous avez un processus distinct qui suit et analyse les journaux en temps réel et met à jour une base de données de destinataires distincte.
A) SparkPost peut fournir un webhook en temps réel qui peut alimenter votre processus de plaintes de spam et de désinscriptions spécifiquement à cette fin. La mise en œuvre est triviale.

-Tom