Ten dokument przedstawia powszechne sposoby, w jakie nasi klienci korzystają z Bird do ogólnych integracji. Te integracje obejmują podstawowe tematy, takie jak “jak wysyłam e-mail?” i “jak wiem, co się stało z e-mailem?” 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 zaakceptuje pocztę do transferu na kilka sposobów. Zdecydowanie najczęstszym jest SMTP (Simple Mail Transfer Protocol) i Bird przedstawia się dokładnie jak każdy inny bezpieczny agent poczty na porcie 587. Jeśli obecnie posiadasz oprogramowanie do generowania lub scalania maili, które tworzy e-mail do dostarczenia, Bird zaakceptuje go jako standardową wiadomość SMTP i spróbuje go dostarczyć. Będziesz potrzebować systemu, który posiada ważny certyfikat TLS, zdolnego generować wiadomości SMTP i wysyłać je przez port 587. Postfix, Sendmail i Exim mają tę funkcjonalność natywnie.

Przykład 1:

Masz serwer internetowy, który generuje scaloną wiadomość do wysłania e-mailem przez Postfix.
· Dostosuj oprogramowanie generujące serwera internetowego, aby wysyłało wiadomości SMTP do przypisanego serwera SparkPost zamiast serwera Postfix
· Tak, to naprawdę jest takie proste

Przykład 2:

Masz jakiś kod zarządzania, który musi używać lokalnej funkcji “Mail” serwera.
· Jeśli używasz Sendmail, edytuj plik /etc/mail/sendmail.mc, aby dodać definicję “smart-host”.
IE: define(`SMART_HOST’,`smtp.MyMessageBirdServer.com’)
· Jeśli używasz Postfix, edytuj plik /etc/postfix/transport, aby dodać definicję przekaźnika smtp.
IE: * smtp:MyMessageBirdServer.com
· Upewnij się, że włączysz TLS i ustawisz swój port wychodzący na 587.
· Wdraż zmiany i zrestartuj lokalne usługi pocztowe
· Uruchom kod zarządzania, a poczta zostanie przekierowana do MessageBird do dostarczenia

A co z wstrzykiwaniem REST?

Dla klientów, którzy używają HTTP(S) do przesyłania danych w swoich sieciach, konwertowanie wiadomości na SMTP może być uciążliwe. Bird posiada kompleksowy REST API, który może akceptować szablon JSON, listę odbiorców i dane do substytucji przez HTTPS, a następnie konwertować je na wygenerowane (scalone) e-maile, które są wysyłane do świata przez standardowe SMTP. Jest to szczególnie pomocne, aby odciążyć generowanie pracy od serwerów internetowych na silnik pocztowy.

Przykład:

Twoje serwery generują newsletter dla 50,000 odbiorców codziennie łącząc dane osobowe, a następnie wysyłają każdy indywidualnie przez Postfix.
· Utwórz obiekty JSON dla odbiorców, danych zastępczych i szablonu treści.
· Użyj REST API, aby przesłać obiekty JSON do Transmission API Birda. Robiąc to, przenosisz proces generowania do SparkPost dla szybszego dostarczania.
· Możesz nawet umieścić JSON w pliku i używać cURL:

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

Jak otrzymam informacje o dostawie?

Bird zbiera ogromne ilości informacji o dostarczaniu i udostępnia je w formacie JSON, który można “wpychać” jako webhook lub “wyciągać” za pomocą zapytania API. Dane dla dostawy wyglądają w ten sposób:

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

To prawdopodobnie o wiele więcej danych niż jesteś przyzwyczajony widzieć w logach Postfix i już w formacie, który jest łatwo przyswajalny. Jest względnie trywialne konwertowanie tych danych JSON do formatu logów Postfix, jeśli to konieczne. Dane dotyczące dostaw, odbić, odrzuceń, skarg na spam, otwarć, kliknięć i opóźnień można odczytywać w ten sam sposób.

Przykłady:

1) Zwykle eksportujesz logi Postfix do Excela, aby móc sortować i analizować.
A) Wykonaj zapytanie message_events API i przetwórz uzyskane dane JSON przez JSON2CSV.

2) Lubisz konwertować swoje logi Postfix do JSON, a następnie wprowadzać je do usługi sieciowej do odczytu i analizy.
A) Użyj MessageBird metrics API, aby pobierać z SparkPost potrzebne dane, a są one automatycznie eksportowane jako JSON

3) Masz oddzielny proces, który śledzi i parsuje logi w czasie rzeczywistym i aktualizuje oddzielną bazę danych odbiorców.
A) SparkPost może zapewnić rzeczywisty webhook, który może zasilać twój proces skargi na spam i wypisujących się specjalnie do tego celu. Implementacja jest trywialna.

-Tom