Błąd WhatsApp 131005: odmowa dostępu, brak uprawnienia
Błąd 131005 oznacza, że token dostępu nie ma uprawnienia, którego wymaga endpoint WhatsApp, ponieważ nigdy go nie nadano albo później je usunięto. Opis od Meta brzmi: „Permission is either not granted or has been removed.” Rozwiązanie: sprawdź token w narzędziu Access Token Debugger, a następnie nadaj brakujące uprawnienie albo użyj tokena, który je ma.
Kod Meta dla komunikatu „Permission is either not granted or has been removed.”
Uprawnienie potrzebne do wysyłania wiadomości dowolnego typu do użytkowników WhatsApp.
business_management, whatsapp_business_management i whatsapp_business_messaging, przypisywane podczas generowania tokena użytkownika systemowego.
Co oznacza błąd WhatsApp 131005?
Oznacza, że token został uznany za prawdziwy, ale nie ma uprawnienia, które sprawdza endpoint.
Dokumentacja Cloud API od Meta podaje kod 131005 z opisem „Permission is either not granted or has been removed.” Błąd 10 interfejsu Graph API ma identyczne zdanie. Różni je tylko zakres: 10 to ogólny kod Graph API, a 131005 należy do kodów WhatsApp zaczynających się od 131.
Skoro opis jest taki sam, diagnoza też jest taka sama. Meta zaleca w obu przypadkach użycie narzędzia Access Token Debugger i sprawdzenie, czy aplikacja ma uprawnienia wymagane przez endpoint.
Którego uprawnienia zwykle brakuje?
Zwykle jednego z dwóch uprawnień WhatsApp, a które to jest, zależy od tego, co robi wywołanie.
Przewodnik Meta po uprawnieniach dzieli je według zadań. whatsapp_business_messaging jest potrzebne do wysyłania wiadomości dowolnego typu oraz do odbierania webhooków wiadomości i statusów. whatsapp_business_management jest potrzebne do metadanych konta, zarządzania szablonami, listowania numerów telefonów, analityki i webhooków konta.
Token wygenerowany tylko z uprawnieniem do zarządzania może odczytać konto i wyświetlić szablony, a mimo to zawiedzie przy próbie wysłania. Przy generowaniu tokena użytkownika systemowego przewodnik Meta o tokenach dostępu każe przypisać razem business_management, whatsapp_business_management i whatsapp_business_messaging.
Jak naprawić błąd 131005?
Najpierw odczytaj token, potem zmień tylko to, czego brakuje.
Wywołaj endpoint debug_token albo wklej token do narzędzia Access Token Debugger. Właściwość scopes wymienia wszystkie nadane uprawnienia. Porównaj ją ze stroną dokumentacji endpointu, który zawiódł.
Jeśli brakuje uprawnienia, wygeneruj nowy token, który je zawiera, albo poproś właściciela firmy o ponowne nadanie go, gdy token pochodzi z przepływu partnerskiego. Jeśli wszystkie uprawnienia są obecne, a błąd nie znika, sprawdź, czy użytkownik systemowy stojący za tokenem ma dostęp do konkretnego konta „WhatsApp Business Account”, bo token może mieć pełne zakresy i mimo to nie być przypisany do tego zasobu.
Typowe błędy
- Zakładanie, że token wygasł. Wygaśnięcie zwraca 190 lub 0. Ten kod oznacza, że token działa, ale brakuje mu uprawnienia.
- Generowanie tokena tylko z uprawnieniem do zarządzania i używanie go do wysyłania. Wysyłanie wymaga whatsapp_business_messaging.
- Sprawdzenie zakresów i zatrzymanie się na tym. Użytkownik systemowy potrzebuje też dostępu do konkretnego konta „WhatsApp Business Account”.
EasyCoexistence podłącza każdy numer przez Embedded Signup od Meta, gdzie firma nadaje aplikacji uprawnienia, a jego konektor MCP raportuje stan numeru, więc asystent może to sprawdzić przed wysłaniem.
Najczęściej zadawane pytania
Czy 131005 to ten sam błąd co 10?
W dokumentacji Meta mają ten sam opis. 131005 należy do zakresu WhatsApp, a 10 do zakresu Graph API.
Czy uprawnienie można usunąć po konfiguracji?
Tak. Opis od Meta wprost obejmuje uprawnienia, które usunięto, a nie tylko te, których nigdy nie nadano.
Czy błąd 131005 wpływa na aplikację WhatsApp Business na telefonie?
Nie. Dotyczy tokena API. Aplikacja na telefonie działa jak dotąd.
Czy po błędzie 131005 warto ponowić próbę?
Nie. Ponowienie z tym samym tokenem da ten sam wynik. Najpierw napraw uprawnienie.
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