Broadcasty

Broadcast wysyła jeden e-mail do całej grupy odbiorców: newsletter, ogłoszenie lub dowolną pojedynczą treść kierowaną do wielu adresatów naraz. Lista odbiorców jest tworzona z członków grupy w momencie rozpoczęcia wysyłki, więc broadcast trafia do każdego, kto jest członkiem grupy w tej chwili.

Twórz wysyłki masowe w Email > Broadcasts w dashboardzie, przez broadcasts API, za pomocą bird email broadcasts lub przez serwer MCP. SDK dla TypeScript, Python, Go i PHP udostępniają zasób broadcasts obejmujący cały cykl życia: utwórz wersję roboczą, zmień ją, dopóki jest jeszcze szkicem, wyślij natychmiast lub w późniejszym terminie, wyświetl listę wysyłek masowych w obszarze roboczym, odczytaj jedną wraz z jej licznikami, anuluj zaplanowaną lub trwającą, usuń tę, która jest jeszcze szkicem, a także odczytaj jej odbiorców, zdarzenia, kliknięte linki, limit wysyłek, z którego wysyłka korzysta, oraz liczebności odbiorców, które wysyłka rozwiązuje. Aby wysłać jednorazową listę odbiorców, użyj wysyłki zbiorczej lub wysyłek pojedynczych.

Zacznij od listy Broadcasts i kliknij New broadcast. Kompozytor to jedna strona: pasek z odbiorcami i nadawcą u góry, treść e-maila poniżej, a na końcu kontrolka ustawień kategorii, śledzenia i tagów. Nie ma osobnego kroku zapisu. Każda zmiana jest automatycznie zapisywana, gdy broadcast ma ustawionych odbiorców i nadawcę, więc szkic powstaje natychmiast po wybraniu tych dwóch elementów, a wysłanie go później to oddzielna, jawna akcja.

Użyj pola To, żeby wybrać odbiorców, albo wybierz New, żeby utworzyć ich bez wychodzenia z kompozytora.

Otwórz kontrolkę ustawień w nagłówku kompozytora, żeby zobaczyć trzy dodatkowe opcje:

Broadcast jest wysyłany z adresu w zweryfikowanej domenie wysyłkowej. Połącz część lokalną z jedną ze swoich zweryfikowanych domen i dodaj nazwę wyświetlaną, jeśli chcesz. Dodaj adres Reply-To, jeśli odpowiedzi mają trafiać gdzie indziej. Wybranie Review ostrzeże cię, jeśli domena nie jest zweryfikowana.

Broadcast wskazuje na jeden z szablonów e-mail w twoim obszarze roboczym, a szablon zawiera temat i treść, które broadcast wysyła. Właściwości kontaktu każdego odbiorcy wypełniają zmienne szablonu w momencie wysyłki, więc jeden broadcast personalizuje treść dla każdego odbiorcy. Broadcast może wypełniać tylko właściwości kontaktu, więc zmienna szablonu odwołująca się do czegokolwiek innego jest odrzucana przy wysyłce, a błąd wskazuje tę zmienną.

Wpisz treść bezpośrednio w polu edycji poniżej tematu albo wybierz Choose a template, żeby zacząć od istniejącego szablonu. Ta opcja jest dostępna tylko gdy broadcast jest pusty, ponieważ wybranie szablonu po wpisaniu tematu lub treści nadpisałoby je. Broadcast wysyła opublikowaną wersję szablonu, więc szablon, który ma tylko szkic, nie może być podstawą wysyłki.

Szablon z więcej niż jednym językiem wysyła jeden z nich do całej grupy odbiorców. Podaj go jako template.language podczas tworzenia lub aktualizacji kampanii, a pomiń, aby wysłać domyślny język szablonu. Zmiana samego języka nie zmienia wersji, do której kampania jest przypisana, jeśli już takową ma. Kampania zostaje przypisana do wersji w momencie przygotowania do wysyłki, więc zaplanowana kampania wysyła wersję opublikowaną w tym momencie, niezależnie od tego, czy wcześniej zmienisz jej język.

Wysyłka to oddzielna, jawna czynność, dostępna z poziomu przycisku Review w edytorze lub ze strony szczegółów kampanii przez Send or reschedule. Każda z tych opcji otwiera okno dialogowe, które sprawdza, czy kampania jest kompletna, ostrzega o elementach mogących spowodować niepowodzenie wysyłki, a następnie pozwala wybrać Send now lub wskazać czas do roku w przód. Zaplanowana kampania pozostaje edytowalna i można ją przeplanować aż do momentu faktycznego rozpoczęcia wysyłki.

Wysyłka sprawdza, czy w grupie odbiorców jest ktoś do osiągnięcia. Grupa, w której nikt nie ma adresu e-mail lub w której każdy adres jest wyciszony, zostaje odrzucona w tym momencie zamiast kończyć się niepowodzeniem później.

Przy wysyłce sprawdzane są dwa limity na poziomie organizacji.

Pierwszy to liczba kampanii, które możesz wysłać w okresie rozliczeniowym. Twój plan określa tę liczbę. Zapisane szkice nie wliczają się do niej, a anulowanie kampanii nie zwraca wykorzystanego limitu. Gdy go wyczerpiesz, albo czekasz na kolejny okres rozliczeniowy, albo przechodzisz na plan z wyższym limitem.

Drugi ogranicza równoczesne kampanie. Jeśli wybierzesz Send now, gdy limit jest osiągnięty, żądanie zostaje odrzucone. Zaplanowana kampania czeka na wolne miejsce.

Przeszukuj listę po tagu lub nazwie szablonu albo filtruj ją po statusie, grupie odbiorców lub zakresie dat. Zakres dat filtruje po dacie utworzenia każdej kampanii, a nie po dacie wysyłki, więc kampania zaplanowana w zeszłym tygodniu na wysyłkę za miesiąc nadal pojawia się w "Last 7 days."

Wyeksportuj bieżący widok jako CSV przyciskiem nad tabelą lub wywołaj Eksportuj kampanie jako CSV, który przyjmuje te same filtry. Powyżej 50 000 wierszy eksport jest odrzucany zamiast cicho obcinany. Zawęź filtry i spróbuj ponownie.

Kampania jest zawsze w jednym z czterech etapów, a filtr Status na liście korzysta z tych samych czterech:

Znacznik w każdym wierszu pokazuje dokładny status w ramach danego etapu. Tę samą wartość zwraca pole status w API.

Anuluj zaplanowaną lub wysyłaną kampanię z jej strony szczegółów, za pomocą bird email broadcasts cancel lub przez Anuluj kampanię i metodę broadcasts.cancel SDK. Odbiorcy, do których kampania jeszcze nie dotarła, zostają pominięci, a wiadomości już w drodze nie da się cofnąć. Usuwanie działa wyłącznie na szkicach i jest nieodwracalne, przez te same trzy ścieżki: stronę szczegółów, bird email broadcasts delete lub Usuń kampanię.

Nieudana kampania pokazuje przyczynę na stronie szczegółów: powód, a potem zdanie wskazujące dokładną przyczynę. Przez API te dwie wartości to pola failure_reason i failure_detail. failure_detail mówi, którą z kilku przyczyn danego powodu faktycznie napotkałeś.

Konfiguracja wysyłki kampanii jest sprawdzana dopiero w momencie rozpoczęcia wysyłki. Jeśli domena nadawcza była zweryfikowana przy planowaniu, ale utraciła weryfikację przed wysyłką, kampania nie powiedzie się w tym momencie. Zweryfikuj domenę i wyślij kampanię ponownie.

Kampanie i pojedyncze wysyłki korzystają z tego samego limitu e-maili. Karta planu w przeglądzie rozliczeń organizacji pokazuje, ile z niego wykorzystałeś. Plany i cennik opisuje, co zawiera każdy plan.

Po rozpoczęciu wysyłki karta Overview kampanii pokazuje liczbę odbiorców i wysłanych wiadomości, a następnie wskaźniki dostarczenia, otwarć, kliknięć, odrzuceń i skarg wraz z ich licznikami. Karta Recipients wymienia każdego odbiorcę wraz ze statusem dostarczenia, powodem niedostarczenia, czasem dostarczenia oraz otwarciami i kliknięciami. Pole wyszukiwania wymaga pełnego, poprawnego adresu e-mail; częściowy adres lub sama domena nie przechodzą walidacji, oznaczają pole jako nieprawidłowe i pozostawiają tabelę w dotychczasowym stanie. Przycisk nad tabelą eksportuje kartę jako CSV, a Eksportuj odbiorców kampanii jako CSV zwraca ten sam plik do klucza API; w obu przypadkach limit to 500 000 wierszy z takim samym zachowaniem odrzucania zamiast obcinania jak w eksporcie listy kampanii. Karta Events to surowy strumień zdarzeń kampanii, korzystający z typów zdarzeń opisanych w sekcji zdarzenia i webhooki.

Umieść adres sandbox w grupie odbiorców, a ten kontakt zostanie zasymulowany zamiast rzeczywiście wysłany: delivered@messagebird.dev zgłasza dostarczenie, bounce@messagebird.dev odrzucenie, a każdy z nich generuje te same zdarzenia i webhooki, co prawdziwy odbiorca. W ten sposób testujesz kampanię i handler odczytujący jej zdarzenia bez wysyłania do kogokolwiek. Grupa odbiorców może łączyć kontakty sandbox i rzeczywiste; każdy kontakt otrzymuje własny wynik. Symulowany odbiorca nadal wlicza się do Twojego limitu wysyłki, więc test zużywa tę samą kwotę co rzeczywista wysyłka.