Meta Tech Provider

WhatsApp hata kodu 3: yetenek veya izin sorunu

3 kodlu hata, uç noktayı çağıran uygulamanın o uç noktanın gerektirdiği bir yeteneğe veya izne sahip olmadığı anlamına gelir. Meta'nın açıklaması "Capability or permissions issue." şeklindedir. Graph API bunu API Method olarak adlandırır. Çözüm, erişim token'ı hata ayıklayıcısıyla token'ın verilmiş izinlerini incelemek ve uç noktanın ihtiyaç duyduğu izni eklemektir.

Meta'nın "Capability or permissions issue." için verdiği kod.

API Method

Graph API hata yönetimi kılavuzunun 3 koduna verdiği ad.

2 permissions

whatsapp_business_management ve whatsapp_business_messaging: çoğu WhatsApp uç noktasının ihtiyaç duyduğu iki izin.

WhatsApp 3 kodlu hata ne anlama gelir?

İsteğin kimliğinin doğrulandığı, ancak uygulamanın istediği işlemi yapma izninin olmadığı anlamına gelir.

Meta, Cloud API referansında 3 kodunu yetkilendirme hataları arasında sayar ve ayrıntı metni olarak "Capability or permissions issue." yazar. Cloud API'nin miras aldığı Graph API hata yönetimi kılavuzu aynı koda API Method adını verir ve uygulamanın çağrı için gereken yeteneğe veya izinlere sahip olduğundan emin olmanızı söyler.

Yani token çalışıyor. Sorun kimlik değil; bu da onu 0 ve 190 kodlarından ayırır. Sorun, token'ın nelere dokunabildiğidir.

Bir token'ın hangi izinlere sahip olduğunu nasıl kontrol edersiniz?

Erişim token'ı hata ayıklayıcısıyla ya da aynı bilgiyi döndüren debug_token uç noktasıyla.

Yanıt, verilen izinleri scopes özelliğinde listeler. Bu listeyi başarısız olan uç noktanın referans sayfasıyla karşılaştırın; her referans, gerektirdiği izinleri belirtir.

WhatsApp'ta iki izin hemen her şeyi karşılar. whatsapp_business_management hesap meta verileri, şablonlar, telefon numarası listeleri, analitik ve hesap webhook'ları için gerekir. whatsapp_business_messaging ise herhangi bir mesajı göndermek ve mesaj ile durum webhook'larını almak için gerekir. Yalnızca birine sahip olan token, diğerini gerektiren çağrılarda başarısız olur.

Neden bir iş ortağı uygulaması 3 kodlu hatayı görürken doğrudan geliştirici görmez?

Çünkü başka işletmelere hizmet veren iş ortaklarının ek bir kapısı vardır.

Meta'nın izinler kılavuzuna göre, müşterilerinin verilerine kendi uygulaması üzerinden eriştiği bir iş ortağı App Review'dan geçmeli ve uygulamanın ihtiyaç duyduğu her izin için Advanced access'e sahip olmalıdır. Yalnızca kendi işletme verileriyle çalışan doğrudan bir geliştiricinin App Review'a veya Advanced access'e ihtiyacı yoktur.

Bu yüzden aynı kod, geliştiricinin kendi hesabında sorunsuz çalışıp bir müşterinin hesabında başarısız olabilir. Bu örüntü görüldüğünde soru, token'da hangi iznin eksik olduğu değil, uygulamanın sahibi olmadığı varlıklarda o izni kullanmak için onaylanıp onaylanmadığıdır.

Yaygın hatalar

Aynı kapsamlarla yeni bir token üretmek. Aynı izinlere sahip yeni bir token aynı noktada başarısız olur.
İzin adını token üzerinde değil uygulama ayarlarında kontrol etmek. Önemli olan, token'a nelerin verildiğidir.
Yalnızca kendi hesabınızda test etmek. İş ortağı uygulamalarının, müşteri hesaplarının çağrıyı kabul etmesi için Advanced access'e ihtiyacı vardır.

Bunu EasyCoexistence'la yapmak

EasyCoexistence her numarayı Meta'nın kendi Embedded Signup akışıyla bağlar; böylece işletme izinleri kayıt sırasında verir ve bağlantının sağlığı sonrasında panelden görünür kalır.

Sık sorulan sorular

3 kodlu hata telefon numaranızla ilgili bir sorun mu?

Hayır. Uygulamanın token'ının neleri yapabileceğiyle ilgilidir. İstek reddedilmeden önce numara kontrol edilmez.

3 ve 10 kodlu hatalar arasındaki fark nedir?

3 kodu bir yetenek veya izin sorunudur. 10 kodu ise bir iznin verilmediğini ya da kaldırıldığını söyler. İkisi de token'ın kapsamları kontrol edilerek çözülür.

Mesaj göndermek için hangi izne ihtiyacım var?

whatsapp_business_messaging. Meta'nın izinler kılavuzuna göre her türlü mesajı göndermek için gereklidir.

Yeniden denemek işe yarar mı?

Hayır. Token'ın izinleri denemeler arasında değişmez, bu yüzden sonuç aynı olur.

Okumaya devam edin

WhatsApp error 10: permission not granted or removedError 10 means a permission was never granted or has been removed. How to confirm it, and the Flows and eligibility cases Meta also lists.WhatsApp error 131005: access denied, permission missingError 131005 means the permission the call needs is not granted or was removed. How to read the token's scopes and which permission sends messages.WhatsApp error 0: unable to authenticate the app userError 0 means Meta could not authenticate the app user behind the access token. The three causes Meta lists, and why a new token is the fix.WhatsApp error 200: no access token providedError 200 means no access token was sent, and the message reads 'Provide valid app ID'. It is also the start of the 200-299 permission range.WhatsApp Cloud API error codesEvery WhatsApp Cloud API error code in one table: what each one means, whether retrying helps, and the page that covers it in full.

Başlamaya hazır mısınız?

WhatsApp Coexistence'ı aylar değil, dakikalar içinde kurun. Uygulama telefonda çalışmaya devam eder.

Ücretsiz denemeyi başlatın

Doğrulama tarihi 2026-10-11