Dieses Dokument skizziert häufige Wege, wie unsere Kunden Bird für allgemeine Integration verwenden. Diese Integrationen behandeln wichtige Themen wie „Wie sende ich eine E-Mail?“ und „Wie erfahre ich, was mit der E-Mail passiert ist?“ Für Organisationen, die hybride On-Premise- und Cloud-Setups mit Sicherheitsanforderungen unterhalten, behandelt unser S/MIME-Implementierungshandbuch für On-Premise-Plattformen PowerMTA- und Momentum-Konfigurationen für sichere E-Mail-Zustellung. Wenn Sie von Postfix, Sendmail oder Exim wechseln, sollte dieses Dokument alles erklären, was Sie über die Grundlagen des Sendens und Berichtens von E-Mails wissen müssen.  Der Rest dieses Dokuments setzt voraus, dass Sie ein bestehendes SparkPost-Konto haben.

Wie sende ich E-Mails?

Bird akzeptiert E-Mails zur Übertragung auf verschiedene Weise. Bei weitem am häufigsten ist SMTP (Simple Mail Transfer Protocol) und Bird präsentiert sich genau wie jeder andere sichere E-Mail-Agent auf Port 587. Wenn Sie derzeit Software für Generierung oder Serienbriefe nutzen, die eine E-Mail zur Zustellung erstellt, akzeptiert Bird diese als standardmäßige SMTP-Nachricht und versucht, sie zuzustellen. Sie benötigen ein System mit einem gültigen TLS-Zertifikat, das SMTP-Nachrichten generieren und über Port 587 senden kann. Postfix, Sendmail und Exim haben diese Fähigkeit nativ.

Beispiel 1:

Sie haben einen Webserver, der eine zusammengeführte Nachricht zur E-Mail-Zustellung über Postfix generiert.
· Passen Sie die Generierungssoftware des Webservers an, um die SMTP-Nachricht an Ihren zugewiesenen SparkPost-Server anstelle des Postfix-Servers zu senden
· Ja, es ist wirklich so einfach

Beispiel 2:

Sie haben einige Verwaltungscodes, die die „Mail“-Funktion des lokalen Servers nutzen müssen.
· Wenn Sie Sendmail verwenden, bearbeiten Sie die Datei /etc/mail/sendmail.mc, um eine „smart-host“-Definition hinzuzufügen.
IE: define(`SMART_HOST’,`smtp.MyMessageBirdServer.com’)
· Wenn Sie Postfix nutzen, bearbeiten Sie die Datei /etc/postfix/transport, um eine SMTP-Relay-Definition hinzuzufügen.
IE: * smtp:MyMessageBirdServer.com
· Stellen Sie sicher, dass Sie TLS aktivieren und Ihren ausgehenden Port auf 587 setzen.
· Wenden Sie die Änderungen an und starten Sie die lokalen E-Mail-Dienste neu
· Führen Sie den Verwaltungscode aus und die E-Mail wird an MessageBird zur Zustellung weitergeleitet

Was ist mit REST-Injektion?

Für Kunden, die HTTP(S) verwenden, um Daten in ihren Netzwerken zu transportieren, kann die Umwandlung einer Nachricht in SMTP umständlich sein. Bird hat eine umfassende REST-API, die eine JSON-Vorlage, eine Empfängerliste und Ersetzungsdaten über HTTPS akzeptieren und dann in generierte (zusammengeführte) E-Mails umwandeln kann, die über standardmäßiges SMTP in die Welt gesendet werden. Dies ist besonders hilfreich, um die Generierungsarbeit von Webservern an die E-Mail-Engine abzugeben.

Beispiel:

Ihre Server generieren täglich einen Newsletter an 50.000 Empfänger, der persönliche Daten zusammenführt, und senden dann jede E-Mail einzeln durch Postfix.
· Erstellen Sie JSON-Objekte für die Empfänger, Ersetzungsdaten und Inhaltsvorlage.
· Verwenden Sie die REST-API, um die JSON-Objekte an die Transmission-API von Bird zu POSTen. Dadurch wird der Generierungsprozess an SparkPost ausgelagert, um eine schnellere Zustellung zu ermöglichen.
· Sie können das JSON sogar in eine Datei platzieren und cURL verwenden:

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

Wie erhalte ich Zustellinformationen?

Bird sammelt umfangreiche Mengen an Zustellinformationen und stellt diese im JSON-Format zur Verfügung, die als Webhook „gepusht“ oder mit einem API-Aufruf „gepullt“ werden können. Die Daten für eine Zustellung sehen in etwa so aus:

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

Das sind wahrscheinlich viel mehr Daten, als Sie es gewohnt sind, in einem Postfix-Protokoll zu sehen, und es ist bereits in einem Format, das leicht konsumiert werden kann. Es ist relativ trivial, diese JSON-Daten in das Postfix-Protokollformat umzuwandeln, falls erforderlich. Zustellung, Rücksendung, Ablehnung, Spam-Beschwerde, Öffnen, Klicken und Verzögerungsdaten können auf die gleiche Weise gelesen werden.

Beispiele:

1) Sie exportieren normalerweise Postfix-Protokolle nach Excel, um sie zu sortieren und zu analysieren.
A) Führen Sie einen message_events API-Aufruf aus und verarbeiten Sie die resultierenden JSON-Daten durch JSON2CSV.

2) Sie möchten Ihre Postfix-Protokolle in JSON umwandeln und dann in einen Webdienst zum Lesen und Analysieren einziehen.
A) Verwenden Sie die MessageBird-Metriken-API, um bei SparkPost die benötigten Daten abzufragen und es wird automatisch als JSON exportiert

3) Sie haben einen separaten Prozess, der die Protokolle in Echtzeit nachverfolgt und analysiert und eine separate Empfängerdatenbank aktualisiert.
A) SparkPost kann einen Echtzeit-Webhook bereitstellen, der Ihrem Prozess Spam-Beschwerden und Abmeldungen speziell für diesen Zweck zuführen kann. Die Implementierung ist trivial.

-Tom