Ce document décrit les raisons courantes pour lesquelles nos clients utilisent Bird pour une intégration générale. Ces intégrations couvrent des sujets essentiels tels que « comment puis-je envoyer un e-mail ? » et « comment puis-je savoir ce qui est arrivé à l'e-mail ? » 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 reporting des e-mails. Le reste de ce document suppose que vous avez un compte SparkPost existant.
Comment puis-je envoyer un e-mail ?
Bird acceptera le courrier pour transfert de plusieurs manières. De loin, la plus courante est SMTP (Simple Mail Transfer Protocol) et Bird se présente précisément comme n'importe quel autre agent e-mail sécurisé sur le port 587. Si vous avez actuellement un logiciel de génération ou de publipostage 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 par e-mail via Postfix.
· Ajustez le logiciel de génération du serveur web pour envoyer des messages 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 définir votre port sortant sur 587.
· Appliquez les modifications et redémarrez les services d'e-mail locaux
· Exécutez le code de gestion comme ceci, 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, puis convertir cela en e-mail généré (fusionné) à envoyer au monde via SMTP standard. Cela est particulièrement utile pour décharger le travail de génération des serveurs web au moteur d'envoi.
Exemple :
Vos serveurs génèrent une newsletter pour 50 000 destinataires chaque jour en fusionnant des données personnelles, puis en envoyant chacune 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 POSTER 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 puis-je obtenir des informations de livraison ?
Bird collecte une grande quantité d'informations sur les livraisons et les met à votre disposition au format JSON qui peut être « poussé » sous forme de webhook ou « tiré » par un appel API. Les données d'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":"Modèle de lettre de bienvenue", "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 elles sont déjà dans un format facilement consommable. Il est assez 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 pour 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 d'API message_events et passez les données JSON résultantes à JSON2CSV.
2) Vous aimez convertir vos journaux Postfix en JSON, puis les tirer dans un service web pour les lire et les analyser.
A) Utilisez l'API de métriques 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 séparée.
A) SparkPost peut fournir un webhook en temps réel qui peut alimenter votre processus avec des plaintes pour spam et des désabonnements spécifiquement à cet effet. L'implémentation est triviale.
-Tom