Wiadomość WhatsApp API nie dociera: przyczyny w kolejności sprawdzania
Przyjęta przez WhatsApp API wiadomość nie jest dostarczona: Meta podaje wynik później, w webhooku statusu, jako wysłana (sent), dostarczona (delivered), przeczytana (read) lub nieudana (failed), z kodem błędu. Sprawdź po kolei: status nieudany i jego kod, 24-godzinne okno (131047), metodę płatności (131042), szablon (132001, 132015), odbiorcę (131026, 131049, 131050), a potem limity numeru i połączenie.
easyCoexistence monitoruje każdy połączony numer całą dobę, wysyła Ci e-mail, gdy Meta przestaje dostarczać, odłącza połączenie lub obniża jakość, i przekazuje webhooki statusów Meta bez zmian do Twojego systemu.
sent (jeden znacznik), delivered (dwa), read (dwa niebieskie) i failed (czerwony trójkąt z błędem), tak jak raportują je webhooki statusu.
Od ostatniej wiadomości klienta minęło ponad 24 godziny; Meta zaleca wysłać szablon.
Nie można dostarczyć: numer nie korzysta z WhatsApp, odbiorca nie zaakceptował nowych warunków albo używa starej wersji WhatsApp.
Domyślny czas, przez jaki WhatsApp ponawia niedostarczony szablon użytkowy lub marketingowy, zanim go porzuci; szablony uwierzytelniające domyślnie 10 minut.
Stała przepustowość numeru używanego zarówno w aplikacji WhatsApp Business, jak i w Cloud API.
Dlaczego przyjęta wiadomość mimo to nie dociera?
Ponieważ odpowiedź API i dostarczenie to dwa osobne zdarzenia. Gdy wysyłasz, Meta zwraca identyfikator wiadomości (id) od razu po przyjęciu żądania; to, czy wiadomość trafi na telefon klienta, pojawia się później, w webhooku statusu w polu messages. sent oznacza, że opuściła serwery Meta (jeden znacznik), delivered, że dotarła do urządzenia (dwa znaczniki), read, że została otwarta (dwa niebieskie), a failed, że nie udało się jej wysłać ani dostarczyć. Wynik pokazywany jest w tablicy errors: code, title i error_data.details. Dlatego pierwszy krok to nigdy nie zgadywanie: znajdź status failed dla tego identyfikatora i przeczytaj jego kod. Jeśli nie masz adresu docelowego webhooka, nic tego nie zapisuje.
Jakie są przyczyny, w kolejności sprawdzania?
Od najczęstszych przy nowo połączonym numerze do najrzadszych. Każda linia podaje kod Meta, więc status failed mówi, w której jesteś:
- Okno zamknięte: 131047, minęło ponad 24 godziny od ostatniej wiadomości klienta. Wiadomości w dowolnej formie wymagają otwartego okna; wyślij szablon.
- Płatność: 131042 albo szablony po cichu porzucone. Od 1 października 2026 r. wiadomości usługowe również przestają działać po wykorzystaniu 1 000 miesięcznie bez metody płatności.
- Szablon: 132001 niezatwierdzony lub w złym języku, 132000 zła liczba zmiennych, 132012 zły format, 132015 wstrzymany, 132016 wyłączony.
- Odbiorca: 131026 nie korzysta z WhatsApp, ma starą wersję albo nie zaakceptował warunków; 131050 wstrzymał wiadomości marketingowe; 131049 wstrzymanie wiadomości w celu utrzymania zdrowego zaangażowania; szablony marketingowe do numerów w USA nie są dostarczane.
- Limity: 131048 ograniczenie po sygnałach spamu, 131056 zbyt wiele wiadomości do jednej osoby, 130429 przepustowość: 20 wiadomości na sekundę przy numerze Coexistence.
- Konto: 131031 lub 368, konto WhatsApp Business ograniczone albo wyłączone za naruszenie zasad.
- Połączenie: numer nie jest już podłączony, na przykład po 14 dniach bez otwarcia aplikacji WhatsApp Business.
Jak obsługiwać kody po stronie odbiorcy?
Inaczej, bo niektóre zasługują na ponowną próbę, a inne nigdy. 131050 oznacza, że osoba zdecydowała się nie otrzymywać od Ciebie wiadomości marketingowych: Meta zaleca nie ponawiać, a webhook user_preferences informuje, kiedy osoba przestaje je otrzymywać lub wznawia. 131049 to wstrzymanie przez Meta wiadomości marketingowej, by utrzymać zdrowe zaangażowanie, często limit szablonów marketingowych na użytkownika: Meta radzi odczekać co najmniej 24 godziny przed ponownym wysłaniem, bo wcześniejsze wysłanie tylko zwróci ten sam błąd. 131026 dotyczy numerów spoza WhatsApp, użytkowników, którzy nie zaakceptowali aktualnych warunków WhatsApp, i bardzo starych wersji aplikacji; najpierw sprawdź format numeru i kod kraju, a potem zapytaj klienta innym kanałem.
Jak długo WhatsApp próbuje dostarczyć?
Przez czas, w którym wiadomość jest ważna (TTL). Gdy telefon jest wyłączony lub poza zasięgiem, WhatsApp ponawia dostarczenie zamiast od razu zawieść: domyślnie przez 30 dni dla szablonów użytkowych i marketingowych oraz 10 minut dla szablonów uwierzytelniających. Firma może skrócić to dla każdego szablonu parametrem message_send_ttl_seconds: od 30 sekund do 12 godzin dla użytkowych i od 30 sekund do 15 minut dla uwierzytelniających. Wiadomość, której nie da się dostarczyć w czasie TTL, zostaje porzucona. Dlatego wiadomość ze statusem sent i bez delivered po wielu godzinach zwykle czeka na telefonie klienta, a nie zginęła. Ustaw krótki TTL dla kodów weryfikacyjnych i powiadomień o krytycznym czasie, aby późne dostarczenie nikogo nie zmyliło.
Co to znaczy dla odpowiedzi AI i automatyzacji?
Najpierw przeczytaj przebieg, potem status. W zakładce Runs przebieg Skipped nic nie wysłał i podaje powód: „Minęło ponad 24 godziny od ostatniej wiadomości klienta”, „Niedawno odpowiedziano na ten czat z telefonu” albo „Osiągnięto limit odpowiedzi AI dla tego czatu w tej godzinie”. Przebieg Done oznacza, że Meta przyjęła każdą odpowiedź, co nie jest dowodem dostarczenia. easyCoexistence nie przechowuje statusów wiadomości: przy włączonych automatyzacjach trafiają na adres URL do przekazywania, jeśli go ustawisz, a w trybie bezpośrednim idą prosto na Twój własny endpoint. Z ChatGPT lub Claude poproś AI o get_number_health: zwraca bieżący status, ocenę jakości i ostatnie 15 zdarzeń monitorowania, w tym blok sending z kodem Meta.
Jak to skonfigurować
- Find the statusLook up the message id in your webhook log and read the latest status: delivered, read, sent only, or failed with an error code.
- Match the codeLook up the failed status's code in the list of causes above and in Meta's error codes reference.
- Check the accountConfirm the WhatsApp Business Account has a default payment method, a currency and a time zone in Billing & payments.
- Check the templateIf it was a template, confirm it is APPROVED in that language and the variables match its definition.
- Check the numberAsk your AI to run get_number_health, or open the number in the dashboard, to see the connection and any sending block.
Typowe błędy
- Ponawianie po 131050. Osoba przestała otrzymywać od Ciebie wiadomości marketingowe; kolejne próby nigdy nie zostaną dostarczone i mogą jedynie dodać negatywne sygnały.
- Uznanie identyfikatora wiadomości za dostarczoną. Meta najpierw przyjmuje, a potem raportuje błędy, więc przepływ kończący się na identyfikatorze pomija każdą odrzuconą wiadomość.
- Wysłanie odpowiedzi w dowolnej formie dzień później. Po 24 godzinach bez wiadomości klienta przyjmowany jest wyłącznie szablon.
- Działanie bez adresu webhooka. Nieudane statusy docierają wyłącznie jako webhooki, więc bez niego powód, dla którego wiadomość nie dotarła, przepada.
Twoja AI może sprawdzić numer z ChatGPT lub Claude przez get_number_health. Od US$ 9 do US$ 0,75 za numer miesięcznie, spadając wraz z liczbą numerów, z bezpłatnym okresem próbnym na 3 dni.
Najczęściej zadawane pytania
Dlaczego wiadomość przez godziny pokazuje jeden znacznik?
Jeden znacznik to status sent: Meta ją wysłała, ale telefon jej nie odebrał, zwykle dlatego, że jest wyłączony lub offline. WhatsApp ponawia, aż upłynie czas życia szablonu, domyślnie 30 dni dla użytkowych i marketingowych.
Dlaczego odpowiedzi docierają, a szablony nie?
Zwykle chodzi o problem z metodą płatności na koncie WhatsApp Business. Meta dostarcza wiadomości usługowe w ramach bezpłatnego miesięcznego limitu numeru nawet bez niej, ale nie dostarcza szablonów. Dodaj kartę w Billing & payments.
Czy mogę zobaczyć nieudane wiadomości w aplikacji WhatsApp Business?
Nie zawsze. Przy numerze Coexistence wiadomości wysłane przez API pojawiają się w wątku czatu w aplikacji, ale powód niepowodzenia podaje tylko kod błędu w webhooku statusu.
Czy Meta pobiera opłatę za niedostarczone wiadomości?
Nie. Meta pobiera opłatę tylko za dostarczone wiadomości, a próby z wstrzymanym szablonem również nie są rozliczane.
Czytaj dalej
Gotowy, aby zacząć?
Skonfiguruj WhatsApp Coexistence w kilka minut, nie miesięcy. Aplikacja nadal działa na telefonie.
Rozpocznij bezpłatny okres próbnyZweryfikowano w