Statusy wiadomości

Status	Znaczenie	Kredyt
queued	Przyjęta, czeka na wysyłkę	zarezerwowany
sending	Moduł wysyłki renderuje wiadomość i komunikuje się z dostawcą	zarezerwowany
sent	Dostawca przyjął wiadomość	zużyty
delivered	Dostawca potwierdził doręczenie na serwer odbiorcy (wymaga webhooków)	zużyty
bounced	Serwer odbiorcy odrzucił wiadomość; przy trwałym odbiciu (hard bounce) adres trafia na listę wykluczeń	zużyty
complained	Odbiorca oznaczył wiadomość jako spam; adres zostaje wykluczony	zużyty
failed	Trwały błąd albo błędy przejściowe wyczerpały wszystkie ponowne próby	zwrócony (nie, jeśli własny serwer SMTP mógł już przyjąć wiadomość, albo gdy nietypowo duża część wysyłek organizacji kończy się błędem)
held	Czeka na kredyty w kolejce wstrzymanych wiadomości	jeszcze żaden
held_service_error	Czeka na naprawę niedziałającej usługi	zwrócony, przy zwolnieniu rezerwowany ponownie
discarded	Usunięta z kolejki wstrzymanych – minął czas wstrzymania albo ktoś odrzucił ją ręcznie	żaden

Przy wysyłce API zwraca queued albo held. Wszystkie pozostałe statusy zobaczysz przez getStatus() / GET /v1/messages/:id, w Historii w panelu albo przez history() w Node SDK.

Typowe przebiegi

queued → sending → sent → delivered
queued → sending → sent → bounced
queued → sending → (retry …) → sent
queued → sending → (failover to fallback service) → sent
queued → sending → failed
held → (credits added) → queued → sending → sent
held → (hold duration over) → discarded
queued → sending → (auth error, no fallback) → held_service_error → (service fixed) → queued → …

Zdarzenia na osi czasu

Każda wiadomość ma oś czasu zdarzeń ze znacznikami czasu. Szczegóły wiadomości w Historii w panelu pokazują je z takimi etykietami:

Zdarzenie	Etykieta w Historii	Znaczenie
`held`	Wstrzymany	Wiadomość trafiła do kolejki wstrzymanych
`released`	Zwolniony	Wiadomość została zwolniona z kolejki wstrzymanych
`queued`	W kolejce	Czeka na wysyłkę
`sending`	Wysyłanie	Przekazana dostawcy
`sent`	Wysłany	Dostawca przyjął wiadomość
`failover`	Przełączono na usługę zapasową	Główna usługa zawiodła, użyto zapasowej
`retry`	Zaplanowano ponowną próbę	Błąd przejściowy, nastąpi kolejna próba
`auto_reply`	Utworzono automatyczną odpowiedź	Do tej wiadomości powstała automatyczna odpowiedź
`delivered`	Dostarczony	Doręczenie potwierdzone webhookiem
`bounced`	Odbity	Trwałe odbicie (status `bounced`) albo przejściowe odbicie (tylko zdarzenie, dostawca próbuje dalej)
`complained`	Oznaczony jako spam	Odbiorca złożył skargę
`opened` / `clicked`	Otwarty / Kliknięto link	Śledzenie otwarć i kliknięć od dostawcy
`failed`	Nieudany	Trwały błąd
`refunded`	Zwrócono kredyt	Zarezerwowany kredyt wrócił do swojej puli
`discarded`	Odrzucony	Wiadomość usunięta z kolejki wstrzymanych

opened i clicked to zdarzenia, nie statusy – doręczona wiadomość, która została otwarta, zostaje w statusie delivered. Śledzenie otwarć zależy od dostawcy i od tego, czy odbiorca załaduje obrazki, więc traktuj je jako szacunek.

Okres przechowywania

Wiadomości i ich wyrenderowana treść są przechowywane przez okres historii planu, na którym zostały wysłane (od 7 do 180 dni, zobacz Plany), a potem usuwane.