Sign inGet Started

Dziennik SMS

Dziennik SMS, widoczny na stronie Messages, to historia wiadomości Twojego obszaru roboczego i rejestr raportów dostarczenia (DLR). Wiadomości wychodzące i odpowiedzi przychodzące pojawiają się od najnowszych. Używaj go, aby potwierdzić wysyłkę, śledzić cykl dostarczania i sprawdzić liczbę segmentów, koszt oraz dane operatora. Zbiorcza strona Metrics pokazuje wskaźniki dla wielu wiadomości; dziennik SMS pozwala sprawdzić pojedynczą wiadomość. Strona zawiera też przycisk Send SMS do jednorazowych wysyłek z panelu.

Strona SMS Messages w panelu Bird: baner "Free-form SMS is in preview" nad nagłówkiem Messages, przycisk Send SMS, pole wyszukiwania dokładnego odbiorcy z kontrolkami Filters, Status i Date oraz ilustracja pustego stanu wyświetlana w miejscu tabeli wiadomości, zanim obszar roboczy cokolwiek wyśle

Lista wiadomości

Każdy wiersz to jedna wiadomość. Kolumny:

KolumnaCo pokazuje
StatusBieżący status dostarczenia wiadomości (zobacz Statusy)
FromNadawca: numer, identyfikator nadawcy lub krótki numer, z którego wysłano wiadomość
ToNumer odbiorcy
MessagePoczątek treści wiadomości (kliknij go lub dowolne miejsce w wierszu, aby otworzyć wiadomość)
CategoryKategoria wiadomości, wyświetlana jako krótka etykieta (TXN, MKTG, AUTH, SVC)
SentCzas przyjęcia wysyłki jako czas względny (najedź kursorem, aby zobaczyć dokładny znacznik czasu)

Lista jest podzielona na strony po 25 wiadomości; użyj Prev i Next, aby przechodzić między stronami.

Wyszukiwanie i filtrowanie

Dziennik wiadomości szybko się zapełnia, dlatego strona zaczyna się od wyszukiwania odbiorcy i czterech filtrów. Filtry łączą się: filtr statusu plus zakres dat zawęża wyniki do wiadomości spełniających oba warunki.

Wyszukiwanie po odbiorcy. Pole wyszukiwania dopasowuje dokładny numer odbiorcy w formacie E.164. Wpisz pełny numer, np. +31612345678, aby znaleźć każdą wiadomość zaadresowaną do niego. Wyszukiwanie nie dopasowuje fragmentów.

Status. Filtruj według jednego lub kilku statusów dostarczenia. Status obsługuje wielokrotny wybór, więc możesz np. wyświetlić wszystko, co nie dotarło, zaznaczając jednocześnie Undelivered, Failed i Expired. Opcje to statusy wymienione w sekcji Statusy.

Category. Filtruj według kategorii wiadomości: Transactional, Marketing, Authentication lub Service.

Direction. Filtruj według Outbound lub Inbound. Odpowiedzi na Twoje numery są przechowywane razem z wysyłkami, więc Inbound pokazuje to, co otrzymałeś.

Date. Filtruj według daty wysłania wiadomości; wybierz gotowy zakres lub ustaw własny z kalendarza.

Gdy kombinacja filtrów nie zwraca wyników, strona wyświetla stan braku wyników z akcją Clear filters, która przywraca pełną listę.

Statusy

Status wiadomości wskazuje, w którym miejscu cyklu dostarczania się ona znajduje. Wiadomość przechodzi od accepted w kierunku końcowego potwierdzenia.

StatusZnaczenie
AcceptedBird przyjął wiadomość i przygotowuje ją do przekazania operatorowi
SentPrzekazana operatorowi; oczekiwanie na potwierdzenie dostarczenia
DeliveredOperator potwierdził dostarczenie na urządzenie
UndeliveredTymczasowe niedostarczenie: urządzenie było wyłączone, nieosiągalne lub treść została zablokowana
FailedNiepowodzenie, które nie powinno ustąpić; późniejszy raport operatora nadal może je zastąpić
RejectedWiadomość została odrzucona (weryfikacja reguł, nieudane obciążenie lub odmowa operatora)
ExpiredOperator zakończył próby i zgłosił wiadomość jako wygasłą
ReceivedWiadomość przychodząca

Etykieta statusu wskazuje, czy wiadomość jest w trakcie wysyłki, dostarczona, odebrana czy nieudana. Nie polegaj wyłącznie na kolorze podczas przeglądania wyników.

Sprawdzanie wiadomości

Kliknij dowolny wiersz, aby otworzyć wiadomość w panelu bocznym. Panel ma dwie karty, Events i Details, a w nagłówku wyświetla treść wiadomości, bieżący status, odbiorcę i kategorię. Gdy wiadomość jest jeszcze w trakcie wysyłki, panel odświeża się co kilka sekund, więc zmiana statusu lub potwierdzenie dostarczenia pojawia się bez ręcznego przeładowania.

Events

Domyślna karta to oś czasu ze znacznikami czasu dla jednej wiadomości. Renderuje strumień opisany w sekcji zdarzenia SMS: Accepted, potem Sent, potem Delivered albo zdarzenie błędu (Undelivered, Failed, Rejected, Expired). Zdarzenia dostarczenia identyfikują operatora i MCC/MNC (sieć mobilną). Zdarzenia błędu pokazują opis błędu; karta Details zawiera kod błędu.

Details

Karta Details zawiera metadane wiadomości:

  • Message ID, Direction, From, To i Category
  • Segments: liczba jednostek do rozliczenia (jedna jednostka wiadomości dla MMS), kodowanie (GSM_7BIT, UCS2 lub MMS) i liczba znaków (zobacz segmenty i kodowanie)
  • Cost: kwota i waluta, po wycenie wiadomości
  • Carrier i MCC/MNC: sieć dostarczająca, jeśli jest znana
  • Znaczniki czasu Sent, Handed to carrier i Delivered
  • Error: opis i kod błędu dla wiadomości, która nie dotarła; zobacz błędy dostarczenia SMS, aby poznać znormalizowane przyczyny i numeryczne kody dostawców, w tym blokady ochrony przed nadużyciami
  • Tags i Metadata ustawione przy wysyłce

Większość pól można skopiować jednym kliknięciem.

Publiczny odczyt wiadomości i zdarzeń obejmuje ostatnie 30 dni. Starszy identyfikator wiadomości wykracza poza to okno odczytu; przechowuj rekordy potrzebne Twojej aplikacji zgodnie z własną polityką retencji i zgody.

Ten sam dziennik przez API

Lista stojąca za tą stroną to GET /v1/sms/messages, którego filtry obejmują status, kategorię, tag, dokładnego odbiorcę, okno czasowe oraz reference ustawione przy wysyłce. Pobierz oś czasu wiadomości za pomocą GET /v1/sms/messages/{message_id}/events. Odczytaj jej najnowszy stan za pomocą GET /v1/sms/messages/{message_id} lub odbieraj zdarzenia webhook na bieżąco.

Następne kroki

Zapoznaj się z analityką SMS, aby poznać szerszy proces raportowania, oraz z dwukierunkową komunikacją SMS, aby obsługiwać wiadomości przychodzące.

  • Metryki SMS: monitoruj zbiorczy współczynnik dostarczeń, współczynnik błędów i liczbę przyjętych wiadomości.
  • Zdarzenia SMS: zapoznaj się ze słownikiem zdarzeń stojącym za osią czasu.
  • Wysyłanie SMS: zbuduj ładunek wysyłki z kategoriami, tagami i metadanymi.

Przejdź do dokumentacji, przewodników i przykładów dotyczących tego tematu.