Błąd WhatsApp 3: problem z możliwościami lub uprawnieniami
Kod błędu 3 oznacza, że aplikacji wywołującej endpoint brakuje możliwości lub uprawnienia, którego ten endpoint wymaga. Meta opisuje go jako „Capability or permissions issue.”. Graph API nazywa go API Method. Rozwiązanie polega na sprawdzeniu przyznanych uprawnień tokenu w Access Token Debugger i dodaniu tego, którego potrzebuje endpoint.
Kod Meta dla „Capability or permissions issue.”
Nazwa, jaką przewodnik po obsłudze błędów Graph API nadaje kodowi 3.
whatsapp_business_management i whatsapp_business_messaging, czyli dwa uprawnienia, których wymaga większość endpointów WhatsApp.
Co oznacza kod błędu WhatsApp 3?
Oznacza on, że żądanie zostało uwierzytelnione, ale aplikacja nie ma prawa zrobić tego, o co poprosiła.
Meta wymienia kod 3 wśród błędów autoryzacji w dokumentacji Cloud API z tekstem szczegółów „Capability or permissions issue.”. Przewodnik po obsłudze błędów Graph API, z którego korzysta Cloud API, nazywa ten sam kod API Method i zaleca upewnić się, że aplikacja ma możliwości lub uprawnienia potrzebne do wywołania.
Token więc działa. Tożsamość nie jest problemem, i to odróżnia ten kod od kodów 0 i 190. Problemem jest to, do czego token ma dostęp.
Jak sprawdzić, jakie uprawnienia ma token?
Za pomocą Access Token Debugger albo endpointu debug_token, który zwraca te same informacje.
Odpowiedź zawiera listę przyznanych uprawnień we właściwości scopes. Porównaj tę listę ze stroną dokumentacji endpointu, który zawiódł, ponieważ każda z nich podaje wymagane uprawnienia.
W WhatsApp prawie wszystko obsługują dwa uprawnienia. whatsapp_business_management jest potrzebne do metadanych konta, szablonów, list numerów telefonów, analityki i webhooków konta. whatsapp_business_messaging jest potrzebne do wysyłania każdej wiadomości oraz do odbierania webhooków wiadomości i statusów. Token z tylko jednym z nich zawiedzie przy wywołaniach wymagających drugiego.
Dlaczego aplikacja partnera widzi błąd 3, a samodzielny deweloper nie?
Ponieważ partnerzy obsługujący inne firmy mają dodatkową bramkę.
Przewodnik Meta po uprawnieniach mówi, że partner, którego klienci korzystają z jego aplikacji, by uzyskać dostęp do swoich danych, musi przejść App Review i mieć Advanced access do każdego uprawnienia potrzebnego aplikacji. Deweloper pracujący wyłącznie na danych własnej firmy nie potrzebuje App Review ani Advanced access.
Ten sam kod może więc działać bez zarzutu na koncie dewelopera, a zawodzić na koncie klienta. Gdy widzisz taki wzorzec, pytanie nie brzmi, którego uprawnienia brakuje tokenowi, tylko czy aplikacja została zatwierdzona do używania go na zasobach, których nie jest właścicielem.
Typowe błędy
- Generowanie nowego tokenu z tymi samymi zakresami. Świeży token z tymi samymi uprawnieniami zawiedzie w tym samym miejscu.
- Sprawdzanie nazwy uprawnienia w ustawieniach aplikacji zamiast na tokenie. Liczy się to, co zostało przyznane tokenowi.
- Testowanie tylko na własnym koncie. Aplikacje partnerów potrzebują Advanced access, zanim konta klientów zaakceptują wywołanie.
EasyCoexistence łączy każdy numer przez własny proces Embedded Signup firmy Meta, więc firma przyznaje uprawnienia podczas wdrożenia, a stan połączenia pozostaje potem widoczny w panelu.
Najczęściej zadawane pytania
Czy błąd 3 oznacza problem z moim numerem telefonu?
Nie. Dotyczy tego, co wolno tokenowi aplikacji. Numer nie jest sprawdzany, zanim żądanie zostanie odrzucone.
Jaka jest różnica między błędem 3 a błędem 10?
Kod 3 to problem z możliwościami lub uprawnieniami. Kod 10 oznacza, że uprawnienie nie zostało przyznane lub zostało usunięte. Oba rozwiązuje sprawdzenie zakresów tokenu.
Którego uprawnienia potrzebuję do wysyłania wiadomości?
whatsapp_business_messaging. Przewodnik Meta po uprawnieniach podaje, że jest wymagane do wysyłania wiadomości każdego typu.
Czy ponowna próba pomoże?
Nie. Uprawnienia tokenu nie zmieniają się między próbami, więc wynik będzie taki sam.
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