Błąd WhatsApp 10: uprawnienie nie zostało nadane lub zostało cofnięte
Kod błędu 10 oznacza, że token aplikacji nie ma uprawnienia wymaganego przez endpoint: albo nigdy go nie nadano, albo zostało cofnięte. Opis Meta brzmi: „Permission is either not granted or has been removed”. Meta wymienia też dwie przyczyny specyficzne dla WhatsApp: numer spoza listy dozwolonych we Flows with Endpoint oraz niespełnienie wymagań kwalifikowalności danego API.
Kod Meta dla komunikatu „Permission is either not granted or has been removed”.
Nazwa, którą przewodnik po obsłudze błędów Graph API nadaje kodowi 10.
To, czego aplikacja partnerska potrzebuje dla każdego uprawnienia używanego na kontach klientów.
Co oznacza kod błędu 10 w WhatsApp?
Oznacza, że token dotarł do Meta i został rozpoznany, ale uprawnienia wymaganego przez wywołanie na nim nie ma.
W dokumentacji Cloud API kod 10 ma opis „Permission is either not granted or has been removed”. Przewodnik po obsłudze błędów Graph API nazywa go API Permission Denied i zaleca obsłużenie brakującego uprawnienia.
Słowo „removed” jest ważne. Uprawnienie można nadać przy konfiguracji i odebrać później, na przykład gdy ktoś cofnie aplikacji dostęp w Ustawieniach firmy. Dlatego integracja, która działała miesiącami, może zacząć zwracać kod 10 bez żadnej zmiany we własnym kodzie.
Jakie inne przyczyny błędu 10 podaje Meta?
Dwie, specyficzne dla WhatsApp. Łatwo je przeoczyć, bo w ogóle nie dotyczą zakresów uprawnień.
W przypadku WhatsApp Flows with Endpoint Meta zaleca sprawdzić, czy numer telefonu użyty do ustawienia klucza publicznego firmy znajduje się na liście dozwolonych. Numer spoza tej listy powoduje ten kod, nawet jeśli token ma wszystkie uprawnienia.
Meta podaje też, że konto, które nie spełnia wymagań kwalifikowalności dla wywoływanego API, otrzymuje ten kod. Wtedy żadna zmiana tokenu nie pomoże, bo barierą jest kwalifikowalność konta, a nie poświadczenie.
Jak naprawić błąd 10?
Zacznij od narzędzia Access Token Debugger, które Meta wskazuje jako pierwszy krok.
Jeśli na liście zakresów brakuje uprawnienia potrzebnego endpointowi, poproś firmę o ponowne jego nadanie. W aplikacji partnerskiej oznacza to także potwierdzenie dostępu Advanced dla tego uprawnienia, ponieważ przewodnik Meta po uprawnieniach wymaga go dla kont klientów.
Jeśli zakresy wyglądają na kompletne, sprawdź dwie przyczyny specyficzne dla WhatsApp. Przy wywołaniu Flows sprawdź listę dozwolonych dla numeru, który ustawił klucz publiczny. W każdym innym przypadku przeczytaj wymagania kwalifikowalności dla wywoływanego API i upewnij się, że konto je spełnia, zanim zmienisz jakiekolwiek poświadczenie.
Typowe błędy
- Zakładanie, że integrację zepsuło wdrożenie. Uprawnienie cofnięte w Ustawieniach firmy powoduje ten kod bez żadnej zmiany w kodzie.
- Odtwarzanie tokenu, gdy przyczyną jest kwalifikowalność. Poświadczenie nie sprawi, że konto niekwalifikujące się zacznie się kwalifikować.
- Pomijanie listy dozwolonych we Flows. We Flows with Endpoint numer spoza niej zwraca kod 10 nawet przy pełnych zakresach.
EasyCoexistence monitoruje każdy podłączony numer także po onboardingu, więc połączenie, które traci dostęp, pojawia się w panelu, a nie dopiero jako nieudane wysyłki.
Najczęściej zadawane pytania
Czy błąd 10 to to samo co błąd 131005?
Oba mają ten sam opis w dokumentacji Meta. Kod 10 jest kodem Graph API, a 131005 należy do zakresu WhatsApp. Sprawdza się je w taki sam sposób.
Czy błąd 10 może pojawić się na numerze, który działał wczoraj?
Tak. Opis Meta obejmuje uprawnienia, które zostały cofnięte, więc dostęp nadany wcześniej można wycofać później.
Czy błąd 10 oznacza, że mój token wygasł?
Nie. Wygasły token to kod 190 lub 0. Kod 10 oznacza, że token jest ważny, ale brakuje mu uprawnienia.
Jak sprawdzić, jakie uprawnienia zostały nadane?
Wywołaj debug_token lub otwórz Access Token Debugger. Właściwość scopes zawiera listę wszystkich uprawnień tokenu.
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