"Your app is missing required Graph API permissions for Cloud API companion pairing"
Mesej ini bermaksud platform yang melancarkan pendaftaran tidak mempunyai kebenaran WhatsApp yang Meta syaratkan, pada tahap akses yang Meta syaratkan, untuk menyambungkan nombor aplikasi WhatsApp Business ke Cloud API. Meta hanya membenarkan sesebuah perniagaan memberikan kebenaran yang platform itu pegang dengan akses Advanced. Perniagaan tidak dapat membetulkannya; platform yang perlu berbuat demikian.
Apa yang diperlukan oleh seorang rakan kongsi bagi setiap kebenaran sebelum pelanggannya boleh memberikannya melalui Embedded Signup.
Ralat yang dipulangkan panggilan API apabila whatsapp_business_management digunakan tanpa akses Advanced pada akaun yang bukan milik aplikasi itu.
whatsapp_business_management dan whatsapp_business_messaging, dua kebenaran yang menurut Meta secara amnya diperlukan oleh integrasi WhatsApp.
Meta menghendaki platform itu sudah menjadi Solution Partner atau Tech Provider untuk memasukkan pengguna aplikasi WhatsApp Business.
Apakah maksud mesej ini?
Teks penuhnya 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." Rujukan ralat awam Meta tidak menyenaraikan ayat yang tepat ini, tetapi setiap bahagiannya sepadan dengan sesuatu yang Meta dokumentasikan.
"Your app" ialah aplikasi Meta milik platform yang menjalankan pendaftaran, bukan aplikasi WhatsApp Business pada telefon. Meta tidak mentakrifkan companion pairing secara awam; jika dibaca dalam konteks, ia menggambarkan Cloud API menyertai satu nombor yang kekal didaftarkan dalam aplikasi WhatsApp Business, iaitu susunan Coexistence. Manakala kebenaran WhatsApp Business "advanced" merujuk kepada akses Advanced, tahap yang Meta berikan melalui App Review.
Kebenaran manakah yang terlibat?
Dokumentasi kebenaran Meta menamakan dua kebenaran yang secara amnya diperlukan oleh integrasi WhatsApp. whatsapp_business_management merangkumi metadata akaun, template, nombor telefon, analitik dan webhook akaun. whatsapp_business_messaging merangkumi penghantaran mesej serta penerimaan webhook mesej dan status.
Bagi rakan kongsi yang pelanggannya menggunakan aplikasinya, Meta menghendaki App Review dan akses Advanced untuk setiap kebenaran yang diperlukan oleh aplikasi itu. Meta menyatakan akibatnya secara terus: tanpa akses Advanced bagi sesuatu kebenaran, pelanggan tidak dapat memberikannya kepada aplikasi melalui Embedded Signup. Panggilan dengan whatsapp_business_management pada akaun yang bukan milik aplikasi, tanpa akses Advanced, memulangkan ralat 200.
Sesebuah platform boleh menyemak apa yang sebenarnya diberikan oleh perniagaan dengan memeriksa token melalui endpoint debug_token Meta, yang menyenaraikan kebenaran yang diberikan di bawah scopes.
Apakah yang boleh dilakukan oleh perniagaan?
Sangat sedikit di pihaknya, dan perniagaan tidak seharusnya cuba mengubah tetapan Meta miliknya untuk menyelesaikan ralat ini. Pembetulannya terletak pada platform: ia perlu menjadi Tech Provider atau Solution Partner, yang Meta senaraikan sebagai syarat untuk memasukkan pengguna aplikasi WhatsApp Business, dan akses Advanced untuk kebenaran WhatsApp itu perlu diluluskan.
Yang boleh dilakukan oleh perniagaan ialah melaporkan mesej yang tepat kepada platform, kemudian cuba semula selepas platform mengesahkan aksesnya, atau menggunakan platform yang sudah memegang status itu. Mengulangi aliran yang sama pada platform yang sama sebelum itu akan memberi hasil yang sama, dan ia tidak menjejaskan aplikasi WhatsApp Business pada telefon.
Kesilapan biasa
- Memberikan lebih banyak kebenaran dalam tetapan Meta milik perniagaan sendiri. Akses yang tiada itu milik aplikasi platform.
- Menjalankan sendiri sebuah alat pada aplikasi pembangun tanpa App Review. Tanpa akses Advanced, perniagaan tidak dapat memberikan kebenaran yang diperlukan.
- Mencuba semula berkali-kali pada platform yang sama. Hasilnya hanya berubah apabila akses platform itu berubah.
EasyCoexistence ialah Meta Tech Provider bebas dengan aplikasi Meta sendiri, dan menjalankan Embedded Signup v4 untuk Coexistence, jadi perniagaan menyambungkan nombor mereka melalui platform yang sudah memegang akses yang Meta syaratkan.
Soalan lazim
Adakah aplikasi WhatsApp Business saya bermasalah?
Tidak. Mesej itu merujuk kepada aplikasi Meta milik platform, bukan aplikasi pada telefon anda, yang terus berfungsi.
Bolehkah saya memberikan kebenaran itu sendiri?
Hanya kebenaran yang platform pegang dengan akses Advanced akan dipaparkan untuk anda berikan. Akses yang tiada itu perlu diluluskan untuk platform terlebih dahulu.
Bagaimanakah platform memperoleh akses Advanced?
Melalui Meta App Review bagi setiap kebenaran yang diperlukan oleh aplikasinya, sebagai rakan kongsi yang pelanggannya menggunakan aplikasi itu.
Adakah perniagaan perlu menjalani App Review?
Tidak. Meta menyatakan pembangun langsung yang hanya mengakses data perniagaannya sendiri tidak memerlukan App Review mahupun akses Advanced.
Teruskan membaca
Sedia untuk bermula?
Sediakan WhatsApp Coexistence dalam beberapa minit, bukan berbulan-bulan. Aplikasi terus berfungsi pada telefon.
Mulakan Percubaan PercumaDisahkan pada