Kesalahan WhatsApp 3: masalah kapabilitas atau izin

Apa arti kode kesalahan 3 di WhatsApp?

Artinya permintaan sudah terautentikasi, tetapi aplikasi tidak diizinkan melakukan apa yang diminta.

Meta mencantumkan kode 3 di antara kesalahan otorisasi dalam referensi Cloud API dengan teks detail "Capability or permissions issue." Panduan penanganan kesalahan Graph API, yang diwarisi Cloud API, menyebut kode yang sama sebagai API Method dan meminta Anda memastikan aplikasi punya kapabilitas atau izin yang diperlukan untuk panggilan itu.

Jadi tokennya berfungsi. Identitas bukan masalahnya, dan inilah yang membedakannya dari kode 0 dan 190. Masalahnya adalah apa saja yang boleh disentuh oleh token tersebut.

Bagaimana cara memeriksa izin apa saja yang dimiliki sebuah token?

Gunakan access token debugger, atau endpoint debug_token yang mengembalikan informasi yang sama.

Respons menampilkan izin yang diberikan pada properti scopes. Bandingkan daftar itu dengan halaman referensi endpoint yang gagal, karena setiap referensi menyebutkan izin yang diwajibkannya.

Untuk WhatsApp, dua izin mencakup hampir semuanya. whatsapp_business_management dibutuhkan untuk metadata akun, template, daftar nomor telepon, analitik, dan webhook akun. whatsapp_business_messaging dibutuhkan untuk mengirim pesan apa pun dan menerima webhook pesan serta status. Token yang hanya memegang salah satunya akan gagal pada panggilan yang membutuhkan yang lain.

Mengapa aplikasi mitra mengalami kesalahan 3 sementara developer langsung tidak?

Karena mitra yang melayani bisnis lain punya satu gerbang tambahan.

Panduan izin Meta menyatakan bahwa mitra yang kliennya memakai aplikasinya untuk mengakses data mereka harus lolos App Review dan memegang akses Advanced untuk setiap izin yang dibutuhkan aplikasi. Developer langsung yang hanya bekerja dengan data bisnisnya sendiri tidak memerlukan App Review maupun akses Advanced.

Jadi kode yang sama bisa berjalan mulus pada akun milik developer sendiri dan gagal pada akun klien. Jika polanya begitu, pertanyaannya bukan izin mana yang hilang dari token, melainkan apakah aplikasi sudah disetujui untuk memakai izin itu pada aset yang bukan miliknya.

Kesalahan umum

• Membuat token baru dengan scope yang sama. Token baru dengan izin yang sama akan gagal di titik yang sama.
• Memeriksa nama izin di pengaturan aplikasi, bukan pada token. Yang berlaku adalah apa yang diberikan kepada token.
• Menguji hanya pada akun sendiri. Aplikasi mitra memerlukan akses Advanced sebelum akun klien menerima panggilan.

Pertanyaan yang sering diajukan

Lanjut membaca