Ten dokument przedstawia powszechne sposoby, w jakie nasi klienci używają Bird do ogólnej integracji. Te integracje obejmują kluczowe tematy, takie jak „jak wysłać e-mail?” oraz „jak wiem, co się stało z e-mailem?” Dla organizacji utrzymujących mieszane środowiska lokalne i chmurowe z wymaganiami dotyczącymi bezpieczeństwa nasz przewodnik implementacji S/MIME dla platform lokalnych obejmuje konfiguracje PowerMTA i Momentum dla bezpiecznego dostarczania e-maili. Jeśli przechodzisz z Postfix, Sendmail lub Exim, ten dokument powinien wyjaśnić wszystko, co musisz wiedzieć o podstawach wysyłania i raportowania e-maili. Reszta tego dokumentu zakłada, że masz istniejące konto SparkPost.

Jak wysyłam e-mail?

Bird akceptuje pocztę do przesyłu na kilka sposobów. Zdecydowanie najczęstszym jest SMTP (Simple Mail Transfer Protocol), a Bird przedstawia się dokładnie jak każdy inny zabezpieczony agent e-mail na porcie 587. Jeśli obecnie masz oprogramowanie generujące lub scalające e-maile do dostarczenia, Bird zaakceptuje je jako standardową wiadomość SMTP i spróbuje ją dostarczyć. Będziesz potrzebował systemu z ważnym certyfikatem TLS, który potrafi generować wiadomości SMTP i wysyłać je przez port 587. Postfix, Sendmail i Exim posiadają tę możliwość natywnie.

Przykład 1:

Masz serwer WWW, który generuje scaloną wiadomość do wysyłki e-mail za pomocą Postfix.
· Dostosuj oprogramowanie generujące serwera WWW, aby wysyłało wiadomość SMTP do przypisanego serwera SparkPost zamiast serwera Postfix
· Tak, to naprawdę takie proste

Przykład 2:

Masz jakiś kod zarządzania, który musi używać funkcji „Mail” lokalnego serwera.
· Jeśli korzystasz z Sendmail, edytuj plik /etc/mail/sendmail.mc, aby dodać definicję „smart-host”.
IE: define(`SMART_HOST’,`smtp.MyMessageBirdServer.com’)
· Jeśli korzystasz z Postfix, edytuj plik /etc/postfix/transport, aby dodać definicję przekaźnika smtp.
IE: * smtp:MyMessageBirdServer.com
· Upewnij się, że włączono TLS i ustawiono port wyjściowy na 587.
· Zastosuj zmiany i zrestartuj lokalne usługi poczty
· Wykonaj kod zarządzający, a poczta zostanie skierowana do MessageBird do dostarczenia

A co z wstrzykiwaniem REST?

Dla klientów, którzy używają HTTP(S) do transportu danych w swoich sieciach, konwersja wiadomości na SMTP może być uciążliwa. Bird ma kompleksowe REST API, które może akceptować szablon JSON, listę odbiorców i dane do zastąpienia przez HTTPS, a następnie przekonwertować to na wygenerowaną (scaloną) wiadomość e-mail do wysłania w świat przez standardowy SMTP. Jest to szczególnie pomocne, aby odciążyć proces generacji z serwerów WWW na silnik poczty.

Przykład:

Twoje serwery generują newsletter do 50 000 odbiorców dziennie, scalając dane osobowe, a następnie wysyłając je indywidualnie przez Postfix.
· Utwórz obiekty JSON dla odbiorców, dane do zastąpienia i szablon treści.
· Użyj REST API, aby wysłać obiekty JSON do Transmissions API Bird. Robiąc to, odciążasz proces generacji do SparkPost dla szybszego dostarczenia.
· Możesz nawet umieścić JSON w pliku i użyć cURL:

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

Jak uzyskać informacje o dostarczeniu?

Bird gromadzi ogromne ilości informacji o dostarczaniu i udostępnia je w formacie JSON, który można „przepchnąć” jako webhook lub „pobrać” za pomocą wywołania API. Dane dotyczące dostarczania wyglądają mniej więcej tak:

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

Prawdopodobnie to znacznie więcej danych, niż jesteś przyzwyczajony do widzenia w logu Postfix, a już jest w formacie łatwo konsumowalnym. Relatywnie trywialne jest przekonwertowanie tych danych JSON na format logowania Postfix, jeśli zajdzie taka potrzeba. Dane dotyczące dostarczania, zwrotów, odrzucania, skarg spamowych, otwarć, kliknięć i opóźnień mogą być odczytywane w ten sam sposób.

Przykłady:

1) Zwykle eksportujesz logi Postfix do Excela, aby móc je sortować i analizować.
A) Wykonaj wywołanie API message_events i przetwórz uzyskane dane JSON za pomocą JSON2CSV.

2) Lubisz konwertować swoje logi Postfix do JSON, a następnie przesłać je do usługi WWW do odczytu i analizy.
A) Skorzystaj z MessageBird metrics API, aby pobrać z SparkPost potrzebne dane, które automatycznie są eksportowane jako JSON

3) Masz oddzielny proces, który śledzi i analizuje logi w czasie rzeczywistym i aktualizuje osobną bazę danych odbiorców.
A) SparkPost może dostarczyć webhook w czasie rzeczywistym, który może zasilać twój proces skargami spamowymi i wypisanie się na potrzeby tego celu. Implementacja jest trywialna.

-Tom