Eroarea WhatsApp 3: problemă de capabilitate sau permisiuni
Codul de eroare 3 înseamnă că aplicației care apelează endpoint-ul îi lipsește o capabilitate sau o permisiune pe care acel endpoint o cere. Descrierea Meta este „Capability or permissions issue." Graph API îi spune API Method. Soluția este să inspectați permisiunile acordate token-ului cu access token debugger și să adăugați permisiunea de care are nevoie endpoint-ul.
Codul Meta pentru „Capability or permissions issue."
Numele pe care ghidul de gestionare a erorilor din Graph API îl dă codului 3.
whatsapp_business_management și whatsapp_business_messaging, cele două de care au nevoie cele mai multe endpoint-uri WhatsApp.
Ce înseamnă codul de eroare 3 din WhatsApp?
Înseamnă că cererea a fost autentificată, dar aplicația nu are voie să facă ceea ce a cerut.
Meta listează codul 3 printre erorile de autorizare din referința Cloud API, cu textul de detalii „Capability or permissions issue." Ghidul de gestionare a erorilor din Graph API, pe care Cloud API îl moștenește, numește același cod API Method și recomandă să vă asigurați că aplicația are capabilitatea sau permisiunile necesare apelului.
Deci token-ul funcționează. Identitatea nu este problema, și tocmai asta diferențiază eroarea de codurile 0 și 190. Problema este ce are voie să atingă token-ul.
Cum verificați ce permisiuni are un token?
Cu access token debugger sau cu endpoint-ul debug_token, care returnează aceleași informații.
Răspunsul listează permisiunile acordate în proprietatea scopes. Comparați lista cu pagina de referință a endpoint-ului care a eșuat, deoarece fiecare referință precizează permisiunile pe care le cere.
Pentru WhatsApp, două permisiuni acoperă aproape tot. whatsapp_business_management este necesară pentru metadatele contului, template-uri, lista numerelor de telefon, statistici și webhook-urile contului. whatsapp_business_messaging este necesară pentru a trimite orice mesaj și pentru a primi webhook-urile de mesaje și de status. Un token care deține doar una dintre ele eșuează la apelurile care o cer pe cealaltă.
De ce vede o aplicație de partener eroarea 3, iar un dezvoltator direct nu?
Pentru că partenerii care deservesc alte firme au o barieră în plus.
Ghidul de permisiuni Meta spune că un partener ai cărui clienți folosesc aplicația pentru a-și accesa datele trebuie să treacă prin App Review și să dețină Advanced access pentru fiecare permisiune de care are nevoie aplicația. Un dezvoltator direct, care lucrează doar cu datele propriei firme, nu are nevoie de App Review sau de Advanced access.
Astfel, același cod poate rula fără probleme pe contul propriu al dezvoltatorului și poate eșua pe contul unui client. Când apare acest tipar, întrebarea nu este ce permisiune lipsește din token, ci dacă aplicația a fost aprobată să folosească acea permisiune pe resurse care nu îi aparțin.
Greșeli frecvente
- Generarea unui token nou cu aceleași scope-uri. Un token nou cu aceleași permisiuni eșuează exact în același loc.
- Verificarea numelui permisiunii în setările aplicației, nu pe token. Contează ce a primit token-ul.
- Testarea doar pe contul propriu. Aplicațiile de partener au nevoie de Advanced access înainte ca conturile clienților să accepte apelul.
EasyCoexistence conectează fiecare număr prin fluxul Embedded Signup al Meta, astfel încât firma acordă permisiunile la înrolare, iar starea conexiunii rămâne vizibilă ulterior în dashboard-ul nostru.
Întrebări frecvente
Este eroarea 3 o problemă a numărului meu de telefon?
Nu. Ea privește ce are voie să facă token-ul aplicației. Numărul nu este verificat înainte ca cererea să fie refuzată.
Care este diferența dintre eroarea 3 și eroarea 10?
Codul 3 este o problemă de capabilitate sau de permisiuni. Codul 10 indică o permisiune neacordată sau retrasă. Ambele se rezolvă verificând scope-urile token-ului.
Ce permisiune îmi trebuie pentru a trimite mesaje?
whatsapp_business_messaging. Ghidul de permisiuni Meta spune că este necesară pentru a trimite orice tip de mesaj.
Ajută dacă încerc din nou?
Nu. Permisiunile token-ului nu se schimbă între încercări, deci rezultatul este același.
Continuați să citiți
Gata să începeți?
Configurați WhatsApp Coexistence în câteva minute, nu luni. Aplicația continuă să funcționeze pe telefon.
Începeți perioada de probă gratuităVerificat la