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

Błąd 131060: nieobsługiwana wiadomość na numerze Coexistence

Błąd 131060 przychodzi w webhooku wiadomości jako wiadomość typu unsupported o tytule „This message is currently unavailable.”. Na numerze Coexistence Meta uznaje go za oczekiwany: pojawia się przede wszystkim wtedy, gdy ktoś po raz pierwszy pisze do firmy, często zaraz po kliknięciu reklamy Click-to-WhatsApp, i zwykle znika w ciągu kilku sekund. Sama wiadomość jest czytelna w aplikacji WhatsApp Business.

easyCoexistence trzyma nieobsługiwane wiadomości poza automatyzacjami, więc Twoja AI nigdy nie odpowiada na wiadomość, której nie potrafi odczytać, a gdy ustawiono Forward URL, nadal przekazuje oryginalny payload Meta do Twojego systemu.

131060

Kod Meta dla przychodzącej wiadomości, która jest obecnie niedostępna, o tytule „This message is currently unavailable.”

Seconds

Meta podaje, że błąd zwykle ustępuje w ciągu kilku sekund, po czym WhatsApp dostarcza wiadomości normalnie.

First contact

Główny scenariusz wskazany przez Meta: użytkownik WhatsApp pisze do firmy po raz pierwszy, często zaraz po kliknięciu reklamy Click-to-WhatsApp.

131051

Inny kod w tym samym webhooku: Cloud API w ogóle nie obsługuje tego typu wiadomości.

Skipped

Automatyzacje easyCoexistence nie uruchamiają się przy nieobsługiwanej wiadomości; uruchamia je następna czytelna wiadomość z tego czatu.

Co zawiera webhook 131060?

To zwykły webhook wiadomości, którego wiadomość ma `type`: `unsupported` oraz tablicę `errors`. Błąd niesie kod 131060 i tytuł „This message is currently unavailable.”, z tym samym zdaniem jako komunikatem. Obiekt unsupported wskazuje rodzaj treści, którego Meta nie mogła przekazać; lista wartości Meta obejmuje image, interactive, reaction i poll_creation. Brak tu treści tekstowej i identyfikatora mediów, więc z payloadu nie wynika, co napisał klient. Numer nadawcy, identyfikator wiadomości i znacznik czasu są obecne jak zwykle.

messages webhook with error 131060 (shape from Meta's reference, values illustrative)
{
  "object": "whatsapp_business_account",
  "entry": [{
    "id": "<WABA_ID>",
    "changes": [{
      "field": "messages",
      "value": {
        "messaging_product": "whatsapp",
        "metadata": {
          "display_phone_number": "<BUSINESS_NUMBER>",
          "phone_number_id": "<PHONE_NUMBER_ID>"
        },
        "contacts": [{ "profile": { "name": "Ana" }, "wa_id": "5511999998888" }],
        "messages": [{
          "from": "5511999998888",
          "id": "wamid.HBgN...",
          "timestamp": "1762876800",
          "type": "unsupported",
          "errors": [{
            "code": 131060,
            "title": "This message is currently unavailable.",
            "message": "This message is currently unavailable."
          }],
          "unsupported": { "type": "<UNSUPPORTED_TYPE>" }
        }]
      }
    }]
  }]
}

Dlaczego to dzieje się na numerze Coexistence?

Przewodnik Meta po Coexistence mówi, że partnerzy „mogą otrzymać webhook wiadomości unsupported z kodem błędu 131060” i że jest to zjawisko oczekiwane. Wskazuje dwa scenariusze.

Pierwszy to użytkownik WhatsApp, który pisze do firmy po raz pierwszy. Meta podkreśla, że jest to szczególnie częste, gdy ktoś kliknie reklamę Click-to-WhatsApp i od razu wyśle wiadomość. Drugi to użytkownik WhatsApp na nieobsługiwanym urządzeniu towarzyszącym, który wysyła wiadomość do firmy lub ją od niej odbiera.

Meta nie wyjaśnia mechanizmu. Ważniejsze jest to, co mówi: błąd zwykle ustępuje w ciągu kilku sekund, a potem WhatsApp dostarcza wiadomości normalnie.

Co powinna zrobić firma, gdy taka wiadomość przyjdzie?

Przeczytać ją w aplikacji. Meta zaleca platformom, by informowały firmę o konieczności sprawdzenia wiadomości w aplikacji WhatsApp Business, ponieważ aplikacja na telefonie ma ją nawet wtedy, gdy wersja w API była niedostępna.

W praktyce: otwórz czat na telefonie, przeczytaj, co napisał klient, i odpowiedz stamtąd, albo poczekaj na kolejną wiadomość klienta, która zwykle przychodzi przez API bez błędu. Odpowiedź z telefonu informuje też automatyzacje, że czat prowadzi człowiek. Przy kampanii reklamowej spodziewaj się małej serii takich zdarzeń na początku nowych rozmów, a nie usterki.

Jak Twoje oprogramowanie i Twoja AI mają to obsłużyć?

Traktuj to jako znane zdarzenie, a nie jako awarię. Potwierdź webhook kodem 200, jak każdą dostawę, żeby Meta nie wysyłała go ponownie. Zapisz identyfikator wiadomości i nadawcę, co pozwoli powiązać go z późniejszą rozmową. Nigdy nie przekazuj pustej wiadomości AI jak tekstu: bez treści każda odpowiedź byłaby zgadywaniem. I ustawiaj alert na częstotliwość zdarzeń 131060, a nie na pojedyncze.

  • Zwracaj 200 szybko i deduplikuj po identyfikatorze wiadomości, jak przy każdym webhooku.
  • Pomijaj odpowiedzi AI i dopasowywanie słów kluczowych dla typu unsupported.
  • Pokaż zespołowi, że wiadomość czeka w aplikacji na telefonie.
  • Licz 131060 osobno od prawdziwych błędów w panelach.

Czy automatyzacje uruchamiają się przy nieobsługiwanej wiadomości?

W easyCoexistence nie. Automatyzacje odczytują tekst, odpowiedzi przyciskami i listami, podpisy mediów oraz symbole zastępcze, np. „[voice message]”. Wiadomość typu unsupported nie ma żadnego z nich, więc żadna automatyzacja jej nie obsłuży i nie pojawia się żadne uruchomienie. Jeśli ustawiono Forward URL, Twój system nadal dostaje oryginalny payload Meta, łącznie z błędem. W trybie bezpośrednim Meta wysyła go prosto na Twój serwer.

Następna czytelna wiadomość tej osoby uruchamia automatyzacje jak zwykle. Ponieważ dla tego czatu nic jeszcze nie zapisano, automatyzacja „First message”, np. powitalna odpowiedź, odpowiada właśnie na tę kolejną wiadomość.

Czym różni się 131060 od 131051?

Oba przychodzą jako typ unsupported w tym samym webhooku wiadomości, dlatego łatwo je pomylić w logach. Dla planowania znaczą co innego: jeden to krótka przerwa, która sama się naprawia, a drugi to trwałe ograniczenie API dla danej treści. W swoim handlerze odróżniaj je po `errors[0].code`, a nie po typie. Tabela zestawia to, co referencje Meta mówią o każdym kodzie.

131060131051
TitleThis message is currently unavailable.Message type unknown
MeaningThe message cannot be passed on right nowThe Cloud API does not support that type
Typical causeFirst contact on a Coexistence number, often after an ad tapContent the API never delivers
How longUsually clears within secondsPermanent for that content
What to doRead it in the WhatsApp Business appAsk the customer for text, or read it in the app

Typowe błędy

  • Alarmowanie przy pojedynczych zdarzeniach 131060. Meta nazywa je oczekiwanymi na numerach Coexistence; obserwuj częstotliwość.
  • Pozwalanie AI odpowiadać na pustą wiadomość. Payload nie ma tekstu, więc odpowiedź byłaby wymyślona.
  • Odpowiadanie na webhook kodem błędu. Meta ponawia nieudane webhooki, więc jedna nieobsługiwana wiadomość staje się kilkoma dostawami.
  • Zakładanie, że wiadomość przepadła. Jest w aplikacji WhatsApp Business; niedostępna była tylko kopia w API.
Z EasyCoexistence zrobisz to

Numer pozostaje w aplikacji na telefonie, gdzie można przeczytać oryginalną wiadomość. Od US$ 9 do US$ 0,75 za numer miesięcznie, spadając wraz z dodawaniem numerów, z pierwszymi 3 dniami bezpłatnie.

Najczęściej zadawane pytania

Czy mogę pobrać oryginalną treść przez API?

Wskazówki Meta dotyczące 131060 mówią, by sprawdzić aplikację WhatsApp Business. Jej referencja webhooków nie opisuje sposobu późniejszego pobrania treści.

Czy 131060 oznacza, że numer jest uszkodzony?

Nie. Jeśli wiadomości od zwykłych kontaktów przez godziny nadal przychodzą jako 131060, poproś AI o uruchomienie get_number_health lub sprawdzenie połączenia. Serie przy pierwszym kontakcie są jednak oczekiwane.

Czy zdarza się to na numerach korzystających tylko z Cloud API?

Meta opisuje wzorzec pierwszego kontaktu w przewodniku dla numerów wdrożonych przez aplikację WhatsApp Business, czyli właśnie Coexistence. Sam kod znajduje się w ogólnej referencji webhooków Meta, więc obsługuj go tak samo na każdym numerze.

Czy za to się płaci?

To wiadomość przychodząca. Meta pobiera opłaty od firmy za wysyłane przez nią wiadomości, za każdą wiadomość, według kategorii i kraju, na jej własnym koncie WhatsApp Business.

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