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.
Jak działa wysyłanie
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. Suppresja jest oceniana w ten sam sposób: jeden adres objęty suppresją zwraca rejected, a pozostałe cztery są dostarczane.
Każda wiadomość deklaruje, dlaczego ją wysyłasz. Kategoria transactional lub marketing decyduje, które suppresje mają do niej zastosowanie. Osoba, która wypisała się z Twojego newslettera, nadal musi otrzymać e-mail z resetem hasła, a to właśnie kategoria mówi nam, czym te wiadomości się 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.
Sekcja Email w dashboardzie
Email to jeden z kanałów na pasku bocznym dashboardu. Jego strony w kolejności, w jakiej się pojawiają:
| Strona | Co zawiera |
|---|---|
| Onboarding | Trzystopniowa lista kontrolna: utwórz klucz API, wyślij e-mail, dodaj domenę. Wyświetla się, dopóki jej nie ukończysz |
| Metrics | Wskaźniki dostarczeń, otwarć, odrzuceń i skarg w czasie; zobacz Metryki e-maili |
| Emails | Każda wysłana wiadomość; zobacz log e-maili. Zakładka Receiving wyświetla wiadomości przychodzące |
| Mailboxes | Programowalne skrzynki, które Twój kod czyta i z których odpowiada; zobacz Skrzynki agentów |
| Templates | Treści tematu i treści wiadomości do wielokrotnego użytku, w wersji roboczej i opublikowanej; zobacz Szablony e-maili |
| Domains | Twoje domeny wysyłające, ich rekordy DNS i bieżący status weryfikacji; zobacz Domeny wysyłające |
| IP Pools | Dedykowane adresy IP i pule, w których się znajdują; zobacz Dedykowane adresy IP i pule |
| Broadcasts | Jeden e-mail do zapisanej grupy odbiorców, z dostarczaniem śledzonym dla każdego odbiorcy; zobacz Broadcasty |
| Suppressions | Adresy, na które nie wysyłamy, wraz z powodem; zobacz Suppresje |
| Unsubscribe page | Branding hostowanej strony, do której linkuje każdy e-mail marketingowy; zobacz Linki do wypisania |
| SMTP | Ustawienia połączenia, domyślne parametry wysyłki per klucz i aktywne połączenia; zobacz SMTP |
| Inbox Insights | Umieszczanie w skrzynce odbiorczej i reputacja nadawcy u różnych dostawców skrzynek pocztowych; zobacz Inbox Insights |
| Competitive insights | Wolumen wysyłek, częstotliwość i zaangażowanie obserwowanych marek na podstawie danych z panelu; zobacz Competitive Insights |
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).
Gdzie pasuje każdy przewodnik
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. Suppresje to lista adresów, na które przestajemy wysyłać, uzupełniana automatycznie na podstawie twardych odrzuceń i skarg; wypisania wstrzymują dostarczanie w ten sam sposób, ale przez wyrażoną preferencję zamiast rekordu suppresji. 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 wiadomości do kogokolwiek. Wyślij wiadomość na bounce@messagebird.dev, aby wygenerować twarde odrzucenie przez rzeczywisty pipeline zdarzeń i webhooków. Test nie dodaje niczego do Twojej listy suppresji.
Aby przenieść produkcyjne e-maile od innego dostawcy, postępuj zgodnie z przewodnikiem migracji. Obejmuje on mapowanie żądań, DNS, suppresje, webhooki, testy w piaskownicy i przełączenie ruchu.
Powiązane zasoby
Przejdź do dokumentacji, przewodników i przykładów dotyczących tego tematu.