„Your app is missing required Graph API permissions for Cloud API companion pairing”
Ten komunikat oznacza, że platforma, która uruchomiła rejestrację, nie ma uprawnień WhatsApp wymaganych przez Meta, na poziomie dostępu wymaganym przez Meta, aby połączyć numer z aplikacji WhatsApp Business z Cloud API. Meta pozwala firmie przyznać tylko te uprawnienia, dla których platforma ma Advanced access. Firma nie może tego naprawić, musi to zrobić platforma.
Czego partner potrzebuje dla każdego uprawnienia, zanim jego klienci będą mogli je przyznać przez Embedded Signup.
Błąd, który zwracają wywołania API, gdy whatsapp_business_management jest używane bez Advanced access na kontach, których aplikacja nie jest właścicielem.
whatsapp_business_management i whatsapp_business_messaging, dwa uprawnienia, których według Meta zwykle potrzebują integracje z WhatsApp.
Meta wymaga, aby platforma była już Solution Partner lub Tech Provider, jeśli ma wdrażać użytkowników aplikacji WhatsApp Business.
Co oznacza ten komunikat?
Pełna treść brzmi: „Your app is missing required Graph API permissions for Cloud API companion pairing. Please verify advanced WhatsApp Business permissions are granted, then try again.” Publiczne opisy błędów Meta nie zawierają dokładnie takiego sformułowania, ale każda jego część odpowiada czemuś, co Meta dokumentuje.
„Your app” to aplikacja Meta platformy, która prowadzi rejestrację, a nie aplikacja WhatsApp Business na telefonie. Meta nie definiuje publicznie pojęcia companion pairing. W tym kontekście opisuje ono dołączenie Cloud API do numeru, który pozostaje zarejestrowany w aplikacji WhatsApp Business, czyli układ Coexistence. Z kolei „advanced” WhatsApp Business permissions odnosi się do Advanced access, poziomu, który Meta przyznaje w ramach App Review.
Jakich uprawnień dotyczy błąd?
Dokumentacja uprawnień Meta wymienia dwa, których zwykle potrzebują integracje z WhatsApp. whatsapp_business_management obejmuje metadane konta, szablony, numery telefonów, analitykę i webhooki konta. whatsapp_business_messaging obejmuje wysyłanie wiadomości oraz odbieranie webhooków wiadomości i statusów.
Jeśli partner udostępnia swoją aplikację klientom, Meta wymaga App Review i Advanced access dla każdego uprawnienia, którego aplikacja potrzebuje. Meta wprost opisuje skutek: bez Advanced access dla danego uprawnienia klienci nie mogą go przyznać aplikacji przez Embedded Signup. Wywołania z whatsapp_business_management na kontach, których aplikacja nie jest właścicielem, wykonane bez Advanced access, zwracają błąd 200.
Platforma może sprawdzić, co firma faktycznie przyznała, analizując token za pomocą endpointu debug_token od Meta, który wymienia przyznane uprawnienia w polu scopes.
Co może zrobić firma?
Po swojej stronie bardzo niewiele i nie powinna zmieniać ustawień Meta, żeby usunąć ten błąd. Naprawa leży po stronie platformy: musi ona być Tech Provider lub Solution Partner, co Meta podaje jako wymóg wdrażania użytkowników aplikacji WhatsApp Business, oraz mieć zatwierdzony Advanced access dla uprawnień WhatsApp.
Firma może przesłać platformie dokładną treść komunikatu, a następnie ponowić próbę, gdy platforma potwierdzi swój dostęp, albo skorzystać z platformy, która ma już taki status. Wcześniejsze ponawianie tego samego procesu na tej samej platformie daje ten sam wynik i nie wpływa na aplikację WhatsApp Business na telefonie.
Typowe błędy
- Przyznawanie większej liczby uprawnień w ustawieniach Meta samej firmy. Brakujący dostęp dotyczy aplikacji platformy.
- Samodzielne hostowanie narzędzia w aplikacji deweloperskiej bez App Review. Bez Advanced access firmy nie mogą przyznać potrzebnych uprawnień.
- Wielokrotne ponawianie próby na tej samej platformie. Wynik zmieni się dopiero wtedy, gdy zmieni się dostęp tej platformy.
EasyCoexistence to niezależny Tech Provider w Meta z własną aplikacją Meta, który obsługuje Embedded Signup v4 dla Coexistence, więc firmy łączą swój numer przez platformę, która ma już dostęp wymagany przez Meta.
Najczęściej zadawane pytania
Czy coś jest nie tak z moją aplikacją WhatsApp Business?
Nie. Komunikat dotyczy aplikacji Meta platformy, a nie aplikacji na Twoim telefonie, która nadal działa.
Czy mogę sam przyznać to uprawnienie?
Do przyznania widzisz tylko te uprawnienia, dla których platforma ma Advanced access. Brakujący dostęp musi najpierw zostać zatwierdzony dla platformy.
Jak platforma uzyskuje Advanced access?
Przez Meta App Review dla każdego uprawnienia, którego potrzebuje jej aplikacja, jako partner, którego klienci korzystają z tej aplikacji.
Czy firma potrzebuje App Review?
Nie. Meta podaje, że deweloper, który korzysta tylko z danych własnej firmy, nie potrzebuje ani App Review, ani Advanced access.
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