Raporty dostarczenia i statusy SMS

Raport dostarczenia — nazywany też delivery report albo DLR — to informacja zwrotna z sieci o tym, co stało się z Państwa wiadomością. Najważniejsze rozróżnienie: Sent oznacza, że wiadomość została przekazana operatorowi, a Delivered, że faktycznie dotarła na urządzenie. Tylko to drugie jest potwierdzeniem.

Poniżej opisujemy każdy kod statusu zwracany przez SMSBOX, jego znaczenie i to, co można z nim zrobić.

Wszystkie kody statusów i ich znaczenie

Kod Status Co oznacza Co z tym zrobić
10 Sent Wiadomość została przekazana do sieci operatora. Poczekać — to status przejściowy, a nie potwierdzenie dostarczenia.
11 Delivered Wiadomość dotarła na urządzenie odbiorcy. Nic. To status końcowy, który chcą Państwo widzieć.
12 Buffered Przyjęta, ale jeszcze niemożliwa do dostarczenia — urządzenie jest wyłączone albo poza zasięgiem. Poczekać. Sieć ponawia próby, dopóki trwa okres ważności.
13 Undelivered Sieć nie zdołała dostarczyć wiadomości, na przykład dlatego, że numer już nie istnieje. Prosimy sprawdzić numer. Jeśli zdarza się to często, warto wyczyścić listę masowym HLR.
14 Expired Okres ważności upłynął, a urządzenie nie stało się osiągalne. Wysłać ponownie w innym momencie albo oznaczyć numer jako nieaktywny.
15 Rejected Sieć odrzuciła wiadomość — na przykład z powodu niedozwolonej nazwy nadawcy albo treści ocenionej jako spam. Prosimy sprawdzić nadawcę i tekst. Nie należy powtarzać wysyłki: szkodzi to reputacji u operatora.
16 Unknown Sieć nie daje rozstrzygnięcia. Część operatorów zagranicznych po prostu nie dostarcza wiarygodnego raportowania. Nie należy traktować tego jako błędu. W razie wątpliwości prosimy sprawdzić numer osobno.
20 Blacklist Numer znajduje się na liście blokad i nie otrzymuje już od Państwa wiadomości — zwykle po rezygnacji. Prosimy usunąć numer ze swojej listy. Dalsza wysyłka kosztuje kredyty i nic nie daje.
21 LowBalance Za mało kredytów na koncie, aby wysłać wiadomość. Prosimy doładować albo włączyć automatyczne doładowanie i ostrzeżenie o saldzie.
01 Error Coś poszło nie tak przy przetwarzaniu wiadomości. Prosimy zajrzeć do dziennika trace po surowe żądanie i odpowiedź albo skontaktować się z pomocą techniczną, podając identyfikator wiadomości.

status końcowy, udany   status przejściowy albo nierozstrzygnięty   niedostarczone, potrzebne działanie

Droga, którą pokonuje Państwa wiadomość

1

Państwo wysyłają

Przez panel, import z Excela, e-mail albo REST API. Wiadomość dostaje unikalny identyfikator.

2

My przekazujemy

SMSBOX kieruje wiadomość do operatora odbiorcy. Status zmienia się na Sent.

3

Operator dostarcza

Gdy urządzenie jest wyłączone, wiadomość czeka w kolejce: Buffered.

4

Sieć odsyła informację

Przychodzi status końcowy: Delivered albo jeden z powyższych statusów błędu.

Między krokiem 2 a 4 może upłynąć trochę czasu. Wiadomość, która po kilku sekundach wciąż ma status Sent, nie zawiodła więc — czeka na informację zwrotną z sieci.

Statusy w Państwa własnym systemie

W panelu sprawdzają Państwo status przy każdej wysłanej wiadomości. Jeśli pracują Państwo przez API, nie trzeba o niego stale odpytywać: prosimy podać przy wysyłce adres URL powiadomienia, a my prześlemy każdą zmianę statusu żądaniem HTTP POST pod ten adres.

Ten POST zawiera identyfikator wiadomości i kod statusu z powyższej tabeli. Dzięki temu utrzymują Państwo własną bazę danych w aktualnym stanie i mogą od razu reagować — zadzwonić do klienta przy statusie Undelivered albo oznaczyć numer przy Blacklist.

Ustawianie webhooków Dokumentacja API
Przesyłanie statusów dostarczenia do Państwa systemu

Tak utrzymają Państwo wysoki wskaźnik dostarczeń

Większości nieudanych wiadomości da się zapobiec. Lista używana przez lata nieuchronnie zawiera numery, które już nie istnieją — a każda wysyłka do nich kosztuje kredyty bez żadnego rezultatu.

Prosimy sprawdzić listę wcześniej masowym HLR i usunąć martwe numery
Prosimy od razu przetwarzać każdą rezygnację, aby nie wysyłać dalej na listę blokad
Prosimy używać rozpoznawalnego nadawcy — anonimowe wiadomości są częściej odrzucane
Prosimy utrzymywać wystarczające saldo albo włączyć automatyczne doładowanie
Czyszczenie listy numerów Automatyczne doładowanie

Najczęściej zadawane pytania o raporty dostarczenia

Raport dostarczenia, nazywany też delivery report albo DLR, to zwrotna informacja z sieci o tym, co stało się z Państwa wiadomością. Mówi, czy wiadomość została przekazana dalej, czy faktycznie dotarła na urządzenie, czy też utknęła po drodze — i dlaczego.
Sent oznacza, że wiadomość została przekazana do sieci operatora. Delivered oznacza, że faktycznie dotarła na urządzenie odbiorcy. Tylko Delivered jest potwierdzeniem, że wiadomość osiągnęła swój cel.
Sieć przyjęła wiadomość, ale nie może jej jeszcze dostarczyć, zwykle dlatego, że urządzenie jest wyłączone albo poza zasięgiem. Wiadomość stoi przez pewien czas w kolejce i zostaje dostarczona, gdy tylko urządzenie znów będzie osiągalne. Jeśli nie uda się to w okresie ważności, status zmienia się na Expired.
Undelivered oznacza, że sieć nie zdołała dostarczyć wiadomości, na przykład dlatego, że numer już nie istnieje. Rejected oznacza, że sieć odrzuciła wiadomość, na przykład z powodu niedozwolonej nazwy nadawcy albo treści ocenionej jako spam. Przy powtarzających się statusach Undelivered Państwa lista numerów wymaga uporządkowania.
Numer znajduje się na liście blokad i nie otrzymuje już od Państwa wiadomości. Dzieje się tak na przykład wtedy, gdy ktoś się wypisał. Prosimy nie wysyłać dalej na takie numery: kosztuje to kredyty i szkodzi Państwa reputacji u operatorów.
Na Państwa koncie było za mało kredytów, aby wysłać wiadomość. Prosimy włączyć ostrzeżenie o saldzie albo automatyczne doładowanie, aby uniknąć zatrzymania kampanii w połowie.
Tak. Prosimy przy wysyłce podać adres URL powiadomień, a my wyślemy każdą zmianę statusu przez HTTP POST na ten adres, wraz z identyfikatorem wiadomości i kodem statusu. Dzięki temu utrzymują Państwo własną bazę na bieżąco, bez odpytywania.
Statusy pozostają widoczne przy wysłanych wiadomościach w panelu. Jeśli pracują Państwo przez API i chcą przy problemie sprawdzić także surowe żądania i odpowiedzi, znajdą je w tracelogu, który jest przechowywany trzydzieści dni.

Załóż bezpłatne konto

Załóż teraz bezpłatne konto i przetestuj panel sterowania!

Zadzwoń teraz
Wyślij e-mail