Sklep może powiadomić wielu klientów o tym samym wydarzeniu, personalizując każdą wiadomość. Każdy odbiorca nadal potrzebuje zgody i prawidłowej ścieżki dostarczenia.
Co się zmienia, gdy wysyłam do wielu odbiorców?
Koordynujesz wiele niezależnych wysyłek zamiast traktować jedno żądanie jako całą kampanię.
Każdy odbiorca może mieć inne miejsce docelowe, wymagania dotyczące nadawcy lub stan zgody. Udane dostarczenie do jednej osoby nie mówi nic o telefonie innej osoby.
Personalizacja zmienia też treść wiadomości. Dłuższe imię lub emoji mogą zmienić kodowanie i liczbę segmentów. Przy szacowaniu rozliczanego wolumenu licz gotowe treści wiadomości.
Broadcast czy partie API?
Używaj broadcastu do koordynowania kampanii wokół odbiorców, wspólnej treści i harmonogramu wysyłki. Używaj partii do wysyłania niezależnych wiadomości z aplikacji.
Przepływ kampanii SMS łączy przygotowanie odbiorców, personalizację, przegląd przed wysyłką i wyniki dostarczenia. Endpoint partii zapewnia węższą operację: przyjmowanie pojedynczych żądań razem.
Identyfikator partii nie zastępuje zarządzania kampanią, rejestrów zgód ani harmonogramu.
Jak Bird przyjmuje partię?
Wysyłasz od 1 do 100 niezależnych wiadomości przez POST /v1/sms/batches.
Umieść każdy obiekt wiadomości w tablicy messages. Kampania z 250 odbiorcami wymaga co najmniej trzech żądań, ponieważ każda partia mieści maksymalnie 100 elementów.
Bird waliduje każdy element przed dodaniem któregokolwiek do kolejki. Jedna nieprawidłowa wiadomość powoduje odrzucenie całego żądania z kodem 422. Napraw nieprawidłowy element przed ponownym wysłaniem partii.
Po pomyślnym przetworzeniu data zawiera zaakceptowane wiadomości w kolejności wysłania. summary.accepted_count podaje liczbę zaakceptowanych wiadomości. Dokumentacja partii opisuje tę odpowiedź.
Powiąż każdy zwrócony identyfikator wiadomości z jej odbiorcą. Późniejsze zdarzenia dostarczenia należą do tych indywidualnych wiadomości, a nie do jednego wspólnego wyniku partii.
Czy pomyślna partia oznacza, że wszyscy otrzymali wiadomość?
Odpowiedź 202 oznacza, że Bird zaakceptował wiadomości do przetworzenia.
Naliczanie opłat, przekazanie do operatora i dostarczenie następują później. Jedna zaakceptowana wiadomość może się nie powieść, podczas gdy inne dotrą do odbiorców. Aktualizuj kampanię na podstawie zdarzeń dostarczenia każdej wiadomości.
Nie wysyłaj ponownie całej zaakceptowanej partii z powodu niepowodzenia jednego odbiorcy. Zbadaj błąd tej wiadomości. Zdecyduj, czy osobna próba jest uzasadniona.
Jak oszacować czas wysyłki?
Szacuj każde miejsce docelowe osobno, uwzględniając limity i przepustowość odpowiednie dla danej ścieżki wysyłki.
Limit żądań API kontroluje, jak szybko wysyłasz pracę. Przepustowość dostarczenia kontroluje późniejszy etap. Zwiększenie współbieżności wysyłki nie usunie limitu operatora.
Sprawdź jednostkę przed obliczaniem przepustowości. Limit oparty na segmentach liczy wiadomość wieloczęściową więcej niż raz. Limit oparty na żądaniach liczy samo wywołanie partii.
Bird przypisuje żądania partii do sms_batch, oddzielnie od pojedynczych wysyłek w ramach sms_send. Przewodnik po limitach żądań wyjaśnia te polityki żądań. Przepustowość SMS wyjaśnia osobną kwestię dostarczenia.
Co sprawdzić przed uruchomieniem kampanii?
Sprawdź zgodę, kwalifikację nadawcy i gotową wiadomość dla każdego odbiorcy.
Używaj aktualnego stanu rezygnacji przy wysyłaniu zakolejkowanej pracy. Lista wyeksportowana wcześniej może zawierać osobę, która w międzyczasie wycofała zgodę.
Sprawdź wymagania dotyczące nadawcy dla danego miejsca docelowego przed grupowaniem jego odbiorców w partię. W przeciwnym razie jeden nieprawidłowy element może spowodować odrzucenie partii zawierającej wiele prawidłowych wiadomości.
Zacznij od ograniczonej grupy. Sprawdź zwrócone wyniki przed rozszerzeniem wysyłki. Dzięki temu łatwiej wychwycisz błędnego nadawcę lub wiadomość, zanim dotrą do całej listy.
- Zastosuj reguły miejsca docelowego i zgodę każdego odbiorcy.
- Zwaliduj gotowe treści wiadomości.
- Policz ich segmenty.
- Wysyłaj partie w ramach limitów żądań.
- Śledź wyniki dostarczenia dla każdej wiadomości. Badaj każde niepowodzenie osobno.
W skrócie
Każdy odbiorca nadal ma niezależną wiadomość.
Przyjęcie partii nie sprawia, że wszyscy odbiorcy współdzielą jeden wynik dostarczenia.
Partia Bird zawiera maksymalnie 100 wiadomości.
Używaj partii do niezależnych wysyłek API. Broadcast do odbiorców obsługuje skoordynowany przepływ kampanii.
Walidacja obejmuje całą partię.
Jeden nieprawidłowy element powoduje, że Bird odrzuca żądanie, zanim którykolwiek element trafi do kolejki.
Zgoda i kwalifikacja nadawcy pozostają indywidualnymi sprawdzeniami.
Sprawdź ponownie uprawnienia i wymagania dotyczące miejsca docelowego przy wysyłaniu każdej części kampanii.