"Your app is missing required Graph API permissions for Cloud API companion pairing"
Pesan ini berarti platform yang meluncurkan pendaftaran tidak memiliki izin WhatsApp yang disyaratkan Meta, pada tingkat akses yang disyaratkan Meta, untuk menghubungkan nomor aplikasi WhatsApp Business ke Cloud API. Meta hanya mengizinkan bisnis memberikan izin yang Advanced access-nya dipegang platform. Bisnis tidak bisa memperbaikinya; platform yang harus melakukannya.
Apa yang dibutuhkan partner untuk setiap izin sebelum kliennya bisa memberikannya lewat Embedded Signup.
Kesalahan yang dikembalikan panggilan API saat whatsapp_business_management dipakai tanpa Advanced access pada akun yang bukan milik aplikasi.
whatsapp_business_management dan whatsapp_business_messaging, dua izin yang menurut Meta umumnya dibutuhkan integrasi WhatsApp.
Meta mewajibkan platform sudah menjadi Solution Partner atau Tech Provider untuk meng-onboard pengguna aplikasi WhatsApp Business.
Apa arti pesan ini?
Teks lengkapnya berbunyi: "Your app is missing required Graph API permissions for Cloud API companion pairing. Please verify advanced WhatsApp Business permissions are granted, then try again." Referensi kesalahan publik Meta tidak mencantumkan kalimat persis ini, tetapi setiap bagiannya sesuai dengan hal yang didokumentasikan Meta.
"Your app" adalah aplikasi Meta milik platform yang menjalankan pendaftaran, bukan aplikasi WhatsApp Business di ponsel. Meta tidak mendefinisikan companion pairing secara publik; dalam konteksnya, istilah ini menggambarkan Cloud API yang menggabungkan nomor yang tetap terdaftar di aplikasi WhatsApp Business, yaitu pengaturan Coexistence. Adapun izin WhatsApp Business "advanced" merujuk pada Advanced access, tingkat yang diberikan Meta lewat App Review.
Izin apa saja yang terlibat?
Dokumentasi izin Meta menyebut dua izin yang umumnya dibutuhkan integrasi WhatsApp. whatsapp_business_management mencakup metadata akun, template, nomor telepon, analitik, dan webhook akun. whatsapp_business_messaging mencakup pengiriman pesan serta penerimaan webhook pesan dan status.
Bagi partner yang kliennya memakai aplikasinya, Meta mewajibkan App Review dan Advanced access untuk setiap izin yang dibutuhkan aplikasi. Meta menyatakan akibatnya secara langsung: tanpa Advanced access untuk suatu izin, klien tidak bisa memberikannya kepada aplikasi lewat Embedded Signup. Panggilan dengan whatsapp_business_management pada akun yang bukan milik aplikasi, tanpa Advanced access, mengembalikan kesalahan 200.
Platform dapat memeriksa izin yang benar-benar diberikan bisnis dengan memeriksa token memakai endpoint debug_token milik Meta, yang mencantumkan izin yang diberikan di bawah scopes.
Apa yang bisa dilakukan bisnis?
Sangat sedikit dari sisinya sendiri, dan bisnis sebaiknya tidak mengubah pengaturan Meta-nya untuk mengatasi hal ini. Perbaikannya ada pada platform: platform harus menjadi Tech Provider atau Solution Partner, yang oleh Meta disebut sebagai syarat untuk meng-onboard pengguna aplikasi WhatsApp Business, dan Advanced access untuk izin WhatsApp harus sudah disetujui.
Yang bisa dilakukan bisnis adalah melaporkan pesan persisnya kepada platform, lalu mencoba kembali setelah platform memastikan aksesnya, atau memakai platform yang sudah memegang status tersebut. Mengulang alur yang sama di platform yang sama sebelum itu akan memberi hasil yang sama, dan tidak memengaruhi aplikasi WhatsApp Business di ponsel.
Kesalahan umum
- Memberikan lebih banyak izin di pengaturan Meta milik bisnis sendiri. Akses yang kurang adalah milik aplikasi platform.
- Menjalankan sendiri sebuah tool di aplikasi developer tanpa App Review. Tanpa Advanced access, bisnis tidak bisa memberikan izin yang dibutuhkan.
- Mencoba kembali berulang kali di platform yang sama. Hasilnya baru berubah saat akses platform itu berubah.
EasyCoexistence adalah Meta Tech Provider independen dengan aplikasi Meta sendiri, dan menjalankan Embedded Signup v4 untuk Coexistence, sehingga bisnis menghubungkan nomornya lewat platform yang sudah memiliki akses yang disyaratkan Meta.
Pertanyaan yang sering diajukan
Apakah ada yang salah dengan aplikasi WhatsApp Business saya?
Tidak. Pesan itu merujuk pada aplikasi Meta milik platform, bukan aplikasi di ponsel Anda, yang tetap berfungsi.
Bisakah saya memberikan izinnya sendiri?
Hanya izin yang Advanced access-nya dipegang platform yang muncul untuk Anda berikan. Akses yang kurang harus disetujui lebih dulu untuk platform.
Bagaimana platform mendapatkan Advanced access?
Lewat Meta App Review untuk setiap izin yang dibutuhkan aplikasinya, sebagai partner yang kliennya memakai aplikasi tersebut.
Apakah bisnis perlu App Review?
Tidak. Menurut Meta, developer langsung yang hanya mengakses data bisnisnya sendiri tidak memerlukan App Review maupun Advanced access.
Lanjut membaca
Siap memulai?
Konfigurasikan WhatsApp Coexistence dalam hitungan menit, bukan bulan. Aplikasi tetap berfungsi di ponsel.
Mulai uji coba gratisDiverifikasi pada