Zaloguj sięRozpocznij bezpłatny okres próbny
Meta Tech Provider

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.

4 statuses

sent (jeden znacznik), delivered (dwa), read (dwa niebieskie) i failed (czerwony trójkąt z błędem), tak jak raportują je webhooki statusu.

131047

Od ostatniej wiadomości klienta minęło ponad 24 godziny; Meta zaleca wysłać szablon.

131026

Nie można dostarczyć: numer nie korzysta z WhatsApp, odbiorca nie zaakceptował nowych warunków albo używa starej wersji WhatsApp.

30 days

Domyślny czas, przez jaki WhatsApp ponawia niedostarczony szablon użytkowy lub marketingowy, zanim go porzuci; szablony uwierzytelniające domyślnie 10 minut.

20 mps

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ć

  1. 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.
  2. Match the codeLook up the failed status's code in the list of causes above and in Meta's error codes reference.
  3. Check the accountConfirm the WhatsApp Business Account has a default payment method, a currency and a time zone in Billing & payments.
  4. Check the templateIf it was a template, confirm it is APPROVED in that language and the variables match its definition.
  5. 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.
Z EasyCoexistence zrobisz to

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óbny

Zweryfikowano w