Przegląd e-maili

Wysyłaj e-maile transakcyjne i marketingowe przez POST /v1/email/messages. Użyj klucza bk_{region}_... z pasującym hostem regionalnym: https://us1.platform.bird.com lub https://eu1.platform.bird.com. Podpisujemy wiadomość za pomocą DKIM, dostarczamy ją i raportujemy wynik dla każdego odbiorcy.

Jeśli chcesz wysłać wiadomość przed dalszą lekturą, szybki start przeprowadzi Cię od klucza API do dostarczonej wiadomości. Ta strona opisuje model, na którym opiera się reszta tej sekcji, i wskazuje przewodnik dla każdej jego części.

Wysyłka jest akceptowana w jednym wywołaniu i dostarczana asynchronicznie. POST /v1/email/messages waliduje ładunek i domenę wysyłającą, a następnie zwraca 202 Accepted z identyfikatorem wiadomości em_. Odczytuj wynik dla każdego odbiorcy przez zdarzenia webhookowe lub endpointy wiadomości. Wysyłanie e-maili opisuje ładunek, limity pól i odpowiedź.

Dwie konsekwencje tego modelu kształtują resztę tej sekcji.

Jedna wiadomość, wielu odbiorców, osobny cykl życia każdego. Wiadomość do pięciu adresów generuje pięć niezależnych wyników, a status na poziomie wiadomości jest ich agregatem. Blokowanie jest oceniane w ten sam sposób: jeden zablokowany adres zwraca rejected, a pozostałe cztery są dostarczane.

Każda wiadomość deklaruje, dlaczego ją wysyłasz. Kategoria transactional lub marketing decyduje, które blokady mają zastosowanie. Osoba, która wypisała się z Twojego newslettera, nadal potrzebuje otrzymać reset hasła, a to właśnie kategoria mówi nam, czym się te wiadomości różnią.

Wysyłka może też dotrzeć inną drogą albo zostać wysłana później. SMTP przyjmuje wiadomości od wszystkiego, co obsługuje ten protokół, a wysyłanie zaplanowane wstrzymuje wiadomość do ustawionego przez Ciebie czasu.

Email to jeden z kanałów na pasku bocznym dashboardu. Jego strony w kolejności, w jakiej się pojawiają:

Odbiorcy znajdują się poza sekcją Email, w Contacts na pasku bocznym: All contacts przechowuje osoby z typowanymi właściwościami niestandardowymi (zobacz Kontakty), a Audiences grupuje je w listy wielokrotnego użytku, do których wysyła broadcast (zobacz Grupy odbiorców).

Wysyłanie. Wysyłanie e-maili to przewodnik, który warto przeczytać jako pierwszy: definiuje ładunek, którego wariacją jest każda inna ścieżka wysyłki. Stamtąd: szablony przechowują treści do ponownego użycia, załączniki dodają pliki, wysyłanie wsadowe przesyła do 100 wiadomości w jednym żądaniu, a broadcasty wysyłają jeden e-mail do całej grupy odbiorców.

Domeny i uwierzytelnianie. Domeny wysyłające opisuje rejestrację domeny i jej weryfikację. DKIM, SPF i DMARC wyjaśnia, co każdy rekord udowadnia dostawcy skrzynki odbiorczej, a BIMI wyświetla Twoje logo obok wiadomości w aplikacjach pocztowych, które to obsługują.

Reputacja. Blokady to lista adresów, na które przestajemy wysyłać, uzupełniana automatycznie na podstawie twardych odrzuceń i skarg; wypisania blokują dostarczanie w ten sam sposób, ale przez wyrażoną preferencję zamiast rekordu blokady. Dedykowane adresy IP i pule oraz rozgrzewka IP opisują wysyłanie z adresów IP używanych wyłącznie przez Twoją organizację. Dostarczalność e-maili łączy te tematy w całość.

Co się wydarzyło. Log e-maili pokazuje jedną wiadomość i jej oś czasu per odbiorca. Metryki e-maili agregują Twój ruch. Zdarzenia to słownik zdarzeń i sposób, w jaki webhooki dostarczają je do Twojego endpointu.

Odbieranie. Odbieranie e-maili opisuje oba sposoby: adres przekierowujący, który generujemy bez potrzeby konfiguracji DNS, lub rekordy MX na Twojej subdomenie. Skrzynki agentów rozszerzają to o skrzynki, z których Twój kod wysyła i które czyta.

Testowanie. Piaskownica pocztowa pozwala przetestować integrację od początku do końca bez dostarczania gdziekolwiek. Wyślij na bounce@messagebird.dev, aby wygenerować twarde odrzucenie przez prawdziwy pipeline zdarzeń i webhooków. Test nie zapisuje niczego na Twojej liście blokad.

Aby przenieść produkcyjne e-maile od innego dostawcy, postępuj zgodnie z przewodnikiem migracji. Obejmuje on mapowanie żądań, DNS, blokady, webhooki, testy w piaskownicy i przełączenie ruchu.