Jika Anda mendapatkan kesalahan seperti "Mohon maaf, sesuatu mengalami masalah" dan mengalami masalah dalam menentukan penyebabnya, Anda dapat mengaktifkan pesan kesalahan terperinci selengkapnya yang dapat menampilkan informasi yang dapat ditindaklanjuti kepada Anda. Dokumentasi selengkapnya tentang bendera debug ke metode SDK init()
dapat ditemukan di https://developers.facebook.com/docs/accountkit/webjs/reference
Verifikasi Instan Account Kit memintas kebutuhan kode verifikasi melalui SMS ketika pelanggan Android memasukkan nomor telepon yang cocok dengan nomor yang sudah terdaftar di Facebook.
Ini hanya dapat dilakukan jika orang tersebut menggunakan aplikasi Facebook untuk Android. Jika kami tidak dapat mengonfirmasi kecocokan, orang tersebut akan dibawa melalui alur reguler dan menerima kode verifikasi melalui SMS.
Account Kit akan menampilkan UI yang dilokalkan untuk bahasa dalam daftar ini: https://developers.facebook.com/docs/accountkit/languages.
Silakan lihat di sini untuk daftar pembaruan kode negara dan telepon yang didukung: https://developers.facebook.com/docs/accountkit/countrycodes.
Tidak, kami hanya mendukung penautan SDK JS melalui https://sdk.accountkit.com/en_US/sdk.js. Skrip ini akan mengambil loader SDK, yang akan memuat SDK terbaru, baik dari accountkit.com maupun dari cache browser Anda.
Untuk kasus ketika Anda ingin meng-hosting SDK melalui server Anda sendiri, Anda mendapatkan lifetime grace 24 jam. Setelah periode grace ini, SDK akan mulai menampilkan peringatan, dan berhenti berfungsi setelah 7 hari.
Tetapkan parameter enableSendToFacebook (di iOS) atau setFacebookNotificationsEnabled (di Android) ke true.
Pengguna yang masuk ke aplikasi Anda akan menerima pesan konfirmasi melalui pemberitahuan Facebook jika SMS tidak dapat dikirim, dan jika nomor telepon yang mereka gunakan adalah nomor telepon utama yang terkait dengan akun Facebook mereka.
Anda harus menambahkan izin INTERNET untuk memanggil metode API. Selain itu, Anda dapat memilih untuk menambahkan izin tambahan guna mengurangi friksi selama proses masuk:
Anda dapat menemukan selengkapnya tentang mengintegrasikan Account Kit ke aplikasi Android Anda di sini.
Ketika pengguna membuka dialog berbagi seluler atau dialog kabar berita seluler, namun menutupnya dengan membatalkannya, maka aplikasi Anda akan diberi tahu tentang ini melalui metode callback onSuccess(). Anda dapat menganggap callback onSuccess() sebagai sebuah mekanisme untuk memberi sinyal bahwa dialog telah berhasil ditutup, namun Anda tidak dapat menggunakannya untuk memastikan bahwa ada sesuatu yang dikirimkan. Jika pengguna memberi izin lingkup "publish_actions", maka metode callback onCancel() akan diaktifkan pada saat pembatalan.
Untuk melihat detail lengkap tentang class FacebookCallback, harap buka dokumentasi referensi.
Tombol Suka native (LikeView) memiliki fungsi yang sama dengan Tombol Suka berbasis web. Sebagian besar URL Facebook tidak dapat digunakan dikarenakan privasi. Pengecualiannya meliputi halaman Facebook dan halaman beranda Facebook.
Anda dapat melakukan pengecekan awal dengan menggunakan cuplikan Tombol Suka.
Hal ini memang disengaja. Kami melihat banyaknya laporan spam dan penyalahgunaan fitur ini, dan untuk dapat meningkatkan pengalaman pengguna secara keseluruhan, maka kami memutuskan untuk menerapkan perubahan ini.
Ada cara yang lebih baik untuk berbagi di android yang didokumentasikan di sini.
We’ve moved all Messenger permissions to the Permissions and Features page.
We've consolidated this into one Permissions and Features page for Business apps, where you can see what access levels you have for each permission and feature.
Yes, developers may opt out of the Business app type and return to the previous App Review process for their app by selecting “Change App Type” on the App Dashboard. However, developers may not opt back into the Business app type and will need to create a new app to do so.
Additionally, apps previously in Development Mode that opt out to the legacy experience that have been approved for Advanced Access via App Review in the new model will lose access to data beyond what their business or anyone with a role on their app owns until they turn their app to Live Mode.
No.
We have replaced Development and Live Mode with Standard and Advanced Access. Standard Access is always active and allows you to access data that a developer’s business or anyone with a role on their app owns. You may submit for App Review for permissions and features to access data owned by other businesses or people. Refer to our Access Levels document to learn more.
To access one of these fields, you will need to submit for Advanced Access for the Business Asset User Profile Access feature through App Review.
Business apps designed to help businesses and organizations manage Pages, Groups, Events, Ads, and ad-related assets.
Yes, ALL apps that leverage permissions that require review (Pages API, Groups API, Events API, Business Manager API, Instagram Graph API, Messenger Platform, extended Facebook Login permissions, Marketing API and Lead Ads API) must submit for app review in adherence with the communicated deadlines.
Active apps that leverage permissions with an August 1st deadline (Pages API, Groups API, Events API, Business Manager API, Instagram Graph API, Messenger Platform, extended Facebook Login permissions) and have not yet proactively submitted for review will be auto-enrolled in the review process. You can accelerate the App Review process by submitting your app for review prior to auto-enrollment. This will give you more control over when your app is reviewed and what information is used for the review.
Untuk detail selengkapnya, kunjungi halaman ini. Proses ini akan memberi Anda kesempatan untuk memberikan detail tentang izin mana yang Anda perlukan, dan bagaimana izin tersebut akan digunakan. Facebook akan meninjau kasus penggunaan dan menentukan apakah hal tersebut diizinkan berdasarkan kebijakan kami. Setelah meninjau izin, bergantung pada API/izin, kami mungkin memiliki persyaratan tambahan seperti verifikasi bisnis dan penandatanganan kontrak.
Kebutuhan akan tinjauan aplikasi didasarkan pada level ID Aplikasi. Setiap aplikasi individual yang menggunakan izin atau fitur tersebut harus diajukan untuk tinjauan.
Yes, if your apps have made calls to the Graph API in the last 28 days as of July 31, 2018 and require access to the reviewable permissions with an August 1st deadline, your app will be auto-enrolled in the app review process. We will notify you when we have a process available to send us the additional information needed to complete the review process.
As we announced earlier this year, all apps accessing the Pages API, Groups API, Events API, Business Manager API, Instagram Graph API, Messenger Platform, and Facebook Login were expected to submit for app review by August 1.
To help protect the integrity of our platform, we have removed API access for apps that require these permissions, have not gone through app review, and have not been active within the last 28 days as of July 31, 2018. If you still need access to our APIs, we encourage you to submit for review through your app's App Dashboard.
All active apps that require these permissions will be auto-enrolled in app review in the coming weeks. Developers will be notified if we require additional information to complete the app review submission. If responses are not received in the allocated timeframe, reviewable API access will be disabled.
Jika permintaan Anda saat ini membutuhkan informasi tambahan, Anda akan memiliki waktu 30 hari sejak diterimanya permintaan untuk memecahkan dan mengirimkan ulang untuk peninjauan. Selama 30 hari itu, Anda mungkin diminta memberikan informasi tambahan oleh tim Tinjauan Aplikasi. Harap diketahui bahwa jendela 30 hari ini tidak akan dihitung ulang dengan tiap pengiriman ulang selama periode ini.
Untuk menguji fitur atau izin baru, setelah aplikasi Anda telah ditinjau dan diterbitkan, gunakan fitur Buat Aplikasi Tes di Dasbor Aplikasi untuk membuat klona aplikasi produk Anda. Di Dasbor aplikasi produksi, klik panah bawah di samping nama aplikasi pada panel navigasi kiri atas dan klik Buat Aplikasi Tes. Klona aplikasi, dibuat dengan status Dalam Pengembangan, mengizinkan semua aksesperan aplikasi ke semua fitur dan izin.
Jika klien juga merupakan "pemilik" aplikasi, maka mereka sendiri yang melalui proses sebagai developer langsung. Jika klien memiliki developer pihak ketiga sebagai "pemilik" aplikasi, maka developer-lah yang melalui proses tinjauan.
Anda akan perlu meminta izin leads_retrieval
dan pages_manage_ads
.
Anda dapat memberikan screencast integrasi Anda, atau jika aplikasi Anda tidak memiliki pengalaman pengguna akhir, Anda dapat memberikan minimal 2 cuplikan layar yang menunjukkan tampilan pengaturan halaman Anda, CRM atau Pengelola Bisnis Anda, serta memberikan ID Halaman untuk halaman yang akan digunakan melalui produk-produk ini. Anda dapat membaca selengkapnya tentang opsi ini di sini.
Proses Tinjauan Aplikasi mengacu pada aplikasi yang memerlukan izin API tertentu. Anda dapat membaca tentang izin yang diperlukan untuk tinjauan di sini. Menyiapkan SDK sendiri tidak memerlukan tinjauan aplikasi. Namun, SDK memang memungkinkan aplikasi untuk melakukan panggilan ke API Facebook, dan jika API tersebut perlu ditinjau, aplikasi harus mengajukan tinjauan aplikasi.
Jika Anda sudah memiliki akun Pengelola Bisnis, kami sarankan Anda untuk menghubungkan aplikasi ke Pengelola Bisnis yang ada.
Jika terdapat lebih dari satu akun Pengelola Bisnis yang dimiliki bisnis, kami menyarankan untuk mempertimbangkan alasan adanya lebih dari satu akun Pengelola Bisnis dan menyelaraskan aplikasi dengan Pengelola Bisnis yang paling sesuai. Jika bisnis memiliki fasilitas kredit yang disiapkan melalui Pengelola Bisnis, kami sarankan Anda menghubungkan aplikasi dengan Pengelola Bisnis yang memiliki fasilitas kredit itu.
Kami memberi kesempatan kepada para developer untuk menyediakan pengguna uji tertentu apabila terdapat konfigurasi tambahan, penambahan ke daftar putih, atau informasi profil pengguna uji yang developer inginkan untuk kami gunakan. Jika mereka tidak menyediakan pengguna uji, maka kami akan menggunakan pengguna uji kami sendiri. Kolomnya harus ditandai sebagai opsional, dan apabila kolom tersebut tidak lengkap, maka hal tersebut tidak boleh mengarah pada pemblokiran.
Tinjauan aplikasi harus dilakukan per aplikasi. Kami menyarankan agar Anda meninjau dasbor aplikasi Anda untuk mendapatkan daftar izin khusus yang perlu ditinjau.
Verifikasi Bisnis diperlukan sekali per Pengelola Bisnis. Jika Anda memilih untuk mengaitkan semua aplikasi Anda dengan Pengelola Bisnis yang sama, maka Anda hanya perlu melalui verifikasi bisnis satu kali.
Aplikasi harus dikaitkan dengan Pengelola Bisnis untuk bisnis yang pada akhirnya memiliki aplikasi dan memiliki akses ke data yang dihasilkan dari aplikasi. Bisnis inilah yang harus menjalani proses verifikasi bisnis.
Anda selalu dapat melihat status verifikasi bisnis dan kontrak serta langkah-langkah yang perlu diambil di panel verifikasi bisnis, dalam tab tinjauan aplikasi pada dasbor aplikasi. Kami akan mengirimkan notifikasi di sepanjang proses untuk memberi tahu Anda tindakan yang diperlukan.
You need to initiate app review before August 1, 2018 for these APIs: Pages API, Groups API, Events API, Instagram Platform API, Messenger Platform, Business Manager API, and Facebook Login.
You need to initiate App Review before February 1, 2019 for these APIs and features: the Marketing API and the Lead Ads Retrieval feature.
Saat ini kami sedang mengalami peningkatan volume. Keseluruhan proses dapat memakan waktu hingga beberapa minggu.
Sebagai bagian dari proses tinjauan, Anda mungkin dimintai informasi bisnis seperti nama resmi bisnis, alamat, dan nomor telepon. Selain itu, Anda mungkin diminta untuk memberikan dokumentasi bisnis seperti tagihan utilitas, lisensi, sertifikat badan usaha, atau akta pendirian.
Same as other permissions, you will lose access.
Mulai 1 Agustus 2018, Anda hanya perlu memverifikasi Pengelola Bisnis yang terhubung dengan aplikasi.
Ketika API baru tersedia, ini harus diminta melalui Tinjauan Aplikasi. Namun Verifikasi Bisnis hanya diperlukan satu kali per entitas Pengelola Bisnis, jadi Verifikasi Bisnis tidak akan diperlukan lagi jika aplikasi memerlukan izin atau API baru.
Ya, aplikasi tes akan mewarisi izin yang dapat ditinjau dari aplikasi induk.
Harap buka postingan ini untuk garis besar kronologinya.
Semua aplikasi yang memanggil izin perpanjangan Facebook Login dan 6 API (Halaman, Messenger, Pengelola Bisnis, Instagram, Grup, dan Peristiwa) harus membuat pengajuan untuk mengikuti alur Tinjauan Aplikasi yang baru, yang mencakup verifikasi bisnis dan penandatanganan kontrak. Tinjauan Aplikasi tidak harus selesai pada tanggal tersebut, hanya perlu dibuat pengajuannya saja. Jika suatu pengajuan tidak dikirimkan sebelum tanggal 1 Agustus 2018, maka akses ke sejumlah API tersebut akan tidak diberikan lagi pada tanggal 2 Agustus 2018.
Semua aplikasi yang memanggil API Marketing dan API Pengambilan Iklan Prospek harus membuat pengajuan untuk menjalani alur Tinjauan Aplikasi yang baru, yang mencakup verifikasi bisnis dan penandatanganan kontrak, sebelum tanggal 1 Februari 2019.
Untuk detail selengkapnya, kunjungi halaman ini. Prosesnya akan memberi Anda kesempatan untuk memberikan informasi rinci tentang izin yang Anda perlukan dan cara penggunaannya. Facebook akan meninjau kasus penggunaannya dan menentukan apakah kasus penggunaan tersebut diperbolehkan berdasarkan kebijakan kami. Setelah tinjauan izin, tergantung API/izinnya, kami memiliki persyaratan tambahan seperti verifikasi bisnis dan penandatanganan kontrak.
Sebuah bisnis hanya perlu diverifikasi sebanyak satu kali. Kontrak hanya perlu ditandatangani setelah berada pada level bisnis. Pengajuan aplikasi berikutnya hanya akan memerlukan tinjauan aplikasi saja, tanpa verifikasi.
Perlu tidaknya tinjauan aplikasi ditentukan berdasarkan level ID Aplikasi. Setiap aplikasi yang menggunakan izin atau fitur tersebut harus diajukan untuk ditinjau.
Pada tanggal 1 Mei 2018 kami mengumumkan adanya proses Tinjauan Aplikasi baru yang diwajibkan untuk Facebook Login (izin yang diperpanjang) dan 6 API (Halaman, Messenger, Pengelola Bisnis, Instagram, Grup, dan Peristiwa). Pengajuan Tinjauan Aplikasi untuk API/izin ini diwajibkan sebelum tanggal 1 Agustus 2018 agar dapat mempertahankan akses ke API tersebut.
Pada tanggal 2 Juli 2018 kami mengumumkan API tambahan yang mewajibkan tinjauan aplikasi: API Marketing dan Pengambilan Iklan Prospek. Pengajuan Tinjauan Aplikasi untuk sejumlah API ini diwajibkan sebelum tanggal 1 Februari 2019 agar dapat mempertahankan akses. Anda dapat membaca selengkapnya tentang tenggat waktunya di sini.
Selama proses tinjauan, tim tinjauan kami mengikuti petunjuk Anda untuk mereproduksi cara izin digunakan dalam aplikasi Anda. Jika kami tidak dapat mereproduksi pengalaman ini - misalnya, karena kami tidak dapat mengikuti petunjuk Anda, atau kami tidak dapat masuk ke aplikasi Anda - maka kami juga tidak dapat menyetujui pengajuan.
Untuk menghindari hal ini, maka:
Secara khusus, untuk izin publish_actions pastikan fungsionalitas penerbitan aplikasi Anda dikonfigurasi dengan benar. Kami harus dapat menerbitkan konten aplikasi Anda kembali ke Facebook selama proses tinjauan.
Proses Tinjauan Aplikasi melibatkan aplikasi Anda yang dimuat di setiap platform yang didukung, masuk dengan Facebook, dan menggunakan setiap integrasi Facebook yang Anda minta dalam tinjauan. Ini seringkali menimbulkan apa yang kami sebut "masalah umum". Ini adalah kesalahan atau bug yang berkaitan dengan memuat aplikasi Anda, masuk ke aplikasi Anda, atau fungsionalitas umum aplikasi Anda. Ini artinya kami tidak dapat menguji izin yang Anda minta dalam pengajuan Anda.
Karena itu adalah masalah yang mencegah kami meninjau fungsionalitas Facebook Anda, kami tidak dapat mengomentari lebih rinci tentang cara aplikasi Anda menggunakan fungsionalitas Facebook yang Anda ajukan untuk ditinjau. Karena hal ini, kami menolak dengan "Masalah Umum" dan menyediakan masukan mengenai ini di setiap platform.
Jika Anda menerima penolakan "Masalah Umum", harap baca dengan cermat semua masukan. Setiap platform akan menerima masukan individual yang harus menjelaskan masalah apa yang dialami selama tinjauan.
Tanggapan tinjauan Anda akan berisi uraian jelas dari alasan mengapa aplikasi Anda tidak disetujui, serta langkah selanjutnya yang harus Anda lakukan. Kami ingin Anda secepat mungkin melewati proses ini, jadi pastikan membaca masukan ini dengan cermat. Setelah Anda melakukan perubahan yang diperlukan, Anda dapat kembali mengajukan untuk ditinjau.
Jika aplikasi Anda menggunakan izin sedemikian rupa sehingga tidak dapat disetujui, masukan untuk Anda akan menjelaskan ini dan Anda tidak boleh mengajukan lagi untuk ditinjau.
Agar disetujui untuk Pusat Aplikasi, maka Aplikasi Anda harus memenuhi persyaratan kelayakan. Aplikasi yang memenuhi syarat untuk Pusat Aplikasi Facebook harus menggunakan Facebook Login atau memiliki aplikasi Canvas Facebook.
Aplikasi yang memenuhi syarat untuk dicantumkan di Pusat Aplikasi adalah:
Aset teks dan gambar promosi Anda juga harus memenuhi pedoman kami.
Jika Anda menggunakan Dialog Bagikan atau plugin sosial lainnya untuk menerbitkan konten kembali ke Facebook, Anda tidak perlu mengajukan untuk ditinjau. Jika Anda masih tidak yakin, info selengkapnya dapat ditemukan di dokumentasi tinjauan umum kami.
Itu bertentangan dengan Kebijakan Platform 4.5 untuk mendorong orang-orang agar menggunakan plugin sosial atau menyukai Halaman. Ini termasuk penawaran imbalan atau membatasi aplikasi atau konten aplikasi berdasarkan apakah seseorang sudah menyukai Halaman atau belum. User_likes tidak akan disetujui untuk tujuan ini.
Untuk memastikan koneksi yang berkualitas dan membantu bisnis menjangkau orang-orang yang penting bagi mereka, kami ingin orang-orang menyukai Halaman karena mereka ingin terhubung dan mengetahui kabar dari bisnis, bukan karena dorongan palsu. Kami yakin kebijakan ini akan menguntungkan orang-orang dan pengiklan sekaligus.
Tim tinjauan kami mungkin memerlukan kredensial masuk tambahan untuk aplikasi Anda agar dapat menyelesaikan tinjauan Anda.
Jika aplikasi Anda memerlukan masuk sekunder sebelum atau setelah Facebook Login, pastikan memberikan nama pengguna dan kata sandi untuk ini. Ini dapat meliputi kredensial masuk untuk server pengujian atau demo, masuk sekunder untuk aplikasi Anda, atau alur pendaftaran email.
Aplikasi yang dihosting di server penahapan atau pengembangan dapat memerlukan masuk tambahan untuk mengakses server Anda. Harap juga menyediakan semua kredensial masuk yang diperlukan untuk ini.
Jika Anda masih tidak tahu kredensial apa yang tidak ada, Anda dapat memberikan video beserta pengajuan Anda selanjutnya yang menunjukkan opsi Facebook Login dan semua integrasi Facebook yang relevan yang Anda ajukan.
Untuk menyetujui pengajuan aplikasi Anda, tim tinjauan kami harus masuk ke aplikasi Anda dan memeriksa semua integrasi Facebook.
Jika peninjau Anda tidak dapat memuat atau menggunakan aplikasi Anda, pastikan bahwa:
Jika Anda kembali ditolak karena alasan yang sama, perbarui Petunjuk Tinjauan atau bagian Tambahkan Catatan Anda untuk meminta kejelasan dan info tambahan dari peninjau Anda.
Screencast adalah cara hebat untuk memandu kami memahami aplikasi Anda dan menunjukkan kepada kami cara Anda menggunakan izin yang diminta. Berikut adalah praktik terbaik dan sumber daya pihak ketiga untuk membuat screencast.
Video Anda harus menampilkan bagaimana aplikasi Anda menggunakan setiap izin yang diminta. Jika Anda meminta publish_actions, video Anda juga harus menampilkan cara konten dari aplikasi Anda dibuat dan dibagikan ke Facebook.
ID Aplikasi Facebook Anda yang dibuat untuk Game Instan tidak dapat digunakan untuk platform lain. Anda dapat menemukan info selengkapnya dalam dokumentasi.
Tim tinjauan kami akan menggunakan petunjuk yang Anda berikan untuk menguji integrasi Facebook aplikasi Anda.
Jika Anda merasa peninjau kami salah dalam menolak aplikasi Anda, maka Anda harus mengajukan ulang untuk peninjauan dengan petunjuk tinjauan yang diperbarui yang memberikan lebih banyak info untuk peninjau.
Proses tinjauan adalah cara terbaik untuk berkomunikasi dengan peninjau Anda dengan memperbarui catatan Anda yang memperhatikan masukan yang Anda terima.
Tim tinjauan kami menggunakan beberapa pengguna uji saat meninjau pengajuan, dan kami tidak selalu menggunakan pengguna uji yang Anda berikan. Jika pengajuan Anda memang harus ditinjau menggunakan pengguna uji khusus, beri tahu kami dalam petunjuk tinjauan Anda.
Jika Anda menyediakan pengguna uji, pastikan Anda membuat pengguna uji dan melampirkan pengguna tersebut dengan benar beserta pengajuan Anda.
Tidak. Setelah Anda disetujui untuk menerima izin, Anda dapat menggunakannya di semua versi aplikasi Anda di semua platform.
Jika Anda memperluas dan mengembangkan aplikasi Anda di platform baru, ini tidak perlu diajukan lagi untuk ditinjau. Anda hanya perlu mengajukan ulang untuk ditinjau jika Anda ingin meminta izin baru - misalnya, saat Anda menambahkan fitur baru ke aplikasi Anda. Perubahan dan pengajuan Detail Aplikasi atau tindakan Graf Terbuka Anda tidak akan memengaruhi izin yang sudah disetujui sebelumnya.
Jika aplikasi Anda adalah game dan ada di Facebook Canvas
Anda dapat mengundang pemain baru ke game Anda dengan menggunakan:
Jika aplikasi Anda tidak hadir di Facebook Canvas
Anda dapat menggunakan Dialog Pesan di iOS dan Android, atau Dialog Kirim di Web. Produk tersebut memungkinkan orang mengirim pesan berisi tautan ke aplikasi Anda langsung ke temannya.
Jenis pesan ini adalah saluran yang sangat bagus untuk berkomunikasi dengan sedikit orang secara langsung. Dialog Pesan dan Dialog Kirim sama-sama menyertakan typehead yang memudahkan orang untuk memilih sejumlah teman yang menerima undangan.
Tim tinjauan kami akan benar-benar menguji cara aplikasi Anda menggunakan setiap izin di setiap platform yang sudah Anda cantumkan di bagian pengaturan aplikasi Anda. Peninjau Anda memastikan integrasi Facebook Login Anda bekerja dengan benar dan setiap izin yang diminta mematuhi prinsip kami dan pedoman penggunaan saat memberikan pengalaman pengguna yang ditingkatkan.
Lihat prinsip dan pedoman penggunaan kami untuk info selengkapnya.
Sebelum menyetujui permintaan Anda untuk user_likes, peninjau Anda harus memastikan aplikasi Anda menyediakan pengalaman unik kepada pengguna berdasarkan info suka yang diterimanya dari mereka. Untuk melakukan ini, tim tinjauan kami akan menguji aplikasi Anda dengan berbagai pengguna uji, masing-masing dengan serangkaian suka dan minat yang berbeda-beda.
Saat mengajukan permintaan untuk user_likes, Anda harus menulis petunjuk terperinci yang menyertakan:
Jika Anda menggunakan user_likes sebagai bagian dari algoritme, penting agar peninjau dapat melihat hasil algoritme ini dan caranya memengaruhi konten yang ditampilkan kepada orang-orang.
Di beberapa kasus, Anda dapat mengharuskan peninjau mereproduksi perilaku atau pengalaman tertentu yang hanya tersedia untuk pengguna uji khusus. Jika ini terjadi, Anda dapat menambahkan pengguna ini ke pengajuan Anda di halaman Tinjauan Aplikasi. Di bagian Item dalam Tinjauan, Anda akan melihat bagian Pengguna Uji (opsional) yang memungkinkan Anda mengetikkan nama pengguna yang Anda ingin digunakan dalam tinjauan Anda.
Pengguna uji yang tersedia di sini hanyalah yang tercantum sebagai Pengguna Uji di bagian Peran dari aplikasi Anda. Jangan bocorkan kredensial Facebook Login untuk pengguna di petunjuk tinjauan Anda.
Pelajari selengkapnya tentang cara membuat pengguna uji.
Tidak, Anda tidak harus mengajukan aplikasi untuk ditinjau guna menjalankan iklan pemasangan aplikasi seluler. Anda hanya memerlukan aplikasi yang sudah aktif di iTunes App Store atau Google Play Store. Anda dapat mengikuti panduan kami untuk membuat iklan pemasangan aplikasi seluler.
Anda harus menjelaskan secara persis cara menguji setiap izin atau fitur di aplikasi Anda sehingga kami dapat memastikan itu berfungsi dan mematuhi kebijakan kami. Kami tidak dapat menyetujui aplikasi Anda jika kami tidak dapat sepenuhnya menguji caranya terintegrasi dengan Facebook. Petunjuk terperinci yang Anda berikan akan memperkecil kemungkinan Anda harus mengajukan ulang untuk ditinjau.
Untuk setiap izin yang Anda minta, cantumkan petunjuk reproduksi dalam format langkah demi langkah. Semua petunjuk harus dalam bahasa Inggris.
Petunjuk Anda jangan sampai:
Berikut adalah contoh petunjuk langkah demi langkah yang tepat:
Jika Anda tidak yakin apa yang harus disertakan, lihat contoh lainnya dalam bagian contoh untuk Tinjauan Aplikasi.
Karena adanya perubahan terbaru pada proses tinjauan dan tingginya volume pengiriman, mungkin diperlukan waktu beberapa minggu bagi aplikasi yang diajukan untuk menyelesaikan tinjauan.
Berikan info sebanyak mungkin untuk membantu peninjau, termasuk cuplikan layar yang jelas, petunjuk langkah demi langkah yang terperinci dan rekaman screencast aplikasi Anda dan integrasi Facebook-nya.
Aplikasi yang menggunakan produk berbagi yang dimediasi seperti plugin sosial, dialog bagikan dan lembar bagikan, atau bagian dari Facebook Login tidak harus ditinjau oleh Facebook. Untuk mempelajari lebih lanjut tentang apa yang perlu ditinjau, lihat dokumentasi Tinjauan Aplikasi.
Kami meninjau aplikasi Anda untuk memastikan pengalaman Facebook yang berkualitas tinggi di berbagai aplikasi. Umumnya, orang harus mengetahui bahwa mereka login dan mengirim ke Facebook. Orang harus dapat mengontrol informasi yang mereka bagikan dengan aplikasi Anda atau kembali ke Facebook.
Catatan: Orang yang tercantum di tab Peran aplikasi Anda akan memiliki akses ke izin yang diperpanjang tanpa melalui tinjauan (misalnya user_posts
). Namun, ketika aplikasi dibuka untuk publik, aplikasi harus melalui proses Tinjauan Aplikasi untuk mengakses informasi bahkan untuk orang-orang dengan peran di aplikasi.
Semua kemampuan aplikasi harus tersedia saat aplikasi Anda masukMode Pengembangan tetapi Anda hanya akan dapat mengakses data Anda, data pengguna uji Anda, atau data halaman Anda. Jika Anda ingin memublikasikan aplikasi Anda, bahkan jika Anda adalah satu-satunya pengguna, prosesnya harus melalui tinjauan aplikasi.
Jika meminta daftar halaman untuk sebuah bisnis melalui /BUSINESS_ID/pages
, tidak semua kolom halaman dapat diminta, dan API dapat menanggapi dengan sebuah kesalahan: (#100) Unknown fields: <FIELD_NAME>
.
Ini karena endpoint ini tidak mengembalikan objek Halaman seperti endpoint serupa lainnya, dan ini juga mencakup permintaan yang menunggu persetujuan yang sudah disetujui, misalnya. Karena itu, Anda tidak dapat menggunakan perluasan kolom untuk mengembalikan kolom dari Halaman tersebut.
Anda dapat menggunakan <BUSINESS_ID>/owned_pages
atau <BUSINESS_ID>/client_pages
- kedua endpoint tersebut dapat mengembalikan objek Halaman dan mendukung perluasan kolom.
Untuk mengirim permintaan ke halaman terverifikasi, Pengelola Mitra Facebook harus mengonfigurasi bisnis guna mengizinkan untuk melakukan permintaan tersebut terhadap organisasi yang terkait dengan halaman tersebut. Bisnis tanpa Pengelola Mitra Facebook tidak akan dapat mengeluarkan permintaan tersebut.
Dengan Pemeriksaan Penggunaan Data, admin aplikasi perlu:
1. Melihat izin dan fitur aplikasi yang disetujui
2. Mengesahkan bahwa aplikasi mematuhi penggunaan yang diizinkan
3. Menegaskan kepatuhan terhadap Ketentuan Platform Facebook dan Kebijakan Developer beserta semua ketentuan dan kebijakan yang berlaku
Pemeriksaan Penggunaan Data dan Tinjauan Aplikasi adalah dua langkah integritas platform yang berbeda, tetapi terkait. Tinjauan Aplikasi adalah proses berwawasan ke depan yang membuka akses ke izin Platform Facebook tertentu, yang mengharuskan developer mengirimkan aplikasi untuk mengonfirmasi akses platform, yang ditinjau secara manual oleh tim Operasi Developer kami. Setelah akses platform diberikan, Pemeriksaan Penggunaan Data merupakan proses tahunan yang mewajibkan developer untuk mengesahkan bahwa penggunaan data Facebook berkelanjutan oleh mereka sesuai dengan Ketentuan Platform dan Kebijakan Developer kami.
Anda harus mengesahkan atas nama setiap aplikasi yang dikelola bisnis Anda.
Developer yang mengelola banyak aplikasi akan memiliki opsi untuk menyelesaikan Pemeriksaan Penggunaan Data untuk beberapa aplikasi sekaligus. Anda dapat mengakses alur ini dengan membuka halaman “Aplikasi Saya” di Dasbor Aplikasi. Dari sini, Anda akan melihat semua aplikasi yang Anda menjadi adminnya, bisa memfilter ke subset (mis., hanya yang memerlukan Pemeriksaan Penggunaan Data), dan menyelesaikan Pemeriksaan Penggunaan Data.
Anda harus menyelesaikan pemeriksaan untuk setiap aplikasi yang Anda kelola (setiap aplikasi mungkin memiliki beberapa izin). Anda dapat mengesahkan aplikasi secara individu dan memprioritaskannya sesuai keinginan, selama Anda menyelesaikan proses sebelum batas waktu yang ditetapkan untuk setiap aplikasi.
Anda akan diminta untuk mengesahkan semua izin yang Anda miliki aksesnya. Akan tetapi, jika Anda menyadari bahwa Anda tidak lagi memerlukan akses ke izin tertentu, Anda bisa menghapus izin ini dan Anda tidak perlu lagi mengesahkan izin tersebut.
Mode Terbit dan Mode Pengembangan adalah dua mode aplikasi yang memiliki implikasi pada fungsionalitas aplikasi dan Pemeriksaan Penggunaan Data. Mode Pengembangan biasanya digunakan untuk menguji, menjelajahi produk/izin API, dan menyelesaikan Tinjauan Aplikasi, dan aplikasi dalam Mode Pengembangan tidak bisa memanggil data level pengguna. Mode Terbit digunakan untuk skenario produksi dan tidak memberikan akses untuk data/izin yang disetujui untuk aplikasi dalam Tinjauan Aplikasi. Hanya aplikasi Mode Terbit yang memerlukan Pemeriksaan Penggunaan Data.
Jika karena alasan tertentu Anda tidak bisa mengakses aplikasi dan perlu mendapatkan kembali status admin, klik di sini.
Secara umum, kami berupaya untuk mengelompokkan tenggat waktu aplikasi jika memiliki admin aplikasi yang sama, jadi Anda akan memiliki tenggat waktu yang sama untuk aplikasi Anda. Namun, mungkin ada pengecualian yang mengakibatkan beberapa admin aplikasi harus menyelesaikan proses pada tenggat waktu yang berbeda-beda – misalnya, jika Anda membuat aplikasi setelah orang lain melalui Pemeriksaan Penggunaan Data, itu akan memiliki tenggat waktu tahunan yang berbeda.
Anda bisa melihat semua aplikasi yang memerlukan Pemeriksaan Penggunaan Data dengan membuka halaman "Aplikasi Saya" di Dasbor Aplikasi. Di sini, Anda bisa melihat semua aplikasi yang Anda kelola dan memfilter aplikasi yang memerlukan Pemeriksaan Penggunaan Data.
Proses ini harus diselesaikan oleh administrator aplikasi. Untuk meninjau siapa yang merupakan administrator di aplikasi Anda, login ke Dasbor Aplikasi dan klik “Peran” di sisi kiri halaman. Administrator aplikasi harus memiliki kewenangan untuk bertindak atas nama organisasi Anda.
Admin aplikasi siapa pun bisa mengesahkan aplikasi. Jika Anda memiliki beberapa admin aplikasi, hanya salah satu dari mereka yang harus mengesahkan.
Anda memiliki waktu 60 hari sejak proses dimulai (saat Anda menerima Peringatan Developer pertama) hingga tenggat waktu.
Setelah tenggat waktu, kami akan mulai mencabut akses platform dengan memperlambat panggilan API sepanjang bulan setelah tenggat waktu Anda. Selama periode ini, Anda akan bisa membuka Dasbor Aplikasi dan menyelesaikan Pemeriksaan Penggunaan Data agar aplikasi Anda kembali ke status patuh dan memulihkan akses platform sepenuhnya. Namun, setelah satu bulan berlalu setelah tenggat waktu, kami akan mencabut akses platform sepenuhnya.
Anda mungkin masih dapat kembali ke Dasbor Aplikasi, menyelesaikan Pemeriksaan Penggunaan Data, dan memulihkan akses. Namun, kami melakukan “perolehan izin” tidak aktif aplikasi yang tidak aktif secara berkala, yang berarti setelah periode tidak aktif tertentu, izin Anda bisa dihapus secara permanen dan Anda harus mengirimkannya untuk Tinjauan Aplikasi guna mendapatkan akses kembali. Kami menyarankan Anda menyelesaikan Pemeriksaan Penggunaan Data sebelum tenggat waktu untuk menghindari skenario ini.
Pemeriksaan Penggunaan Data akan menampilkan semua izin yang aplikasi Anda miliki aksesnya, terlepas dari apakah Anda aktif menggunakannya. Kami rekomendasikan untuk mengambil kesempatan ini untuk mengaudit integrasi Anda, lebih memahami kemampuan aplikasi Anda, dan menghapus akses ke izin yang tidak Anda butuhkan.
Dalam beberapa kasus, kami akan menampilkan informasi penggunaan API langsung di alur Pemeriksaan Penggunaan Data. Atau, Anda bisa melihat tingkat penggunaan untuk setiap izin di bagian “Izin dan Fitur” di Dasbor Aplikasi. Setelah Anda masuk, klik “Tinjauan Aplikasi” di sisi kiri halaman, lalu pilih “Izin dan Fitur” dari menu pilihan. Anda akan melihat kolom untuk “panggilan API”, yang akan memiliki centang hijau jika catatan kami menunjukkan bahwa Anda aktif menggunakan izin tersebut. Harap diingat bahwa ini hanyalah perkiraan — Anda harus berkonsultasi dengan tim pengembangan Anda untuk mengetahui apakah izin diperlukan untuk integrasi Anda.
Kami mengharuskan developer untuk mengesahkan izin “dasar” yang diberikan secara otomatis ini karena izin tersebut digunakan secara luas dan memberikan akses ke data pengguna. Namun, jika Anda tidak pernah menggunakan data ini, Anda masih bisa menyelesaikan proses ini dengan nyaman, karena pengesahan menunjukkan bahwa setiap penggunaan izin telah sesuai, termasuk tidak ada penggunaan.
Anda harus menghapus izin terlebih dahulu menggunakan Dasbor Aplikasi (klik “Izin dan Fitur Saya” dari menu pilihan sisi kiri di bagian “Tinjauan Aplikasi”). Kemudian Anda bisa mengesahkan izin dan fitur lainnya yang masih Anda gunakan.
Namun, ada beberapa izin yang diberikan secara otomatis yang tidak bisa dihapus dan Anda mungkin diminta untuk mengesahkannya. Jika Anda tidak pernah menggunakan data ini, Anda masih bisa menyelesaikan proses ini dengan nyaman, karena pengesahan menunjukkan bahwa setiap penggunaan izin telah sesuai, termasuk tidak ada penggunaan.
Tidak. Setelah menghapus izin di Dasbor Aplikasi, Anda bisa memuat ulang halaman Pemeriksaan Penggunaan Data dan izin yang Anda hapus akan hilang.
Tidak.
Anda harus menyelesaikan Pemeriksaan Penggunaan Data untuk semua izin yang aplikasi Anda miliki aksesnya.
Kami akan melakukan peluncuran Pemeriksaan Penggunaan Data secara bertahap, jadi meskipun Anda diharapkan menyelesaikan proses dalam beberapa bulan mendatang, tenggat waktu spesifik Anda akan bervariasi. Pastikan informasi kontak Anda adalah yang terbaru di Dasbor Aplikasi dan lihat Peringatan Developer Anda untuk rincian tenggat waktu.
In order to comply with certain legal obligations, Meta’s developer services may not be available in all locations, including countries and regions currently subject to U.S. sanctions prohibitions.
Meta’s services are not available in all regions.
Registration reviews may take longer and you may be unable to access our service during that time. Please try again in a few days. For more information, please refer to Meta’s Terms of Service.
We are currently reviewing your registration details. This takes 24 to 48 hours. Once completed and approved, you may be able to login and complete your registration.
Anda tidak dapat menghapus cuplikan layar atau gambar spanduk yang telah disetujui untuk Pusat Aplikasi. Untuk menggantinya dengan gambar yang baru, klik "Sunting" di cuplikan layar atau spanduk, dan pilih gambar pengganti.
Periksa apakah Anda dapat melihat pesan kesalahan tanpa membuat permintaan untuk foto pengguna dan verifikasi bahwa pesan kesalahan awal tersebut dapat dilihat. Selanjutnya buat permintaan API berikut, me/photos, dan kembali periksa apakah pesan kesalahan yang sama masih terlihat atau tidak. Pastikan ketika Anda melakukan pemanggilan me/photos, Anda menggunakan aplikasi yang dimaksud dan memperoleh token akses yang memerlukan izin user_photos. Setelah itu, Anda akan dapat memastikan kelancaran Anda!
Tujuan pengecekan ini adalah memastikan pengembang telah menguji fitur di aplikasi mereka secara menyeluruh sebelum meminta kami untuk izin yang sama. Mengujinya di aplikasi tes tidak menjamin kestabilan yang sama di aplikasi utama. Kami mewajibkan Anda untuk membuat permintaan uji dari aplikasi utama Anda, guna memastikan Anda melihatnya berfungsi sesuai harapan sebelum Anda mengadakan pemanggilan tersebut untuk pemirsa eksternal. Ikuti langkah-langkah yang diberikan untuk membuat permintaan secara manual dan memeriksa apakah Anda masih melihat peringatan ini di dasbor Anda.
Migrasi 'Streaming Keamanan URL Kiriman' akan membuat Aplikasi Facebook Anda berhenti menerbitkan URL yang tidak mengarah kembali ke domain yang dimilikinya. Jangan gunakan opsi ini jika Aplikasi Anda akan menerbitkan tautan ke situs lainnya.
Fitur dasbor ini telah dihapus. Anda akan perlu menggunakan endpoint '/{app-id}/accounts/test-users/' untuk menghubungkan pengguna uji dengan sebuah aplikasi. Anda dapat membaca selengkapnya tentang hal itu di sini
Perilaku ini memang disengaja dan didokumentasikan di sini - https://developers.facebook.com/docs/apps/test-users#rules - Pengguna uji tidak dapat menjadi penggemar maupun membuat konten di Halaman Facebook yang bersifat publik, seperti misalnya menulis di dinding sebuah Halaman. Sekalipun demikian, pengguna uji dapat melihat dan berinteraksi dengan tab aplikasi di Halaman yang terhubung dengan aplikasi yang membuatnya.
Hal ini memang disengaja. Kami tidak memperbolehkan adanya banyak domain arbitrer demi alasan keamanan.
Perilaku ini memang disengaja. Dialog Masuk menggunakan ukuran lebar yang tetap dan tidak akan disesuaikan skalanya agar pas dengan layar yang lebih besar.
Perilaku ini memang disengaja. Tanggung jawab pengembang adalah menetapkan 'redirect_uri' yang benar berdasarkan perangkat pengguna, dan oleh karena itu, jika pengguna menggunakan perangkat seluler, maka 'redirect_uri' harus berupa URL situs seluler.
Perilaku ini memang disengaja, karena perilaku ini mencegah adanya potensi kerentanan keamanan. Beberapa browser akan membubuhkan fragmen hash dari URL ke ujung URL yang baru sebagai tempat pengarahannya (jika URL baru tersebut tidak memiliki fragmen hash).
Misalnya, jika example1.com menghasilkan pengarahan ulang ke example2.com, maka browser yang mengunjungi example1.com#abc akan membuka example2.com#abc, dan konten fragmen hash dari example1.com akan dapat diakses oleh skrip di example2.com.
Karena satu alur autentikasi dapat mengarahkan ulang ke alur autentikasi lainnya, maka data autentikasi yang sensitif dari suatu aplikasi dapat diakses oleh aplikasi lain. Hal ini dipermudah dengan membubuhkan fragmen hash baru ke URL pengarahan ulang guna mencegah perilaku browser ini. Jika Anda mengkhawatirkan estetika maupun perilaku pihak klien dari URL yang dihasilkan, maka Anda dapat menggunakan window.location.hash (atau bahkan pengarahan ulang pihak server milik Anda sendiri) untuk menghapus karakter yang mengganggu.
Test apps created from Business apps will have Standard Access for all permissions and features.
No. The access level model only applies to permissions and features.
No. For a given permission, Business apps have either None, Standard, or Advanced Access.
Yes. A Business app will be auto-granted Standard Access and may request Advanced Access for a given permission.
Yes. For Business apps, the Advanced Access level includes access to all data within the Standard Access level.
Untuk membagikan URL, gambar terkait harus berukuran setidaknya 200x200 piksel. Jika tidak, maka Anda akan menerima pesan kesalahan yang sama seperti ini "og:image yang disediakan tidak cukup besar. Harap gunakan gambar yang setidaknya berukuran 200x200 piksel."
Untuk mengambil gambar untuk URL, pertama-tama kami melihat tag 'og:image' Anda, melihat ada tidaknya tag tersebut, dan melihat apakah sudah memenuhi persyaratan 200x200 piksel. Jika tag 'og:image' tidak ada, maka kami memilih gambar pertama yang kami temukan di halaman web.
Jika Anda mendapatkan pesan kesalahan namun Anda merasa bahwa gambar situs Anda berukuran lebih besar dari 200x200 piksel, maka Anda harus memverifikasi bahwa Anda telah menetapkan tag 'og:image' dengan benar, karena kemungkinan besar penyebabnya adalah karena kami mengambil gambar yang salah dari situs Anda.
Kami telah mengubah perilaku pembagi plugin agar konsisten dengan plugin dan fitur lainnya di platform kami.
Pembagi tidak akan dapat menerima parameter khusus lagi dan facebook akan menarik informasi yang ditampilkan di cuplikan, sebagaimana informasi tersebut muncul di facebook sebagai kiriman, dari tag meta OG URL.
Anda tidak dapat menindih 'caption' di URL yang dibagikan, hanya 'title' dan 'description' saja.
Sebuah aplikasi tidak dapat mengunggah album yang dibuat oleh aplikasi lainnya.
Pada beberapa kasus, album yang dimaksud tidak berhubungan dengan aplikasi apa pun (album foto Dinding). Kami menyarankan untuk memeriksa kolom can_upload. Jika kolom can_upload menjawab false, maka hal tersebut berarti pengguna tidak dapat menaruh foto secara langsung di album ini melalui tampilan Album di profil mereka.
Ajakan bertindak akan ditampilkan di bawah ikon 'putar ulang' setelah video diselesaikan.
GIF harus berukuran kurang dari 8 MB agar dapat diputar di Facebook.
Saat ini tidak ada dukungan untuk pembuatan komentar untuk kiriman yang tidak diterbitkan melalui API.
Kiriman video yang dibuat berderet tidak ditampilkan di endpoint promotable_posts karena kiriman tersebut telah dipromosikan. Kiriman video yang dibuat berderet adalah kiriman yang dibuat sebagai bagian dari pembuat iklan, dan oleh karena itu, kiriman tersebut tidak dapat dipromosikan secara terpisah.
Kiriman yang dibuat berderet tidak akan muncul di endpoint /promotable_posts.
Ini dapat terjadi jika Anda menggunakan Token Akses Halaman, ketika pengguna yang terkait token tersebut terdaftar sebagai seorang analis di Peran Halaman di Pengaturan halaman Anda.
Ketika membuat permintaan data menggunakan API Graf, berbagai peraturan privasi dapat berlaku sehingga menyebabkan data tertentu tidak dikembalikan, sekalipun data tersebut dapat Anda lihat di situs web. Ada berbagai macam faktor yang dapat menyebabkan ini, seperti pengaturan privasi pengguna, izin level aplikasi, dst. Ini berarti data yang dihasilkan oleh API tidak selalu menyertakan semua data yang dilihat di situs web.
Jika kiriman dibuat menggunakan 'object_story_spec' API Iklan, maka kiriman ini dikategorikan sebagai kiriman berderet. Untuk dapat melihat kiriman tersebut, Anda perlu menggunakan /{page-id}/promotable_posts edge dan menggunakan modifier 'is_inline' di v2.3 dan versi sebelumnya, dan 'include_inline' di v2.4 dan versi setelahnya. Anda dapat membaca lebih lengkap di sini.
Kolom bagikan akan kembali ketika kiriman dibagikan lebih dari 10 kali. Jika sebuah kiriman telah dibagikan kurang dari 10 kali, maka kami dapat menghapus kolom ini atau mencoba mengembalikan angka.
Anda dapat mencari tahu selengkapnya tentang endpoint ini di sini: https://developers.facebook.com/docs/graph-api/reference/v2.4/post.
Ini adalah nilai lama yang digunakan di infrastruktur lama kami, dan kami mempertahankannya demi kompatibilitas mundur ketika kami beralih ke infrastruktur baru.
Ini akan terjadi untuk kiriman lama dan tidak terjadi untuk kiriman terkini.
Fungsi ini bekerja sebagaimana mestinya. Tidak ada hubungannya antara kiriman dan foto di dalam kiriman. Kami hanya mengembalikan gambar pertama yang diunggah di dalam kiriman.
Kolom 'application' tidak akan dikembalikan jika kiriman diatribusikan ke situs web atau aplikasi seluler Facebook. Ini sesuai dengan situs yang tidak menunjukkan atribusi untuk jenis kiriman tersebut.
Kolom "privacy" sebuah Kiriman akan menyertakan informasi tentang kiriman tersebut di Facebook, namun ketika Kiriman Halaman ditargetkan atau dibatasi sehingga hanya dapat dilihat oleh pemirsa tertentu, maka informasi di kolom "privacy" tidak menunjukkan semua opsi penargetan yang dipilih.
Untuk melihat detail selengkapnya tentang cara Kiriman ditargetkan atau dibatasi, periksa kolom 'targeting' (untuk pembatasan), dan kolom 'feed_targeting' (untuk Penargetan Kabar Berita). Harap lihat dokumen Kiriman untuk informasi selengkapnya tentang kolom yang tersedia.
Nilai comment_count yang dihasilkan untuk sebuah kiriman dapat menyertakan komentar yang disembunyikan atau dihapus. Jumlah komentar yang dapat dilihat di sebuah kiriman tidak akan pernah melampaui jumlah comment_count.
Anda tidak dapat menimpa 'caption' URL yang dibagikan. Anda hanya dapat menimpa 'title' dan 'description' URL itu.
Untuk informasi selengkapnya dan kolom yang dapat Anda terbitkan melalui API Graf, lihat dokumen /feed di sini: https://developers.facebook.com/docs/graph-api/reference/v2.3/page/feed#publish
Aslinya memang sudah dirancang seperti itu. Hal ini disesuaikan dengan cara aplikasi Facebook (seluler maupun web) menciptakan konten yang muncul (tanpa atribusi ke Facebook).
Kami telah membuat pembaruan pada cara memperoleh dan menampilkan data aliran dan data kiriman melalui API.
Jika Anda menemui permasalahan dalam memperoleh kiriman dari API dan Anda yakin API tidak bekerja sebagaimana tercantum di dokumen, harap verifikasi hal berikut -
Foto yang diunggah melalui Instagram diterbitkan sebagai tindakan Graf Terbuka, dan memerlukan izin Graf Terbuka yang benar untuk dapat dibaca dari API Graf.
Pada kasus foto Instagram, izin yang diperlukan adalah "user_actions:instapp", karena "instapp" merupakan ruang nama aplikasi Instagram.
Tindakan Graf Terbuka tidak muncul di koneksi /feed, namun ketika ada foto yang diunggah sebagai tindakan Graf Terbuka, maka tindakan tersebut dapat diakses dengan izin melalui koneksi album pengguna atau koneksi /photos jika berlaku.
Informasi selengkapnya tentang izin Graf Terbuka dapat ditemukan di sini.
Hal itu memang disengaja. Sistem kami menghasilkan pesan kesalahan di atas untuk objek yang telah dihapus atau tidak terlihat demi pemeriksaan privasi/izin.
Perilaku ini telah diantisipasi dan bentuk penandaan halaman seperti ini tidak didukung untuk komentar.
Kolom total_count untuk parameter rangkuman untuk endpoint /{user-id}/accounts dapat mengembalikan angka yang lebih tinggi dari yang diantisipasi. Ini karena total_count mencakup halaman yang dihapus dengan pengguna juga sebagai pengurusnya.
Data yang dikembalikan oleh endpoint itu sendiri, bagaimanapun juga, hanya akan menyertakan halaman yang tidak dihapus.
Endpoint /user/likes telah berubah dari penanda halaman berbasis waktu (yang menggunakan 'since' dan 'until' sebagai parameternya) menjadi penanda halaman berbasis kursor (yang menggunakan parameter 'before' dan 'after').
Anda dapat mengetahui selengkapnya tentang perbedaannya di sini: https://developers.facebook.com/docs/graph-api/using-graph-api/v2.3#paging
Dengan perkenalan user-id di lingkup aplikasi, kami telah membuat perubahan pada cara endpoint mengembalikan data kembali.
Karena v1.0 telah ditiadakan, kami akan fokus pada v2.x di sini. /v2.0/{id} akan mengembalikan https://www.facebook.com/{id}, atau mungkin akan mengembalikan https://www.facebook.com/app_scoped_user_id/{id}.
Hal ini memang disengaja. Kesalahan tersebut berarti token akses yang tengah Anda coba perpanjang tidak dapat mengakses ID aplikasi yang mencoba memperpanjang token itu.
Kemungkinan besar penyebab hal ini adalah apabila aplikasi Anda menerapkan batasan demografis dan kami mendeteksi bahwa pengguna yang tokennya tengah Anda coba perpanjang tidak memenuhi batasan tersebut (atau tidak lagi memenuhi batasan tersebut, dikarenakan pindah lokasi atau kami telah memiliki deteksi lokasi yang lebih akurat).
Kemungkinan berikutnya adalah kami tidak dapat mengonfirmasi bahwa pengguna telah memenuhi persyaratan (mis. kami tidak tahu lokasinya), dan batasan aplikasi Anda tidak memungkinkan pengguna tersebut untuk mengakses aplikasi.
Sejak bulan Juli 2013, Anda tidak dapat menggunakan endpoint pencarian dengan menggunakan email di jenis pencarian pengguna lagi.
Selain itu, terdapat beberapa perubahan untuk api graf dengan diperkenalkannya v2.0. Kemampuan untuk melakukan pencarian kiriman publik dan pencarian kata kunci tidak tersedia di v.2.0.
Buka catatan perubahan untuk detail selengkapnya.
Aplikasi apa pun yang dibuat setelah tanggal 30 April 2014 menggunakan API versi 2 dan versi berikutnya, yang hanya akan dapat mengembalikan teman aplikasi Anda dengan endpoint /me/friends
, sebagaimana yang Anda cantumkan. Selain itu, semua ID pengguna kini merupakan ID lingkup aplikasi yang bersifat unik dan permanen untuk aplikasi tertentu Anda.
Anda dapat mempelajari selengkapnya tentang semua fitur dan perubahan baru yang diperkenalkan sebagai bagian dari v2.0.
Dokumen untuk kolom email
objek User
menjelaskan perilaku yang diantisipasi di sini, yaitu: "kolom ini tidak akan dikembalikan jika tidak ada alamat email yang valid".
Ada beberapa situasi yang membuat Anda mengira bahwa pengguna harus dapat memperoleh pengembalian alamat email namun tidak bisa. Karena alasan privasi dan keamanan, alasan penyebab alamat email tidak dikembalikan tidak dapat dijelaskan secara rinci.
Beberapa kemungkinan yang menyebabkannya:
Kiriman ini tidak dapat diperoleh melalui API karena konten pengguna di kiriman tersebut dibagikan ulang di halaman, dan pengguna belum memberi izin kepada aplikasi untuk melihat kontennya.
Kiriman Pengguna yang dibagikan di linimasa halaman tidak akan tersedia melalui API apabila pengguna memiliki izin dasar untuk jenis konten kiriman tersebut.
Sebagai solusi untuk melihat kiriman foto yang hilang dari penggemar, Anda dapat memperoleh album halaman menggunakan token akses halaman - foto tersebut harus berada di album Foto Linimasa
Sekalipun kiriman bersifat publik dan menyebutkan Halaman yang diminta, Aplikasi Anda tidak dapat melihat kiriman tersebut tanpa izin read_stream dari pemilik kiriman tersebut. Ini berarti bahwa endpoint {page_id}/tagged tidak akan menghasilkan semua kiriman.
Anda dapat membaca selengkapnya tentang ini di dokumen Kabar Berita Halaman.
Terdapat kasus aplikasi tertentu (atau aplikasi mana pun) yang tidak dapat memperoleh informasi apa pun tentang pengguna Facebook karena pengaturan privasi pengguna tersebut - ini mencakup ketika mengakses kiriman yang dibuat oleh pengguna tersebut dalam konteks yang memungkinkan aplikasi Anda untuk melihat kiriman tersebut (mis. pengelolaan halaman)
Misalnya, ketika pengguna memblokir aplikasi, atau telah mencegah semua aplikasi platform untuk mengakses informasi pengguna tersebut melalui API.
Dengan adanya perilisan v2.1 API Graf, fungsi ini telah dihapus. Untuk aplikasi yang dibuat sebelum 7 Agustus 2014, kolom ini tidak muncul di signed_request lagi.
Untuk aplikasi yang dibuat sebelum tanggal ini, properti suka akan selalu menghasilkan true tanpa melihat apakah orang tersebut telah menyukai halaman atau belum.
Harap gunakan tautan paging.next dan paging.previous yang dikembalikan dalam tanggapan secara langsung untuk memperoleh halaman hasil lainnya. Dengan menggunakan tautan yang diberikan, maka aplikasi Anda tidak akan malfungsi ketika format tautan penanda halaman berubah pada waktu mendatang.
Seperti sebagian besar item di API, hal tersebut tidak berarti bahwa pemetaan fitur dan fungsi di situs utama Facebook akan bersifat persis 1:1. Apa yang dianggap sebagai jangkauan organik oleh UI Wawasan Halaman jauh berbeda dan dihitung secara berbeda dari jangkauan Organik melalui API.
Misalnya, nilai 'organic' di UI Wawasan Halaman terkait dengan nilai 'unpaid' di metrik page_impressions_by_paid_non_paid_unique yang tersedia melalui API Graf.
Kami berniat untuk menyelaraskan kedua-duanya, namun upaya ini akan memerlukan waktu cukup lama.
Kesalahan ini menandakan bahwa pengguna yang berhubungan dengan token akses ini tidak dapat menggunakan halaman ini dikarenakan alasan keamanan. Misalnya, halaman mungkin tidak diterbitkan dan pengguna juga bukan merupakan pengurus halaman yang valid.
Kesalahan ini umumnya terjadi ketika Anda mencoba memperoleh wawasan untuk halaman yang sangat aktif. Ini dapat dihitung karena jika Anda mengurangi interval waktu permintaan wawasan dengan menggunakan kolom 'since' dan 'until'.
Perilaku ini telah diantisipasi untuk aplikasi tes dan aplikasi di mode pengembangan. Setelah aplikasi diterbitkan, kiriman yang dijadwalkan akan berfungsi sesuai harapan.
Bug terkait untuk batasan pada rancangan ini dapat dilihat di sini
Hanya Pengurus, Penyunting, atau Moderator yang dapat membaca dan mengirimkan pesan Halaman. Orang-orang yang memiliki peran lain, seperti Pengiklan dan Analis, tidak dapat membaca percakapan Halaman.
Kunjungi halaman bantuan ini untuk mempelajari selengkapnya tentang berbagai peran Halaman: https://www.facebook.com/help/289207354498410.
Jumlah total 'page_fans' dan 'page_fans_country' tidak selalu sama. Ada banyak faktor yang dapat mempengaruhi nilai 'page_fans_country'. Misalnya, beberapa penggemar halaman mungkin tidak menentukan negara asal mereka di akun mereka, atau beberapa penggemar halaman memiliki pengaturan privasi yang menyembunyikan negara asal mereka.
Untuk mencari tahu lebih banyak tentang pengaturan privasi Facebook, harap kunjungi halaman ini di pusat bantuan: https://www.facebook.com/help/445588775451827.
Beberapa kiriman Halaman publik merupakan pembagian ulang dari konten pengguna. Jika Pengguna yang membuat kiriman tersebut tidak memberikan izin yang diperlukan kepada Aplikasi, maka Aplikasi tidak dapat mengakses kirimannya melalui API Graf, dan tidak dapat mengomentari kiriman tersebut.
Kiriman yang dibuat berderet sebagai bagian dari pembuatan Materi Iklan tidak dapat dipromosikan secara terpisah. Oleh karena itu, kiriman tersebut juga tidak akan muncul di panggilan ke endpoint /promotable_posts Halaman.
Ini dapat terjadi jika Anda menggunakan aplikasi yang masih dalam mode pengembangan untuk menjadwalkan kiriman. Harap gunakan aplikasi yang telah selesai dikembangkan dan penerbitan akan berjalan sebagaimana mestinya.
Kami mohon maaf, karena saat ini kami tidak mendukung pembuatan, pembaruan, atau penghapusan foto sampul melalui API.
Untuk mempelajari selengkapnya tentang API foto sampul, silakan kunjungi https://developers.facebook.com/docs/graph-api/reference/cover-photo/#Creating
Anda tidak dapat menyunting ukuran lebarnya melalui API.
Perilaku itu yang berlaku pada saat ini. Pengurus halaman tidak dapat membuat kiriman ke halaman sebagai diri mereka sendiri melalui API Graf - fungsi itu hanya tersedia di http://www.facebook.com/ dan di aplikasi seluler kami.
Tidak, Anda tidak dapat memperoleh daftar yang berisi orang-orang yang telah menyukai Halaman. Aslinya memang sudah dirancang seperti itu.
Pastikan Anda menggunakan token akses halaman ketika melakukan tindakan yang mewakili sebuah halaman. Pesan kesalahan ini menandakan bahwa Anda menggunakan token akses pengguna, alih-alih token akses halaman.
Anda dapat mempelajari berbagai macam token akses di sini: https://developers.facebook.com/docs/facebook-login/access-tokens
Anda tidak dapat melakukannya, karena kiriman yang disematkan dan fitur membaca kiriman yang disematkan hanya tersedia melalui produk Facebook yang bersifat native.
Jika pencerminan komentar sudah dinyalakan untuk URL eksternal di beberapa titik, maka tanggapan pada kiriman tempat komentar dicerminkan akan dicatat di URL itu sendiri, dan akan dikembalikan ketika memanggil {URL-id}/reactions>
Pengambilan data untuk lebih dari 1000 nilai perincian tentang endpoint /app_insights/app_event
saat ini tidak didukung. Kami sarankan menggunakan UI Facebook Analytics untuk memahami poin data tertentu, seperti negara tertentu, jika tertarik untuk memerinci data ke dalam kategori tertentu.
Anda mungkin memanggil endpoint terlalu cepat bahkan sebelum data sampai di server kami.
Panggilan API seharusnya dilakukan setelah menunggu 1-2 detik agar informasi sampai di semua server kami.
Metrik 'page_fans_country' biasanya akan menjadi subset jumlah dari page_fans. Metrik ini mencakup perincian berdasarkan negara penggemar halaman, sehingga kami dapat menentukan negara pengguna secara akurat.
Metrik ini juga mencakup hanya negara teratas (berdasarkan jumlah penggemar) untuk penggemar halaman, tidak semua negara yang terdapat penggemar; untuk halaman dengan penggemar di beberapa negara, negara dengan populasi paling sedikit tidak akan disertakan dalam metrik ini.
API tidak mendukung penggunaan penanda halaman berbasis ofset.
Sebagai gantinya, Anda dapat menggunakan tautan “halaman” yang dikembalikan di akhir setiap tanggapan dari API Graf, atau menggunakan penandaan halaman berbasis “kursor” yang sering kali digunakan.
Informasi selengkapnya tentang cara membuat halaman dengan benar melalui API Graf dijelaskan di sini: https://developers.facebook.com/docs/graph-api/using-graph-api/v2.3#paging
Token akses ada yang berjangka panjang dan yang berjangka pendek. Token jangka pendek ditujukan untuk sesi singkat dan umumnya akan kedaluwarsa setelah beberapa jam.
Anda dapat menukar token jangka pendek dengan token jangka panjang yang memiliki masa berlaku hingga 60 hari.
Anda dapat membacanya di Dokumentasi Token Akses.
Perilaku ini memang disengaja - API pencarian menghargai privasi di Facebook, disesuaikan untuk pengguna yang token aksesnya Anda gunakan, tidak mendukung pencarian tagar, dan tidak dirancang untuk menyerupai pencarian yang dijalankan di typeahead pencarian di Facebook.com.
Kami secara jelas tidak mendukung atau membuat API pencarian mengembalikan hasil dengan volume yang sama atau hasil yang spesifik seperti pencarian di Facebook.com - dan kiriman yang dikembalikan melalui API pada umumnya harus menjalani pemeriksaan privasi dan keamanan yang lebih ketat daripada kiriman yang sama di Facebook sendiri.
Sistem kami menerapkan pembatasan laju di panggilan API yang dibuat oleh Aplikasi. Untuk mempelajari selengkapnya tentang berbagai macam batasan dan mencegah agar Aplikasi Anda tidak terhambat, kunjungi https://developers.facebook.com/docs/marketing-api/api-rate-limiting
Anda dapat menambahkan gambar GIF ke artikel Anda dengan menggunakan elemen <figure> yang membungkus elemen <img> yang mengacu pada URL gambar GIF tersebut. Sama seperti gambar lainnya, Anda dapat menambahkan keterangan dan atribusi ke gambar GIF.
Anda dapat melihat dokumentasi untuk perincian selengkapnya dan contoh di sini.
Anda dapat menggunakan kembali URL umpan di halaman yang berbeda, tetapi harap diperhatikan bahwa hanya artikel yang URL kanonikalnya cocok dengan domain yang diklaim oleh halaman yang akan dipakai.
Pendekatan yang kami sarankan adalah menggunakan umpan RSS terpisah untuk setiap halaman yang hanya berisi artikel yang seharusnya dipakai oleh halaman itu.
Anda dapat menambahkan sematan sosial yang didukung, termasuk video, menggunakan Sematan Sosial. Untuk pemutar video pihak ketiga, Anda dapat menambahkannya ke artikel Anda sebagai Sematan Interaktif.
Anda dapat menyematkan grafik dan konten interaktif di artikel Anda menggunakan <figure> dengan kelas op-interactive. Figur itu harus berisi <iframe>, yang berisi konten yang akan disematkan.
Anda dapat menemukan lebih banyak perincian dan melihat contoh di sini.
Anda dapat menentukan keterangan menggunakan elemen <figcaption> . Di dalam keterangan, Anda dapat menambahkan atribusi menggunakan elemen <cite>.
Anda dapat menemukan lebih banyak perincian dan contoh di dokumentasi di sini.
Apabila artikel sedang dalam mode Konsep, artikel itu hanya akan dapat dilihat sebagai Artikel Instan untuk pengurus halaman. Setelah artikel diterbitkan dan dalam mode Terbit, artikel itu dapat dibagikan oleh siapa pun di Facebook dan akan ditampilkan sebagai Artikel Instan untuk semua orang.
Silakan memeriksa apakah Anda sudah memberi izin pages_manage_instant_articles ke aplikasi. Izin ini diperlukan untuk memanggil metode API guna membaca dan memperbarui Artikel Instan halaman Anda.
Anda dapat mencari tahu selengkapnya tentang menggunakan API di sini.
Jika Anda menggunakan atribut dir="rtl" untuk menampilkan bahasa yang ditulis dari kanan ke kiri di artikel Anda, maka Anda mungkin saja melihat artikel di aplikasi yang tidak mendukung bahasa yang ditulis dari kanan ke kiri di Artikel Instan.
Harap memeriksa apakah Anda menggunakan versi aplikasi yang terbaru. Versi minimal untuk setiap aplikasi yang mendukung bahasa yang ditulis dari kanan ke kiri adalah:
Silakan memeriksa apakah atribut dir="rtl" sudah diatur di tag <body> artikel Anda. Jika artikel Anda tidak menggunakan bahasa yang ditulis dari kanan ke kiri, maka Anda seharusnya tidak mengatur atribut ini di artikel Anda.
Pratinjau Kabar Berita artikel menggunakan gambar yang ditentukan di tag meta og:image di artikel versi web. Anda juga dapat memilih untuk mengganti gambar dengan video dengan cara menambahkan kelas "fb-feed-cover" ke video di artikel Anda. Anda dapat membaca selengkapnya tentang pratinjau Kabar Berita di sini.
Apabila membagikan URL artikel sebelum Artikel Instan diterbitkan, URL itu akan mengalihkan ke artikel versi web seluler. Setelah Artikel Instan diterbitkan, semua tautan yang dibagikan termasuk yang dikirimkan sebelum artikel diterbitkan, akan otomatis menampilkan Artikel Instan ketika dilihat di perangkat seluler.
Saat ini, metrik "tayangan" hanya menyertakan pengguna iOS. Tayangan Android dihitung secara terpisah di metrik "android_views".
Anda dapat memperoleh informasi selengkapnya tentang ini di sini.
Kami belum meluncurkan dukungan untuk kabar pengembangan di Pengelola Halaman untuk Android. Sebagai solusi untuk melihat artikel Anda di Android untuk saat ini, Anda dapat mencoba menambahkan artikel ke kabar produksi Anda sebagai konsep.
Untuk menyunting Artikel Instan, Anda dapat menggunakan antarmuka Halaman. Untuk melakukannya, Anda dapat membuka Halaman Anda di browser dan membuka Alat Penerbitan > Artikel Instan. Anda dapat melihat artikel Anda dan menyuntingnya di sana. Anda dapat membaca selengkapnya tentang hal itu di sini: https://developers.facebook.com/docs/instant-articles/publishing.
Saat ini timeout untuk unduhan umpan adalah 30 detik.
Tidak, tautan yang dibagikan harus berupa URL kanonikal artikel tersebut. Jika URL diubah - misalnya, dengan menambahkan parameter - maka akan dianggap sebagai URL yang berbeda.
Pesan kesalahan atau peringatan yang ditemukan ketika memakai umpan RSS Anda akan ditampilkan di tab Artikel Instan halaman Pengaturan Anda. Anda juga dapat melihat peringatan dan pesan kesalahan untuk masing-masing artikel dengan cara mengeklik artikel dari tab Artikel Instan halaman Alat Penerbitan.
Harap memeriksa apakah umpan RSS Anda mengikuti format yang didokumentasikan di sini.
URL kanonikal artikel Anda juga harus menggunakan domain yang dikonfigurasikan untuk halaman Anda, atau subdomainnya. Jika Anda melihat artikel baru sedang dipakai, tetapi pembaruan untuk artikel yang sudah ada tidak ditampilkan, harap memeriksa apakah Anda sudah menambahkan cap waktu "op-modified".
Anda dapat menemukan informasi selengkapnya tentang ini di sini.
Alasan umum untuk artikel yang tidak diperbarui dari umpan RSS adalah cap waktu op-modified dari artikel di umpan itu sama seperti versi yang terakhir kali kami ambil. Kami memperbarui artikel hanya jika cap waktu lebih baru dari versi terakhir.
Selain itu, Anda juga harus mengonfirmasi bahwa URL kanonikal yang sama digunakan di versi artikel Anda yang diperbarui.
Anda dapat melihat dokumentasi ini untuk informasi selengkapnya tentang bagaimana kami mengambil artikel dari umpan RSS di sini.
Kami berupaya untuk sepenuhnya memuat dan menguraikan umpan RSS Anda dalam waktu 10 detik. Pesan kesalahan ini mengindikasikan bahwa itu gagal.
Salah satu cara untuk mengatasi masalah ini adalah dengan menyertakan lebih sedikit item di umpan RSS Anda, misal hanya dengan menyertakan artikel yang baru/diubah sejak 10 menit terakhir. Karena umpan diambil setiap 3 menit, maka tidak perlu menyertakan artikel yang tidak diubah.
Sayang sekali, kami tidak memiliki daftar alamat IP statis untuk crawler. Namun, Anda dapat menggunakan agen pengguna crawler kami: facebookexternalhit/1.1
Jika pembaruan pada Artikel Instan yang sudah ada dilakukan lebih dari 24 jam yang lalu berdasarkan waktu op-modified, maka akan diabaikan oleh tarikan tersebut. Artinya, waktu pengubahan harus dalam 24 jam dari waktu pengubahan yang diatur di artikel yang sudah ada dan bukan waktu saat ini. Dalam kasus dengan pembaruan diabaikan, Anda dapat melakukan perubahan ke artikel secara manual melalui alat penyuntingan Artikel Instan berbasis web.
Anda dapat menemukan informasi selengkapnya tentang ini di sini.
Harap memeriksa apakah artikel duplikat menggunakan URL kanonikal yang berbeda. Kami menggunakan URL kanonikal artikel sebagai pengidentifikasi uniknya, sehingga artikel yang memiliki URL kanonikal yang berbeda akan diperlakukan sebagai artikel terpisah.
Salah satu masalah yang umum adalah CMS Anda mungkin menerbitkan pembaruan untuk artikel dengan URL yang berbeda, yang mengakibatkan pembaruan dipakai sebagai artikel baru.
Ya, setiap halaman dipetakan dengan unik ke nama domain dan ini adalah pemetaan 1:1. Kami mengharuskan Artikel Instan yang dimiliki oleh halaman tertentu agar memiliki URL kanonikal yang dimiliki domain tertentu atau sub-domain yang sama.
Namun, domain URL Umpan RSS itu sendiri tidak harus cocok dengan domain yang dipetakan ke halaman. Pembatasan ini hanya untuk URL kanonikal artikel di dalam umpan itu.
Jika Anda ingin menerbitkan artikel di halaman yang berbeda tergantung bahasanya, maka Anda harus menyiapkan umpan RSS yang berbeda untuk setiap bahasa dan mengonfigurasi setiap halaman untuk menggunakan umpan RSS yang sesuai.
Tidak, setelah artikel sudah dipakai dari umpan RSS Anda, artikel itu akan tetap disimpan sebagai Artikel Instan hingga artikel dihapus dari alat penerbitan halaman Anda. Lalu Anda dapat menghapusnya dengan aman dari umpan RSS Anda untuk mempercepat pengambilan selanjutnya.
Saat ini, tidak ada cara untuk menerbitkan atau menghapus artikel melalui API, walaupun kami sedang mengerjakannya.
Tombol Suka menggunakan warna Accent yang dikonfigurasi di pengaturan gaya Anda. Silakan memeriksa apakah Anda sudah mengonfigurasikan warna yang dapat dilihat di header Anda.
Selain itu, tombol Suka hanya muncul jika pengguna yang melihat artikel belum menyukai halaman tersebut, jadi tombol itu tidak akan muncul untuk Pengurus halaman yang sebelumnya sudah Menyukai halaman.
Harap memeriksa bahwa Anda tidak menggunakan beberapa tag <br> di dalam satu baris. Untuk membagi teks artikel Anda menjadi beberapa paragraf, kami sarankan menggunakan tag paragraf (<p>) alih-alih jeda baris.
Harap memastikan bahwa Anda sudah menambahkan kelas "op-tracker" ke tag <figure> yang membungkus piksel pelacakan. Tanpa tag ini, itu akan diperlakukan sebagai sematan gambar.
Harap memeriksa apakah Anda menggunakan format file video yang didukung. Anda dapat menemukan daftar semua format video yang didukung di sini.
Anda juga harus memastikan bahwa Anda membungkus sematan video di dalam tag <figure> dengan benar, dan bahwa Anda tidak membungkus video di dalam paragraf (tag <p>).
Peringatan ini biasanya muncul jika Anda membungkus konten tanpa teks - seperti gambar atau sematan interaktif - di dalam paragraf (tag <p>). Paragraf harus berisi teks isi saja, dan konten lainnya harus ditambahkan dengan tag <figure> atau elemen penampung lainnya yang sesuai.
Tidak, elemen Keterangan (<figcaption>) hanya mendukung tag <h1>, <h2>, dan <cite>. Tag paragraf (<p>) tidak didukung.
Saat ini, atribut "senyap" tidak didukung di elemen <video>.
Iklan di artikel didefinisikan menggunakan elemen <figure> HTML5 standar yang membungkus elemen <iframe> yang berisi markup untuk iklan Anda. Anda dapat menerapkan kelas op-ad ke elemen <figure> untuk menentukan iklan di dalam artikel. Ada dua cara untuk menentukan iklan: dengan menentukan URL iklan secara langsung menggunakan atribut "src" di iframe, atau dengan menyematkan set HTML dan skrip unescaped di dalam iframe.
Anda dapat menemukan informasi selengkapnya tentang iklan di sini: https://developers.facebook.com/docs/instant-articles/reference/ad.
Elemen gambar standar tidak mendukung penggunaan gambar SVG. Anda dapat menggunakan sematan interaktif ("op-interactive") dan menambahkan elemen <img> di dalam iframe, dengan atribut "src" diatur ke URL gambar SVG tersebut.
Anda dapat menggunakan elemen Peta yang didokumentasikan di sini: https://developers.facebook.com/docs/instant-articles/reference/map. Ini adalah cara yang disarankan untuk menambahkan peta ke Artikel Instan.
Jika Anda menambahkan sematan Google Maps ke artikel Anda sebagai sematan interaktif, ada masalah dengan cara kerja sematan yang dapat mencegah peta untuk ditampilkan. Untuk mengatasi masalah ini, Anda harus menyertakan iframe yang memuat konten peta ("https://www.google.com/maps/embed?...") di dalam iframe lainnya.
Anda dapat menyematkan modul interaktif dengan menggunakan figur op-interactive. Anda dapat menemukan lebih banyak perincian dan sampel kode di sini: https://developers.facebook.com/docs/instant-articles/reference/interactive.
Untuk menentukan tinggi, tambahkan atribut "tinggi" ke elemen <iframe> yang membungkus sematan konten Anda. Nilai atribut harus berupa nilai bilangan bulat yang menunjukkan tinggi dalam piksel. Anda dapat mengatur tinggi hingga maksimal 960 piksel.
Anda dapat menambahkan sampul dengan menambahkan tag <figure> di dalam header. Anda dapat menggunakan gambar atau video sebagai sampul dengan cara menambahkan tag <img> atau <video> di dalam figur.
Anda dapat mencari tahu selengkapnya tentang sampul di sini.
Untuk menambahkan spasi di antara beberapa gambar, Anda dapat menambahkan paragraf kosong di antara gambar - misalnya, <p> </p>.
Untuk menambahkan atribusi, gunakan elemen <cite> di dalam elemen <figcaption>.
Di Gambar sampul, Anda dapat menentukan atribusi agar selalu dapat dilihat dengan menentukan salah satu atribut Penjajaran Vertikal di elemen <cite> dengan eksplisit. Jika tidak, kutipan Anda tidak akan ditampilkan di gambar hingga gambar diperbesar.
Anda dapat menyematkan konten sosial dengan menambahkan figur dengan kelas "op-social" dan menambahkan iframe yang berisi konten yang akan disematkan.
Anda dapat melihat dokumen ini untuk perincian selengkapnya dan sampel kode.
Anda harus menggunakan tautan langsung ke file video (misal, file mp4) untuk menambahkan sampul. Karena video yang di-host di Facebook tidak menyediakan tautan langsung, Anda harus meng-host video Anda di tempat lain untuk menggunakannya sebagai sampul.
Anda dapat menggunakan beberapa tag HTML di dalam item daftar, misalnya untuk menebalkan teks atau menambahkan tautan. Untuk menyesuaikan warna atau gaya font, Anda dapat menggunakan penyunting gaya di antarmuka Halaman Facebook (Pengaturan->Artikel Instan).
Jika Anda menyematkan video menggunakan elemen HTML <video>, maka hal itu tidak dimungkinkan karena kami tidak mendukung memutar beberapa video secara berurutan.
Jika Anda menyematkan pemutar video sebagai sematan sosial di dalam iframe, maka hal itu dimungkinkan selama pemutar yang disematkan mendukungnya.
Blockquote tidak didukung dan harus ditempatkan di luar tag paragraf.
Jika judul artikel cukup panjang hingga ditampilkan dalam dua baris, maka hanya judul itu yang akan ditampilkan di Kabar Berita. Jika judulnya cukup untuk ditampilkan dalam satu baris, maka pratinjau Kabar Berita juga akan menampilkan awal teks artikel itu.
Harap memeriksa bahwa Anda tidak menambahkan atribut "data-fb-disable-autoplay" ke video Anda.
Jika video tidak diputar secara otomatis untuk orang tertentu, maka periksa apakah pemutaran otomatis video tidak dinonaktifkan di pengaturan aplikasi Facebook. Anda dapat menemukan petunjuk untuk memeriksanya di sini.
Anda dapat menampilkan video di pratinjau Kabar Berita dengan cara menambahkan kelas "fb-feed-cover" ke video di artikel Anda. Anda dapat membaca selengkapnya tentang pratinjau Kabar Berita di sini
Diharuskan untuk menyertakan elemen <time> di markup HTML setiap artikel Anda, dengan menggunakan kelas op-published, untuk menentukan tanggal/waktu ketika artikel pertama diterbitkan.
Kelas op-modified tidak diharuskan. Anda hanya perlu menyertakan elemen <time> dengan kelas ini jika Anda memperbarui konten artikel dan ingin agar kami memperbarui versi artikel yang kami simpan.
Harap memeriksa apakah Anda sudah membungkus teks di dalam paragraf (tag <p>). Anda dapat mencari tahu selengkapnya tentang membuat markup artikel di sini.
Harap memeriksa apakah <figure> Anda tidak dibungkus di dalam paragraf (tag <p>). Gambar harus berada di dalam tag figur yang langsung berada di bawah tag artikel.
Sayangnya, tidak dimungkinkan untuk menambahkan keterangan ke setiap gambar di tayangan slide. Anda hanya dapat menambahkan satu keterangan ke seluruh tayangan slide.
Anda dapat melihat dokumentasi tentang Tayangan slide untuk perincian selengkapnya.
Anda dapat menambahkan suka atau komentar ke gambar dengan cara menentukan atribut "data-feedback" di tag <figure> yang berisi gambar tersebut. Misalnya, menambahkan atribut data-feedback="fb:likes,fb:comments" akan menampilkan baik suka maupun komentar di gambar.
Untuk informasi selengkapnya, Anda dapat melihat dokumentasi untuk atribut masukan.
Ketika menentukan lebar untuk item seperti sematan interaktif, harap menggunakan nilai bilangan bulat yang menentukan lebar dalam piksel. Secara default, item ditampilkan dengan lebar penuh.
Untuk menampilkan sematan interaktif tanpa margin, Anda dapat menambahkan kelas "no-margin" ke iframe yang berisi konten Anda.
Jika kami sudah menyetujui umpan RSS untuk halaman Anda, maka Anda tidak perlu mengajukan ulang untuk persetujuan jika Anda mengubah URL umpan.
Kami memetakan setiap halaman ke nama domain unik. URL umpan RSS itu sendiri tidak harus cocok dengan nama domain ini. Namun, URL kanonikal setiap artikel Anda di dalam umpan itu harus dimiliki oleh domain yang sama atau subdomainnya. Jika Anda hanya mengubah URL umpan RSS, maka ini tidak akan menimbulkan masalah.
Jika Anda juga memperbarui URL kanonikal artikel untuk menunjuk domain baru, maka Anda harus meminta pembaruan domain melalui Pengelola Mitra Anda dan Pengelola Mitra Anda harus dapat memandu Anda selama proses itu.
Pastikan Aplikasi Facebook Anda memiliki ID iPhone Store yang nyata, ID iPad Store (untuk keperluan pengujian, ini tidak harus berupa ID Anda yang sebenarnya, Anda dapat menggunakan salah satu aplikasi yang tersedia di Apple App Store) yang ditetapkan, dan menyalakan iOS - iPad di Platform Daftar Pusat Aplikasi Platform Anda.
Aslinya memang sudah dirancang seperti itu. Dialog kabar berita menerbitkan konten dengan lampiran, sehingga dialog tidak dapat menyesuaikan lampiran tambahan.
Silakan melihat dokumen ini untuk beberapa praktik terbaik guna mengoptimalkan gambar agar menghasilkan cuplikan yang bagus di sini.
Data tanggapan hanya tersedia jika pengguna masuk ke aplikasi Anda dengan menggunakan Facebook dan sudah memberikan publish_actions. Ini juga didokumentasikan di sini.
Perubahan ini memang disengaja. Kami telah memperpendek daftar teman guna membuat permintaan game menjadi lebih relevan untuk pemain yang tepat. Harap perhatikan bahwa pemain masih dapat memilih teman sebanyak mungkin dengan menggunakan kolom Pencarian.
Kabar baiknya adalah perubahan ini membuat kami dapat melihat adanya peningkatan dalam jumlah klik dan peningkatan yang kentara dalam CTR keseluruhan. Kami berniat untuk terus mengoptimalkan saluran ini, dan menemukan cara-cara baru untuk memastikan bahwa game yang tepat muncul di hadapan orang yang tepat.
Crawler akan mencari rekaman AAAA dan mengembalikan kode tanggapan 0 jika tidak ditemukan. Pastikan rekaman AAAA Anda diupdate dengan benar saat Anda mengubah URL atau server Anda.
Lihat Mengupdate URL untuk informasi selengkapnya.
Mengubah og:title, og:image, dll. hanya berlaku pada berbagi selanjutnya dari tautan itu.
Begitu seseorang atau halaman membagikan suatu tautan, dan sudah ada lebih dari 50 interaksi dengan postingan itu (komentar, suka, berbagi, dll.), maka judul tidak dapat diubah. Ini untuk mencegah situs agar tidak mengubah detail tautan setelah Anda berinteraksi dengan tautan itu, menjadikannya seakan-akan Anda berinteraksi dengan hal berbeda. Semua properti lain dapat dimodifikasi kapan saja.
Jika Anda membagikan tautan dan mengupdate gambar, berbagi yang asli akan terus menampilkan gambar lama, kecuali Anda memuat ulang dalam postingan tersebut.
Untuk memuat ulang gambar tautan dalam suatu postingan:Kami membekukan judul setelah beberapa tindakan diambil terhadap obyek tersebut (penjelasan di sini: Memperbarui URL.
Banyak faktor yang memengaruhi bagaimana sebuah gambar dipotong. Contoh: kami mencoba memusatkan gambar di sekitar wajah yang dapat kami deteksi.
Untuk gambar besar, cobalah agar gambar Anda sedekat mungkin dengan rasio aspek 1,91:1 untuk menampilkan gambar penuh di Kabar tanpa pemotongan apa pun.
Kiriman halaman selalu menggunakan gambar besar dan lanskap untuk membagikan tautan. Hal ini berlaku di seluruh Kabar desktop dan seluler. Cobalah agar gambar Anda sedekat mungkin dengan rasio aspek 1,91:1 untuk menampilkan gambar penuh di Kabar tanpa pemotongan apa pun.
Tautan Anda mungkin sudah ditandai oleh sistem pemfilteran konten kami. Jika Anda yakin bahwa ini adalah kesalahan sistem, harap kirimkan laporan ke Situs Bantuan kami; pastikan bahwa Anda menyertakan URL yang relevan.
Gambar disinggahkan secara asinkron, jadi gambar dapat tidak di-render saat seseorang membagikan konten Anda untuk pertama kali. Anda dapat menghindari hal ini baik dengan:
og:image:height
dan og:image:width
untuk menandai gambar secara eksplisit Semua berbagi dan suka ditautkan dengan URL khusus (yang kami sebut URL Kanonik). Mengubah struktur situs untuk menggunakan URL baru berarti mulai mengatribusikan suka dan berbagi ke URL baru itu.
Lihat Mengupdate URL untuk informasi selengkapnya.
Semua berbagi dan suka ditautkan dengan URL khusus (yang kami sebut URL Kanonik). Mengubah struktur situs untuk menggunakan URL baru berarti mulai mengatribusikan suka dan berbagi ke URL baru itu.
Lihat Mengupdate URL untuk informasi selengkapnya.
Gambar yang beresolusi kurang dari 600 x 315 piksel tetapi lebih besar dari 200 x 200 piksel akan di-render dengan gambar kecil dan persegi.
Kami mempertimbangkan agar semua URL gambar tidak berubah, karena URL tersebut digunakan untuk cache sumber daya di beragam lapisan, jadi jika Anda harus mengganti sebuah gambar, Anda juga harus menggunakan URL baru. Jika cache sudah usang, kami akan mengambil gambar baru dan masalah akan terpecahkan dengan sendirinya.
Jika Anda menggunakan URL berbeda, tetapi tetap melihat gambar lama, Anda dapat membuka Debugger Berbagi dan menyalin ulang URL:
Semua URL harus mutlak karena mewakili lokasi utama sumber daya (halaman/gambar), agar kami dapat mengatribusi berbagi dan suka ke URL yang benar dan melakukan cache gambar secara tepat.
Gambar aslinya sudah tidak ada, terlalu besar, atau tidak dapat diambil karena masalah sementara. Pastikan URL gambar dapat diakses oleh crawler kami, tidak lebih dari 8mb, dan disajikan dengan kurang dari beberapa detik latensi.
Saat Anda mengubah og:image untuk sebuah halaman, pastikan Anda tidak menghapus gambar lama dari situs Anda, kalau tidak, berbagi yang ada akan menampilkan area putih ini.
Ini disebabkan oleh lag replikasi di pusat data kami. Dibutuhkan waktu beberapa detik untuk menyelesaikan proses ini, sebelum proses selesai, ID objek tidak akan dapat diakses melalui API.
Jika Anda berupaya membaca detail iklan sebelum disimpan sepenuhnya, Anda dapat menerima GraphMethodException
dengan sebuah pesan seperti Unsupported get request. Object with ID 'XXXXXXXXXXXXXXXXXX' does not exist, cannot be loaded due to missing permissions, or does not support this operation.
Menunggu sebentar sebelum mencoba untuk MENDAPATKAN detail iklan akan menyelesaikan masalah ini.
Terkadang Anda dapat menemui kesalahan validasi ketika mencoba menggunakan materi iklan tertentu di dalam sebuah kampanye. Ini dapat terjadi ketika kampanye memiliki tujuan yang tidak kompatibel dengan materi iklan yang Anda gunakan. Salah satu contoh penyebabnya adalah ketika materi iklan Anda mengarah ke game canvas, sementara tujuan kampanye adalah "MOBILE_APP_INSTALLS".
Guna menyelesaikan kesalahan validasi yang Anda lihat, Anda dapat mengikuti Praktik Terbaik Validasi API Marketing.
Harap memastikan bahwa sesi unggah yang tidak memuat item yang dimaksud tidak memuat kegagalan.
Item hanya akan dihapus hingga tidak tersedia di kabar berita sesi unggah yang berhasil ketika deletion_enabled ditetapkan menjadi true.
Jika Anda menemui kesalahan ini, harap periksa status akun iklan yang bersangkutan. Kesalahan ini sering kali terjadi ketika akun iklan belum dituntaskan.
Perilaku ini telah diantisipasi, karena data di backend Wawasan Halaman hanya disimpan selama 2 tahun saja. Oleh karena itu, panggilan ini diperkirakan untuk menghasilkan nilai nol. Item yang tidak memiliki nilai nol adalah deretan suka/komentar/bagikan kiriman yang datanya tetap dimiliki oleh kiriman itu sendiri.
Periksa syntax spesifikasi penargetan untuk memastikan bahwa spesifikasi penargetan tersebut memiliki parameter dan nilai geo_locations yang valid.
Ketika Anda membuat iklan dengan tujuan tertentu, maka spesifikasi konversinya akan ditetapkan secara default. Jika Anda mengubah spesifikasi konversi tersebut, maka spesifikasi yang ada akan ditulis ulang.
Perhatikan bahwa beberapa tujuan tertentu tidak akan memiliki spesifikasi konversi default dan harus ditentukan secara jelas.
Ini dapat terjadi karena pemirsa work_positions untuk negara yang Anda tergetkan berukuran sangat kecil sehingga tidak berdampak pada estimasi jangkauan. Kami terus mengumpulkan data yang diharapkan untuk dapat meningkatkan jumlah orang yang ditambahkan ke pengecualian work_positions, sehingga memberi dampak pada estimasi jangkauan.
Ini terjadi karena aplikasi Anda menyalakan migrasi Streaming keamanan URL kiriman.
Jika aplikasi Anda menyalakan pengaturan tersebut, maka sistem tidak akan memperbolehkan pembuatan jenis iklan kiriman tautan apa pun, kecuali jika iklan tersebut mengarahkan ulang ke url canvas yang terdapat di pengaturan aplikasi Anda. Anda tidak diharuskan untuk menyalakan pengaturan tersebut, kecuali jika aplikasi Anda berupa aplikasi canvas yang hanya mengirimkan stories yang mengarahkan ulang ke domain aplikasi canvas tersebut.
Pengguna tersebut kemungkinan berhubungan dengan akun melalui hubungan Pengelola Bisnis, sehingga kemunculan pengguna tersebut tidak tampak dalam hubungan API Graf yang eksplisit.
Harap konfirmasi bahwa Kategori Mitra Anda ditentukan di kolom penargetan yang benar. Kategori Mitra yang diperoleh dari endpoint “/partnercategories” memuat kolom yang bernama “targeting_type” yang menentukan kolom penargetan yang perlu Anda gunakan ketika menentukan Jenis Penargetan.
Misalnya jika Kategori Mitra Anda menghasilkan “targeting_type” dari “behaviors”, maka Anda harus menggunakan Kategori Mitra itu di kolom “behavior” spesifikasi penargetan Anda.
Informasi selengkapnya tentang Jenis Penargetan dan Kategori Mitra dapat ditemukan di sini: https://developers.facebook.com/docs/marketing-api/partnercategories/v2.3#targeting_types
Kesalahan ini bisa jadi disebabkan oleh Pemirsa Khusus yang tidak memiliki set inclusions/exclusions. Cara terbaik untuk menangani masalah ini adalah dengan membuat Pemirsa Khusus dan memastikan Anda menetapkan inclusions/exclusions.
Informasi selengkapnya untuk pemirsa khusus tersedia di sini: https://developers.facebook.com/docs/marketing-api/custom-audience-targeting/v2.3.
Set Iklan dapat memiliki daily_budget dan lifetime_budget. Nilai daily_budget yang ditentukan di mata uang akun Anda setidaknya harus sebanyak 100 sen dan durasinya harus lebih dari 24 jam. Jika Anda mengirim kueri ke kolom tersebut, maka kolom tersebut akan dikembalikan. Nilai 0 akan dikembalikan ketika ada sebuah kolom yang tidak digunakan.
Untuk mempelajari selengkapnya, kunjungi: https://developers.facebook.com/docs/reference/ads-api/adset.
Endpoint adcampaign_groups menggunakan penandaan halaman berbasis kursor, sehingga tidak mengembalikan hitungan, batasan, dan kolom ofset. Kami menyarankan untuk menggunakan penanda halaman berbasis kursor untuk semua endpoint guna memperoleh hasil yang konsisten.
Untuk informasi selengkapnya tentang cara menggunakan penanda halaman kursor, lihat alamat ini: https://developers.facebook.com/docs/graph-api/using-graph-api/v2.0#paging.
Hal tersebut dapat dikarenakan beberapa kiriman dibuat berderet. Untuk memperoleh kiriman berderet ini, harap lihat catatan di kolom /promotable_posts "is_inline" di bawah bagian dokumen ini: https://developers.facebook.com/docs/reference/ads-api/adcreative/v2.2#object_story_spec
Asalkan pengguna membalas pertanyaan pertama, jendela pengiriman pesan akan terbuka. Jika jawaban yang diberikan membuat pengguna didiskualifikasi atau pengguna tidak membalas, pengalaman iklan akan berakhir dan iklan akan menyerahkan kontrol utas ke aplikasi target dan memberikan metadata "messenger_lead_gen_incomplete". Dengan begitu, bisnis bisa memiliki pengalaman fallback untuk mengonversi non-prospek menjadi pelanggan. Baca Webhook HOP setelah Iklan Prospek untuk mendapatkan info selengkapnya
Kirim Ringkasan secara default diaktifkan hanya saat Aplikasi dipilih, di dialog Buat Template di dalam Iklan. Ingat, ringkasan bisa dinonaktifkan pada iklan setelah memilih Aplikasi yang terhubung. Bahkan saat aplikasi tidak dipilih, Iklan Penciptaan Prospek akan menyerahkan kontrol utas ke penerima utama Serah Terima, jika diatur, atau melepaskan kontrol utas. Semua pesan tindak lanjut setelah prospek diajukan akan dikirim ke Aplikasi yang dijadikan langganan. Aplikasi bisa meminta Conversation API untuk mengambil riwayat pesan dan mendapatkan informasi yang dibagikan selama penciptaan prospek.
Secara Default, Send API dan Webhooks diblokir saat Iklan Penciptaan Prospek sedang berjalan. Id Aplikasi: 413038776280800 untuk Aplikasi Penciptaan Prospek Messenger akan memiliki kontrol utas. Perilaku ini bisa dinonaktifkan menggunakan tombol Blokir Send API di dialog Buat Template di dalam Iklan
Setelah pengajuan prospek berakhir, Aplikasi akan mendapatkan webhook tentang pesan pengguna dan bisa membalasnya. Jika aplikasi dipilih sebagai bagian dari Aplikasi, hanya aplikasi terpilih tersebut yang bisa membalas dan akan mendapatkan webhook tentang saluran pengiriman pesan. Jendela pengiriman pesan terbuka dan Aplikasi bisa membalas menggunakan Send API
Aplikasi diinstal dari situs web aplikasi menggunakan Facebook Login dan memberi izin pages_messaging ke Halaman tertentu. Aplikasi Resmi akan muncul di Pengaturan halaman di dalam Pesan lanjutan.
Hanya Aplikasi Resmi untuk Halaman yang akan ditampilkan. Anda bisa melihat Aplikasi resmi di Pengaturan halaman di dalam Pesan lanjutan. Aplikasi diinstal dari situs web aplikasi menggunakan Facebook Login dan memberi izin pages_messaging ke Halaman tertentu.
Pengalaman obrolan otomatis (yaitu 'bot') harus mengungkapkan bahwa orang tersebut sedang berinteraksi dengan layanan otomatis:
Pelajari selengkapnya tentang kebijakan ini di sini.
Jika diwajibkan oleh hukum yang berlaku, pengalaman obrolan otomatis (yaitu 'bot') harus mengungkapkan bahwa seseorang sedang berinteraksi dengan layanan otomatis. Ini juga merupakan praktik yang baik meskipun tidak diwajibkan oleh hukum yang berlaku, sehingga pengguna tidak terkejut. Anda dapat membaca selengkapnya tentang kebijakan ini di sini.
Ya, satu aplikasi Facebook dapat berlangganan lebih dari satu halaman. Setelah dikirimkan untuk peninjauan aplikasi, seperti izin pages_messaging, aplikasi dapat berlanggan lebih dari satu halaman untuk menerima webhook. Anda akan dapat memilih untuk mendapatkan konteks setiap webhook berdasarkan payload.
Ya, satu halaman bisa dikaitkan dengan beberapa aplikasi. Saat beberapa aplikasi menangani percakapan yang sama, sebaiknya gunakan Protokol Serah Terima untuk menangani bot mana yang memiliki utas pada waktu tertentu.
Berikut ini adalah solusi sementara untuk menggunakan pengguna uji platform pada integrasi platform messenger Anda:
https://graph.facebook.com/v2.6/me/accounts?access_token=[TEST_USER_ACCESS_TOKEN](Dokumentasi)
https://graph.facebook.com/v2.6/me/subscribed_apps?method=POST&access_token=[TEST_USER_PAGE_ACCESS_TOKEN](Dokumentasi)
GET /oauth/access_token? grant_type=fb_exchange_token& client_id={app-id}& client_secret={app-secret}& fb_exchange_token={short-lived-token}
Ada beberapa alasan mengapa hal ini terjadi:
Saat menggunakan Plugin “Kirim ke Messenger”, parameter ref-data bisa Anda gunakan sebagai parameter yang perlu dilalui untuk mengirim semua informasi tentang konteks klik.
Orang-orang juga dapat menemukan halaman Anda melalui pencarian di Messenger. Dalam kasus ini, Anda tidak memiliki parameter yang perlu dilalui. Anda bisa menggunakan fitur penautan akun untuk menghubungkan utas ke akun pengguna di situs Anda.
Pada dasbor aplikasi di bawah Pengaturan Messenger, terdapat tombol "Tampilkan Kesalahan Terbaru" yang menunjukkan apakah webhooks mendapatkan tanggapan 200 atau gagal.
Ada fitur yang menunjukkan kesalahan webhook terbaru. Jika webhooks gagal dikirim, server Facebook akan menghentikan langganan URL Anda. Untuk menemukan fiturnya, buka Dasbor Aplikasi > Messenger > Pengaturan, di dalam kartu Webhooks terdapat tombol Tampilkan kesalahan terbaru
Pastikan webhook Anda menanggapi dengan kode status 200. Hal ini memberi tahu kami bahwa webhook tersebut sudah berhasil diterima. Jika Anda tidak mengembalikan 200, maka kami akan mencoba untuk memanggil lagi hingga berhasil diselesaikan. Selain itu, jika webhook tidak mengembalikan 200 untuk periode waktu yang diperpanjang, maka kami akan mengeluarkan peringatan pengembang.
Serta, harap diperhatikan bahwa kode status yang berhasil sudah dikembalikan pada waktu yang tepat. Panggilan webhook dengan waktu habis setelah 20 detik. Pastikan untuk membangun kode Anda sedemikian rupa agar webhook diproses secara asinkron sehingga kode status yang berhasil bisa dikembalikan langsung dan diproses secara terpisah.
Panggilan ke webhook berisi kolom di header yang bernama X-Hub-Signature, yang bisa digunakan untuk memvalidasi panggilan yang berasal dari Facebook.
Ada 2 langkah untuk menerima callback. Pertama, pastikan webhook Anda sudah disiapkan dengan benar (https://developers.facebook.com/docs/messenger-platform/webhook-reference#setup). Ada indikator saat webhook sudah disiapkan dengan benar.
Kedua, Anda harus berlangganan ke masing-masing halaman. Semua halaman yang berlangganan akan dicantumkan.
Jika panggilan ke webhook Anda gagal selama periode waktu yang diperpanjang, maka aplikasi Anda akan berhenti berlangganan dan Anda akan perlu menambahkan ulang webhook Anda, serta berlangganan halaman Anda lagi.
Konten ini kemungkinan besar perlu disingkirkan ulang, dan penyingkiran ini terjadi secara otomatis nantinya atau dipicu secara manual melalui Alat Debug.
Anda tidak dapat mengontrol tampilnya kiriman di Kabar Berita atau Linimasa ketika membagikan cerita graf terbuka Anda selain untuk memberi tag OG untuk halaman Anda. Facebook mengoptimalkan kiriman secara otomatis untuk memastikan interaksi maksimal konten Anda.
Ya, fitur Tautan Tindakan telah ditiadakan. Dukungan untuk tautan tindakan telah dihapus dari situs Facebook, karena fitur tersebut telah ditiadakan dari platform. Fitur ini mungkin akan ditinjau lagi di waktu mendatang, namun tidak untuk saat ini.
Jika halaman web Anda menggunakan tag meta Graf Terbuka kami dan menyertakan og:image entri, maka kami akan mengambil gambar itu dan menampilkannya di cuplikan. Selain itu, jika situs Anda menyediakan og:image, og:image:width, dan og:image:height, maka gambar tersebut akan dapat digunakan bahkan untuk pembuatan berbagi pertama.
Apabila Anda tidak dapat menyediakan hal-hal tersebut, maka Anda harus menunggu crawler kami untuk memperoleh dan menganalisis gambarnya terlebih dahulu. Lihat http://ogp.me/#structured untuk contoh cara melakukannya.
Aslinya memang sudah dirancang seperti itu. API REST sudah sejak lama ditiadakan, dan tidak diharapkan untuk terus berfungsi. Ada batasan yang berlaku - Token akses halaman tidak dapat digunakan dengan API REST.
Anda dapat menetapkan lokale untuk tombol Suka menggunakan parameter 'locale' di SDK JS. Pelokalan ini akan berfungsi untuk para pengguna yang tidak masuk. Jika seorang pengguna masuk, maka preferensi bahasa orang tersebut akan ikut dipertimbangkan. Jika preferensi bahasanya ditetapkan untuk bahasa tertentu, maka tombol Suka akan tertulis dalam bahasa tersebut.
Anda dapat menguji perilaku ini dengan mengunjungi Facebook tanpa melakukan proses masuk (atau dengan memanfaatkan sesi privat browser Anda).
Mengisi area teks sebelumnya ketika berbagi ke Facebook merupakan hal yang bertentangan dengan kebijakan Facebook. Pengguna aplikasi Anda akan mengisi teks yang ingin mereka bagi sendiri.
Tindakan mengisi area teks sebelumnya ketika berbagi melanggar Kebijakan Platform 2.3 ( https://developers.facebook.com/policy/#control ). Kami menegakkan kebijakan ini untuk memastikan para pengguna dapat membagikan hal yang memang ingin mereka bagikan di Facebook, dan tidak membagikan teks yang tidak mereka inginkan secara tidak sengaja.
Bisa jadi ini adalah perilaku yang diantisipasi, jika Anda mengubah atau memodifikasi URL halaman web. Setiap URL yang memiliki plugin komentar dianggap sebagai objek graf terbuka yang terpisah, dan komentar-komentarnya dihubungkan dengan objek tersebut. Oleh karena itu, jika Anda memodifikasi URL, maka objek baru akan dibuat dan komentar yang ada mungkin tidak akan muncul di halaman.
Tidak, Anda tidak dapat mengirimkan komentar ke plugin komentar melalui API.
Pembagi tidak akan memperbolehkan Anda untuk lolos di parameter khusus dan akan memperoleh meta-data dari tag meta graf terbuka halaman secara langsung.
Untuk mempelajari selengkapnya tentang praktik terbaik untuk berbagi konten, harap buka dokumen ini: https://developers.facebook.com/docs/sharing/best-practices
No this is not possible. Numbers that are registered under WABAs (WhatsApp Business Accounts) can only message regular WhatsApp accounts.
We will provide a seven day grace period post sending the warning. This will allow time for businesses to adjust their behavior. If businesses continue to exceed our internally set threshold of calls to the Contacts API vs. number of messages sent, we will permanently disable the phone number.
Interactive messages can be reopened by the user in order to resend an option. This is in case of mistyping the desired option or wanting to choose a new option.
Through user testing we’ve identified 10 as the optimal number of rows to provide a good user experience. If you have a list of more than 10 options, and cannot condense into one list message, we recommend creating an additional step in the flow and using two list messages. During testing businesses had higher response rates and conversions with this approach than using text-based lists.
Through user testing we’ve identified 3 as the optimal number of buttons to provide a good user experience. If you have a list of more than 3 options, and cannot condense it into one button message, we recommend using list messages. During testing, businesses had higher response rates and conversions with list messages than using text-based lists.
There may be a very small number of users for whom their app version does not support this feature, the business will receive a webhook notification throwing an error that describes why the message was unable to be received. It is up to the business to determine how to handle this error elegantly. Best practice would convert the interactive message to a text-based list to allow the user to complete the workflow.
If there is a delay in a subset of numbers, then it is likely not an issue affecting the customers integration but rather an issue on the recipients end, these delays in delivery can happen for a number of reasons. See Send Message Performance, Delays for more information.
Tidak, saat ini kami tidak mendukung pengubahan jalur default ke penyimpanan media (/usr/local/wamedia/). Semua penyimpanan media harus berada di lokasi default ini agar berfungsi dengan baik.
Tidak, saat ini kami harus menggunakan AWS EFS untuk berbagi volume media antara Coreapp dan Webapp.
Tidak, kami tidak mendukung KOPS. Kami mendukung solusi AWS berdasarkan ECS. Kami juga memiliki penyiapan minikube Kubernetes umum.
Coreapp akan memeriksa direktori /usr/local/waent/data
dan /usr/local/waent/log
dalam kontainer Coreapp, memastikan setidaknya ada 10 MB ruang penyimpanan, jika tidak, kesalahan kritis ini akan diberikan.
Periksa catatan dan direktori data Anda untuk memastikan Anda memiliki cukup ruang.
Tidak. Saat ini tidak ada cara untuk menjalankan banyak nomor dalam penyiapan klien API WhatsApp Business yang sama. Kami sedang menggarap solusi yang tepat agar hal ini dapat dilakukan ke depannya.
Gunakan pengumpulan sampah database endpoint API services
untuk membersihkan pesan dan tanda terima pesan yang sesuai dari tabel messageStore.messages
dan messageStore.messages_receipt_log
.
Periksa ulang pengaturan aplikasi pass_through
Anda. Anda tidak akan menerima panggilan balik status baca jika Anda telah mengaktifkan pass_through
dengan klien API WhatsApp Business v2.29.1
atau lebih tinggi.
Jika Anda ingin menerima panggilan balik status baca, nonaktifkan pengaturan aplikasi pass_through
. Perhatikan bahwa dengan menonaktifkan pass_through
, penyimpanan database Anda dapat berkembang dengan cepat. Lihat dokumentasi Pengelolaan Database untuk informasi selengkapnya tentang mengelola database Anda.
Pengumpulan sampah database secara berkala membersihkan tabel messages
dan messages_reciept_log
untuk membantu pengelolaan database.
Pengumpul sampah menyimpan pesan tertentu agar penyampaian/pemrosesan berhasil. Contoh: mempertahankan pesan masuk selama jangka waktu tertentu untuk memungkinkan integrasi bisnis menandai pesan sebagai telah dibaca.
Coreapp melakukan pengumpulan sampah secara acak (yaitu, setiap beberapa jam). Ini untuk mencegah potensi penurunan kinerja di tumpukan Ketersediaan Tinggi karena pertentangan database.
Pengumpulan sampah tidak bergantung pada antrean panggilan balik. Contoh: jika server Webhooks tidak tersedia selama 4 hari, panggilan balik akan disimpan untuk dikirimkan saat konektivitas server Webhooks dipulihkan.
Tautan hanya akan ditampilkan sebagai dapat diklik jika penerima telah menyimpan nomor bisnis Anda sebagai kontak atau Anda memiliki Akun Bisnis Resmi.
Sebelum v2.29.x
, ukuran antrean pesan keluar dapat meningkat dari waktu ke waktu akibat bug. Meningkatkan ke v2.29.3
akan menyelesaikan isu ini.
Anda akan bertanggung jawab untuk menggunakan kode QR yang sesuai berdasarkan ekspektasi lokasi dan bahasa pengguna.
Kode QR sekarang dapat dibuat dan dikelola langsung di dalam API Pengelolaan WhatsApp Business dan pengguna dapat memindainya dengan kamera WhatsApp, iOS, atau Android mereka.
Selain itu, dengan kode QR WhatsApp
Jika pengguna mencoba mengakses kode QR atau tautan pendek yang telah dihapus, mereka akan melihat pesan kesalahan yang menunjukkan kode QR/tautan pendek telah kedaluwarsa.
Jika pengguna telah menginstal klien desktop WhatsApp, itu akan meluncurkan percakapan dengan bisnis Anda. Jika tidak, pengguna akan diminta untuk menginstal klien desktop WhatsApp.
Tautan pendek baru memungkinkan pesan yang telah diisi sebelumnya dan terkait dengan tautan untuk diedit atau dihapus kapan saja. Tautan pendek baru juga mengurangi sintaks URL menjadi kode acak, yang menghilangkan kebutuhan untuk menyematkan pesan di URL dan menutupi nomor telepon.
Kami merekomendasikan format file .svg
untuk kualitas terbaik dalam material cetak.
Anda dapat melihat, membuat, mengedit, dan menghapus kode QR dan tautan pendek di API Pengelolaan WhatsApp Business atau di UI Pengelola Bisnis.
We are announcing the deprecation of Groups through the WhatsApp Business API. Starting July 8, 2020, only API phone numbers in a group created prior to July 8th can continue to use/manage Groups through the WhatsApp Business API. All other API phone numbers won’t be able to create/manage Groups through the Whatsapp Business API. On October 8, 2020, we will deprecate this feature for all API phone numbers (i.e., API phone numbers will be removed from their groups and no longer be able to send messages to their group).
v2.25.x
meningkatkan kinerja keluar dan masuk dibandingkan rilis sebelumnya. Pengoptimalan ini mengandalkan pembuatan koneksi database tambahan. Untuk beberapa penerapan, ini dapat menyebabkan jumlah koneksi database meningkat dan mencapai batas yang dikonfigurasi. Agar kinerja terus meningkat, Anda bisa meningkatkan jumlah maksimum koneksi yang dapat diterima server database Anda. Jika itu tidak memungkinkan, Anda dapat mengubah parameter axolotl_context_striping_disabled untuk menonaktifkan perilaku ini. Lihat dokumentasi Pengaturan Aplikasi untuk informasi selengkapnya tentang cara melakukan perubahan ini.
Jika Anda atau klien akhir Anda ingin meminta untuk menjadi akun bisnis resmi di WhatsApp, lihat petunjuk di bagian dokumen Meminta Akun Bisnis Resmi.
Tidak. Saat ini, batas pengiriman pesan hanya berlaku untuk pesan yang dimulai bisnis (notifikasi).
Saat mengirimkan gambar sebagai album dari API WhatsApp Business, Anda akan harus mengirimkan setidaknya 4 gambar secara beruntun. Jika tampilan percakapan pengguna sedang aktif saat gambar-gambar itu diterima, tampilan album tidak akan tersedia hingga kunjungan berikutnya.
Album tidak akan dibuat jika salah satu kriteria berikut terpenuhi:
Tidak. Saat ini, klien API WhatsApp Business tidak berfungsi di Docker for Windows. Untuk kebutuhan pengembangan, solusi yang disarankan adalah menggunakan mesin Virtual Linux dan menjalankan Docker di dalamnya. Untuk beban kerja produksi, kami sarankan Anda menggunakan Server Linux untuk menghindari masalah kompatibilitas dan kinerja.
Untuk klien API WhatsApp Business yang menjalankan v2.21.6, saat koneksinya terputus dari server, klien mungkin akan tetap tidak tersambung selama beberapa menit (sampai 4 menit) dan setelah itu akan mencoba menyambungkan lagi. Upgrade ke v2.23.4 akan mengurangi waktu nonaktif untuk klien saat ingin tersambung ke server.
Kode kesalahan 471
terkait dengan batas laju berbasis kualitas. Lihat dokumentasi Batas Laju Berbasis Kualitas untuk informasi selengkapnya.
Semua bisnis memulai dengan tingkat terendah dan akan otomatis diupgrade ke tingkat yang lebih tinggi seiring mereka mengirimkan makin banyak pesan yang memiliki kualitas tinggi.
Ya, saat mengirimkan template pesan, jika pesan itu gagal ditampilkan pada sisi penerima, Anda akan menerima callback status "gagal" dengan objek kesalahan "struktur tidak tersedia" yang menunjukkan bahwa pesan tidak dapat ditampilkan. Bergantung pada penerima, Anda juga dapat menerima callback status "terkirim" yang menandakan bahwa pesan terkirim tetapi gagal ditampilkan kepada penerima.
Berikut ini adalah kesalahan validasi dari sisi pengiriman template pesan dan kemungkinan alasan Anda melihatnya:
template
. Lihat dokumentasi Template Pesna Media untuk informasi selengkapnya.Pesan duplikat dapat dikirimkan ke Webhook WhatsApp sebagai satu-satunya jaminan bahwa pesan akan diterima setidaknya satu kali (bukannya pasti hanya satu kali). Jika ini berdampak pada cara pemrosesan pesan pada sisi Anda, kami sarankan untuk menghapus pesan Webhook duplikat berdasarkan ID pesan.
Jika nomor telepon itu belum digunakan di API WhatsApp Business, Anda dapat menggunakan nomor telepon itu. Ikuti langkah-langkah migrasi yang dijelaskan di sini untuk menggunakan lagi nomor telepon itu.
Dimulai dengan rilis v2.18.26, endpoint Statistik Aplikasi memungkinkan pengeksporan metrik internal dalam format teks Prometheus. Lihat dokumentasi Pemantauan Instance untuk informasi selengkapnya.
Objek profile
kosong akan ditampilkan jika Profil Bisnis hanya diisi sebagian. Upgrade ke v2.21.4
untuk mengatasi masalah ini.
Lihat dokumentasi Pengaturan Profil Bisnis untuk informasi selengkapnya tentang melengkapi profil bisnis Anda.
Jika Anda menerima kesalahan serupa dengan yang berikut ini saat menyiapkan penerapan AWS, cobalah berganti menggunakan nama stack yang berisi 8 karakter atau kurang.
Nama negara (kode 2 huruf) [AU]:Nama Negara Bagian atau Provinsi (nama lengkap) [Some-State]:Nama Daerah (mis. kota) []:Nama Organisasi (mis. perusahaan) [Internet Widgits Pty Ltd]:Nama Unit Organisasi (mis. bagian) []:Nama Umum (mis. FQDN server atau nama ANDA) []:string terlalu panjang, perlu Nama Umum sepanjang kurang dari 64 bita (mis. FQDN server atau nama ANDA) []:Alamat Email []:kesalahan, tidak ada objek yang ditentukan dalam file konfig masalah dalam membuat Permintaan Sertifikat Membuat kunci perangkat untuk internal-wa-inc-name-LB-123456789.ap-southeast-1.elb.amazonaws.com
Tidak ada batas untuk jumlah parameter yang diizinkan dalam sebuah template pesan.
Maksimumnya adalah 250 template pesan per akun WhatsApp Business.
Jika sebuah peristiwa Webhook tidak terkirim untuk alasan apa pun (mis. klien sedang offline) atau jika permintaan Webhook menghasilkan kode status HTTP selain 200
, kami akan mencoba ulang pengiriman webhook. Kami akan terus mencoba ulang pengiriman dengan waktu keterlambatan yang makin panjang hingga angka tertentu (biasanya 24 jam, meskipun ini mungkin berbeda-beda), atau sampai pengiriman berhasil.
Mungkin ada kasus-kasus di mana Anda membutuhkan lebih banyak waktu untuk menangani permintaan informasi dari pelanggan dan hanya dapat menanggapinya setelah 24 jam. Kami sarankan Anda membuat template pesan untuk:
Dalam kedua kasus, pastikan Anda memberikan sebanyak mungkin konteks dalam template pesan yang digunakan. Misalnya:
WhatsApp melakukan eksperimen untuk mengukur dan memahami dampak notifikasi API WhatsApp Business pada pengalaman pengguna dan keseluruhan produk secara umum. Jika pengguna yang Anda kirimi pesan termasuk dalam salah satu eksperimen ini, mereka mungkin tidak menerima notifikasi dari Anda bahkan jika mereka sudah mendaftar untuk menerimanya.
Jika Anda mencadangkan penyiapan saat ini dan memulihkannya di komputer baru, informasi pendaftaran akan berpindah bersama penerapan Anda lainnya. Lihat dokumentasi Pengaturan Pencadangan dan Pemulihan untuk informasi selengkapnya.
Ya, rotasi log untuk container webapp dan container coreapp memiliki perilaku yang sedikit berbeda:
Harap Hubungi Dukungan dengan menyampaikan semua informasi yang Anda miliki. Kami akan menyelidikinya dan menutup nomor yang palsu.
Semua build Klien API WhatsApp Business memiliki waktu kedaluwarsa 6 bulan setelah tanggal rilis. Jika Anda mendapati kesalahan ini, upgrade secepatnya ke versi yang terakhir dirilis.
Pertama-tama, Anda perlu memeriksa apakah kontak ada sebelum mengirimkan pesan. Lihat dokumentasi Kontak untuk mengetahui informasi selengkapnya tentang cara melakukannya.
Kesalahan ini disebabkan oleh Coreapp yang belum terinisialisasi. Artinya pendaftaran mungkin belum berhasil diselesaikan. Harap coba mendaftar sebelum membuat panggilan ke endpoint lain. Langkah pertama setelah menginstal API WhatsApp Business adalah login. Langkah kedua adalah pendaftaran. Kedua langkah ini diperlukan sebelum membuat permintaan ke endpoint lainnya.
Catatan: Kebijakan bahasa fallback
dihentikan mulai dengan v2.27.8
dan kebijakan bahasa deterministic
sekarang menjadi kebijakan default.
Jika Anda membuat terjemahan dalam bahasa baru, Anda perlu menerjemahkan semua elemen yang Anda gunakan ke dalam bahasa itu. Jika tidak, Anda mungkin akan mendapatkan kesalahan "struktur tidak tersedia" karena ponsel penerima tidak dapat menemukan elemen yang diharapkan dalam bahasa terkait. Kesalahan struktur tidak tersedia seperti ini muncul saat mengirimkan pesan template menggunakan kebijakan fallback.
Jika membuat terjemahan bahasa tidak dapat Anda lakukan pada saat ini, Anda dapat menggunakan kebijakan deterministik untuk menghindari kesalahan seperti ini.
Payload pesan dari pengguna dapat berupa teks atau file media.
Untuk teks, diyakini tidak akan ada bahaya.
Untuk file media:
auto_download
ke array kosong. Tidak, tidak ada cara untuk menggunakan API WhatsApp Business untuk mendeteksi saat sebuah nomor digunakan beberapa perangkat.
Kesalahan struktur tidak tersedia terjadi ketika telepon tidak dapat membaca pesan template.
Template disimpan di server. Ketika pesan template dikirim menggunakan node messages
,hanya namespace, bahasa, nama elemen, dan parameter yang dilokalkan yang dikirim ke telepon, tetapi bukan seluruh pesan. Setelah nilai-nilai ini dikirim ke telepon, telepon mencoba untuk me-render pesan.
Jika kesalahan terjadi selama rendering, kesalahan structure unavailable
dikirim ke URL panggilan balik yang berisi penerima dan ID pesan. Kesalahan ini dapat terjadi karena namespace yang salah, parameter yang dilokalkan tidak cocok, nama elemen yang salah, dsb.
Buka Pengelola WhatsApp di Pengelola Bisnis Facebook Anda untuk melihat jumlah parameter yang benar. Periksa ulang bahwa namespace sudah benar dan nama elemen memang ada.
Salah satu sumber kesalahan adalah tidak membuat terjemahan untuk semua template yang digunakan. Contoh: jika Anda memiliki 2 template yang biasanya Anda kirimkan dan menambahkan terjemahan bahasa baru untuk satu template, pastikan untuk juga menambahkan terjemahan bahasa baru tersebut ke template satunya. Jika berencana untuk mendukung lebih dari satu bahasa, Anda perlu menyediakan terjemahan untuk semua template dalam semua bahasa yang didukung.
Kabar baiknya adalah bahwa kesalahan structure unavailable
biasanya disebabkan oleh kesalahan di panggilan API messages
dan dapat diperbaiki dengan mengubah payload kirim.
Anda dapat mendaftarkan nomor telepon baru dan menghapus yang lama di Akun WhatsApp Anda di Pengelola Bisnis Facebook.
Untuk gambar, keterangan akan ditambahkan sebagai deskripsi. Teks keterangan muncul secara penuh untuk gambar di Android dan iPhone.
Untuk dokumen, keterangan menggantikan nama file. Ini tidak dimaksudkan untuk ditampilkan di perangkat pengguna sebagai teks deskripsi tetapi untuk menunjukkan nama file. iPhone menampilkan teks lengkap sementara Android memotong nama file; ini adalah batasan teknis dari penerapan WhatsApp saat ini di kedua perangkat.
Jika pendaftaran gagal dengan "SMS" karena terlalu banyak percobaan dan Anda melihat pesan "akses ditolak", silakan coba mendaftar dengan "suara"
Saat ini 7 hari. Jika belum diupdate selama lebih dari 7 hari, cache akan mengambil paket bahasa terbaru dari server tanpa mempertimbangkan apakah elemen-elemennya sudah ada di dalam paket atau belum.
Perangkat pertama-tama akan memuat dari cache, dan jika terdapat elemen, pesan akan dibuka menggunakan template pesan. Jadi daripada memodifikasi template pesan, cara yang lebih aman adalah menambahkan template baru dengan nama elemen yang berbeda. Itu akan menjamin bahwa paket bahasa akan diunduh ulang saat tidak dapat menemukan elemen. Biaya penyimpanan template pesan sangatlah kecil sehingga Anda tidak harus menghapus template pesan.
Lihat Mengirim Template Pesan — Bahasa untuk informasi selengkapnya.
Untuk memastikan pengalaman berkualitas tinggi untuk bisnis dan pengguna, kami memberlakukan pratinjau publik terbatas. Jika Anda ingin bekerja dengan kami, kirimkan lebih banyak informasi tentang bisnis Anda sebagai pertimbangan seiring kami terus memperluas ketersediaan, atau hubungi perwakilan Facebook Anda jika Anda sudah memilikinya.
Membuat pengguna logout melalui endpoint users
akan membuat semua token otorisasi yang ditetapkan ke akun itu menjadi tidak valid. Menghapus pengguna akan berakibat sama, walaupun itu terasa lebih drastis. Ingat bahwa membuat pengguna login melalui endpoint users
akan menghasilkan token otorisasi baru, tapi ini tidak akan membuat token otorisasi yang sudah digunakan untuk pengguna itu menjadi tidak valid. Siapa pun yang memiliki token yang disediakan sebelumnya akan dapat terus menggunakannya sampai token itu kedaluwarsa atau dibuat tidak valid melalui salah satu cara tersebut di atas.
Jika Anda melihat kesalahan ini tetapi parameter yang diperlukan tetapi tidak ada itu tersedia dalam konten json Anda, itu mungkin kesalahan penguraian json. Kesalahan ini dapat terjadi saat payload json secara keseluruhan tidak dapat diuraikan karena kesalahan pemformatan json. Periksa apakah nilai-nilai parameter itu mengandung karakter json yang tidak valid, misalnya carriage retur di akhir. Terkadang parameter dapat disalin dengan menyertakan whitespace tambahan yang mungkin mengandung karakter yang merusak json.
Mungkin ada beberapa alasan. Coreapp Anda mungkin sedang nonaktif atau database Anda tidak disiapkan dengan benar. Jika tidak demikian, periksa log Coreapp Anda (atau log Coreapp master jika Anda menjalankan multikoneksi). Jika Anda melihat kesalahan koneksi database, kemungkinan database Anda kehabisan koneksi. Lihat dokumen MySQL atau dokumen PostgreSQL tentang kesalahan ini.
Kami sarankan Anda menambah jumlah koneksi database di database Anda. 1.000 koneksi database adalah angka yang seharusnya aman, tapi ambil keputusan Anda dengan matang mengenai jumlah koneksi. Jika kesalahan berlanjut, kirimkan tiket permintaan dukungan.
Kemungkinan alasan penolakan template pesan antara lain:
Kesalahan "koneksi ditolak" mungkin berarti Coreapp tidak berjalan. Gunakan docker ps
untuk memeriksa apakah Coreapp beroperasi. Jika tidak beroperasi, lihatlah log Docker. Coreapp mungkin tidak dapat tersambung ke database. Pastikan database Anda sudah disiapkan dengan benar.
Ini terjadi jika bridge Docker korup. Solusi terbaik untuk ini adalah menghentikan layanan Docker dan memulainya lagi. Anda juga dapat mencoba docker restart
di container Anda.
WhatsApp secara ketat memverifikasi bahwa nomor yang diberikan benar-benar terpasang pada ponsel. Fakta bahwa pengguna memiliki akun WhatsApp adalah bukti bahwa mereka sudah mengonfirmasi nomor tersebut dan tidak ada orang lain yang pernah menggunakannya untuk mendaftar WhatsApp. Akan tetapi, ini bukan jaminan tentang lokasi fisik kartu SIM itu.
Di sisi lain, jika ponselnya hilang atau dicuri, pengguna dapat menonaktifkan akun WhatsApp-nya. Untuk membaca selengkapnya tentang cara menonaktifkan akun, lihat Pertanyaan umum tentang ponsel yang hilang dan dicuri.
Jika nomor telepon pelanggan nonaktif, tetapi pelanggan masih menggunakan WhatsApp, pelanggan itu akan terus mendapatkan akses ke WhatsApp sampai/hingga nomor telepon itu diaktifkan atau didaftarkan lagi.
WhatsApp strongly verifies whether number provided actually belongs phone. The fact that a user has a WhatsApp account is proof that they confirmed the number and no one else has used that number to register on WhatsApp subsequently. However, It is not a guarantee of the physical location of the sim.
On the other hand, if users phone is lost or stolen, they can deactivate their WhatsApp account. You may read to know more about how users can deactivate their account here.
Kesalahan ini terjadi saat database belum disiapkan dengan benar.
Ya, koneksi TCP diperlukan. Jika bisnis tidak dapat membuka port tambahan, Anda dapat menggunakan SSL yang dihentikan.
Lihat dokumentasi Persyaratan Jaringan untuk informasi selengkapnya.
Ini adalah masalah yang sudah diketahui. Terkadang mengupgrade Klien API WhatsApp Business menggunakan skrip CloudFormation juga meminta update untuk stack RDS DB. Stack RDS yang baru tidak akan memiliki nama host yang sama dengan stack aslinya, dan contaner Docker tidak dapat tersambung ke database. Solusinya adalah SSH ke instance EC2 yang dibuat oleh CloudFormation dan mengupdate file whatsapp.conf
dengan nama host baru, kemudian memulai ulang container Docker agar menggunakan pengaturan yang baru.
Ya, kirimkan panggilan API ke node contacts
sebelum mengirimkan pesan. Informasi dari pemeriksaan contacts
disimpan dalam container dan tidak melakukan ini mungkin akan menyebabkan kesalahan Unkown Contact
. Lihat dokumentasi Periksa Kontak untuk informasi selengkapnya.
Use the mcdockerreset script and tear down the webapps then use the mcdockersetup script to bring up a new webapp.
Reason: When the webapp first connects to the DB, it creates the database.yml file. it will never try to create it again. The coreapps will just not start up on a bad DB config; however, the webapp will, so you see the master and slave nodes in your DB because they were setup correctly once you got around all the DB and script issues but the webapps were started by the script in a bad state to begin with.
Jika Webhook gagal untuk mengirimkan callback, callback ditempatkan ke antrean percobaan ulang. Callback yang dikirimkan setelah kegagalan callback pertama tidak akan diambil. Hanya setelah callback pertama yang gagal berhasil, callback yang lain akan menyusul.
Klien API WhatsApp Business mengirimkan callback Webhook kepada Anda melalui container Coreapp. Oleh karena itu, endpoint Webhook Anda perlu dikonfigurasi untuk menerima permintaan masuk dari Coreapp.
Anda harus mendaftarkan nomor telepon kedua dan memutar stack CloudFormation kedua atau instance Docker untuk pengujian. Jika Anda memiliki dua Klien API WhatsApp Business yang aktif menggunakan nomor telepon yang sama, server akan mengeluarkan Anda karena kunci enkripsi akan berkonflik. Sebaiknya Anda memiliki lingkungan kedua yang dapat Anda gunakan untuk menguji instance non-produksi sebelum Anda melakukan migrasi apa pun pada klien produksi Anda.
MySQL 5.7.x, PostgreSQL 9.5.x, 9.6.x, 10.x diperlukan. Penggunaan versi sebelumnya akan menghasilkan kesalahan Unable to initialize config store
.
Saat Anda mengirimkan pesan, ketika Anda mendapatkan kembali ID pesan, permintaan pesan berarti telah disimpan di database. Klien API WhatsApp Business akan terus mencoba mengirimkan pesan itu sampai diakui oleh server WhatsApp. Proses ini tidak memiliki linimasa akhir. Server WhatsApp kemudian akan mencoba mengirimkan pesan itu ke ponsel pengguna. Jika ponsel pengguna tidak online, pesan akan disimpan selama 30 hari sebelum dihapus oleh server WhatsApp.
Tabel database menyimpan informasi terkait dengan pengaturan aplikasi, utas obrolan, pesan, media, dsb., yang semuanya diperlukan oleh aplikasi untuk dapat bekerja.
Bisnis Anda tidak diberi tahu saat pelanggan berganti nomor telepon WhatsApp. Saat Anda menggunakan node contacts
, status untuk nomor itu akan invalid
.
Tidak, Anda dapat menjalankan satu akun per instance. Jika Anda memerlukan akun pengujian kedua, pastikan untuk menggunakan nomor yang berbeda untuk instance kedua itu.
Pemeriksaan Kesehatan gratis dan bisa dikueri sesering mungkin.
Bacalah dokumentasi Statistik untuk mempelajari selengkapnya tentang statistik aplikasi dan database yang dapat Anda kueri. Statistik aplikasi disimpan di dalam memori dan murah untuk dikueri. Statistik database membutuhkan lebih banyak sumber daya dan harus dikueri hanya saat diperlukan.
Saat menggunakan node messages
, Anda perlu mengatur header Content-Type
ke application/json
agar Klien API WhatsApp Business dapat menguraikan isi pesan dengan benar. Terdapat pula header Authorization
yang harus diatur dan harus berisi token akses yang tidak kedaluwarsa. Lihat dokumentasi Login dan Autentikasi untuk mengetahui informasi tentang cara mendapatkan token dan kapan token kedaluwarsa.
Sistem Anda mungkin akan mulai berjalan lambat seiring dengan makin penuhnya penyimpanan. Ini dapat disebabkan oleh banyaknya jumlah file media, pesan, dan file log yang berukuran besar. File log otomatis dirotasi, tapi jika ukurannya mulai terlalu besar, Anda aman untuk menghapusnya.
Pesan disimpan di database. Anda dapat menghapus pesan jika perlu. Selain itu, jika pass_through
diatur ke false dalam pengaturan aplikasi, semua pesan disimpan di database lokal hingga secara eksplisit dihapus.
File media yang dikirimkan pengguna kepada Anda diunduh ke volume media. Bisnis menentukan sendiri file media mana yang ingin dihapus, tapi pada umumnya file media aman untuk dihapus. Anda dapat menggunakan docker inspect your-container-id
untuk memeriksa lokasi folder volume media.
Siapkan MySQL secara lokal menggunakan Docker dengan mengikuti panduan MySQL Docker.
Siapkan PostgreSQL secara lokal menggunakan Docker dengan mengikuti panduan PostgreSQL Docker.
Dalam kebanyakan kasus, Anda sebaiknya menjalankan database di server fisik yang terpisah dari container core dan web. Latensi server database seharusnya hanya beberapa milidetik dari mesin komputasi.
Terserah Anda kapan harus menghapus media.
Setelah mengunggah media, Anda akan menerima ID media, yang dapat Anda gunakan untuk mengirim pesan yang menyertakan elemen media yang diunggah. Setelah mengirim pesan media, API WhatsApp Business akan mengenkripsi dan mengunggah media ke server WhatsApp yang akan tetap ada selama 14 hari. Setelah itu, Anda dapat memutuskan untuk menghapus media tersebut dengan memberikan ID media tersebut atau menyimpannya untuk digunakan nanti. Meskipun kami menyarankan menyimpan media selama 30 hari, terserah Anda untuk memutuskan kebijakan penyimpanan berdasarkan kebijakan atau kasus penggunaan bisnis Anda.
Ya, database bisa digunakan dengan cara lain tanpa menyentuh tabel terkait WhatsApp.
Pertama, periksa callback untuk melihat kesalahan kritis dan mendiagnosis masalahnya.
Jika Anda melihat "Konflik: Mendeteksi beberapa instance dengan nomor yang sama", Anda perlu mengecek container. Kemungkinan terbesar penyebabnya adalah Anda memiliki beberapa container Docker yang mencoba tersambung ke server WhatsApp dengan akun WhatsApp yang sama. Pastikan Anda hanya satu container yang berjalan. Jika Anda memiliki container lama, nonaktifkan dan kesalahan akan hilang.
Jika Anda ingin menguji solusi ketersediaan tinggi yang lebih rumit, lihat dokumentasi Ketersediaan Tinggi.
Daftar diizinkan dapat dibuat dengan nama host atau alamat IP.
Lihat bagian Nama host dalam dokumentasi Persyaratan Jaringan untuk informasi selengkapnya.
Ya! WhatsApp memungkinkan Anda memformat teks yang diseleksi dalam pesan Anda dengan Tebal, Miring, Coret, atau Monospace.
Ya, template pesan mendukung semua karakter berkirim pesan WhatsApp termasuk emoji, huruf tebal, huruf miring, dsb. Untuk emoji, Anda akan perlu menggunakan karakter emoji (salin/tempel) alih-alih karakter unicode-nya.
Nomor bebas pulsa dapat digunakan asalkan kode negara Anda disertakan. Alasannya, nomor bebas pulsa tanpa kode negara tidak dapat diidentifikasi secara unik — nomor yang sama dapat tersedia di dua negara yang berbeda.
Juga harap diketahui bahwa ada kesulitan lain terkait dengan nomor bebas pulsa. Biasanya, jika Anda memanggil nomor bebas pulsa dengan kode negara saat Anda berada di negara tersebut, panggilan Anda akan gagal. Artinya, ada kemungkinan pelanggan dari negara Anda akan mencoba menghubungi nomor yang tercantum pada kontak bisnis (termasuk kode negara) dan mereka tidak akan bisa menjangkau Anda. Jika ini adalah masalah, Anda akan perlu memberi tahu mereka secara jelas.
Baca selengkapnya tentang nomor bebas pulsa di sini.
TIDAK! Kapan pun, Anda hanya dapat memiliki satu instance Klien API WhatsApp Business yang berjalan untuk satu nomor telepon. Begitu Anda mendaftarkan instance kedua, instance pertama Anda akan dinonaktifkan dan gagal. Kami sedang mengupayakan solusi yang efektif, yang memungkinkan Anda melakukan itu. Kami akan terus memberikan informasi terbaru kepada Anda.
WhatsApp menganggap komunikasi dengan pengguna API Bisnis yang mengelola endpoint API di server yang mereka kontrol dienkripsi end-to-end karena tidak ada akses pihak ketiga ke konten di antara endpoint.
Beberapa organisasi mungkin memilih untuk mendelegasikan pengelolaan endpoint API WhatsApp Business mereka ke Penyedia Solusi Bisnis pihak ketiga. Dalam hal ini, komunikasi masih menggunakan enkripsi protokol Sinyal yang sama. Namun, karena pengguna API WhatsApp Business telah memilih pihak ketiga untuk mengelola endpoint mereka, WhatsApp tidak menganggap pesan-pesan ini dienkripsi end-to-end. Pada tahun 2021, ini juga akan berlaku untuk bisnis yang memilih untuk memanfaatkan versi berbasis cloud dari API yang di-hosting oleh Facebook.
Selain itu, jika Anda menggunakan HTTPS saat membuat panggilan ke klien API WhatsApp Business, data itu dienkripsi SSL (dari klien backend Anda ke klien API WhatsApp Business).
Lihat Laporan teknis Ringkasan Enkripsi WhatsApp untuk detail selengkapnya.
Kegagalan ini disebabkan oleh bug dalam versi lama klien iOS. Kami memperkirakan kesalahan akan berkurang seiring waktu bersama dengan upgrade untuk pengguna umum.
Tidak, urutan datangnya pesan tidak dijamin sama dengan saat pesan dikirimkan. Jika urutan penting untuk Anda, pendekatan yang disarankan adalah memperhatikan callback terkirim dari pesan pertama sebelum mengirimkan pesan kedua.
Terdapat skrip yang dapat dipicu secara eksternal untuk menghapus log lama sebuah container:
docker exec CONTAINER_NAME /opt/whatsapp/bin/cleanup.sh
Skrip bekerja dengan container baik webapp maupun coreapp. Dengan menjalankan skrip, file log lama akan dihapus sehingga hanya tersisa 30 file log dari container itu.
Catatan: Jangan kirimkan pesan yang sama berulang-ulang kepada penerima yang sama menggunakan WhatsApp Business API.
Ada beberapa kemungkinan alasan mengapa tingkat pengiriman tidak 100%. Beberapa kasus umum termasuk pengguna yang memiliki akses sporadis ke jaringan, tidak aktif selama jangka waktu tertentu, atau untuk menciptakan pengalaman pengguna berkualitas tinggi.
Pesan yang dapat tersampaikan dengan WhatsApp akan memiliki tingkat pengiriman yang sangat tinggi. Namun, ada banyak alasan mengapa pesan tidak tersampaikan. Anda akan memiliki akses ke status pesan yang tepat dengan memantau panggilan balik Anda. Hal ini berbeda dari pengiriman pesan melalui SMS, contohnya saat Anda tidak memiliki akses ke status tersampaikan yang terakhir. Pengiriman ulang pesan tersebut dapat memberikan hasil yang berbeda.
Pesan mungkin tetap tidak tersampaikan karena telepon pengguna tidak berfungsi, atau baterai habis, atau mereka kehilangan telepon dan menggunakan telepon yang baru serta menonaktifkan SIM-nya. Mungkin saja terdapat kesalahan pada kemampuan klien bisnis untuk terhubung ke jaringan. Mungkin juga panggilan balik (Webhooks) tidak tersampaikan. Anda dapat memantau situasi ini dengan menggunakan node health
. Anda dapat mengaktifkan panggilan balik penerimaan server untuk mengetahui bahwa pesan berhasil masuk ke cloud server WhatsApp.
Jika dan ketika pengguna terhubung kembali ke jaringan, semua pesan yang Anda kirim akan tersampaikan kepada mereka. Menerima lebih dari satu pesan dengan isi yang sama akan menjadi pengalaman buruk bagi mereka. Mereka kemungkinan besar akan memblokir Anda atau menyampaikan keluhan. Kemungkinan besar Anda akan diblokir.
Jika Anda mengirim pesan dan menerima ID pesan dari API, Anda telah melakukan apa yang bisa Anda lakukan untuk mengirim pesan ini. Jangan mengirim ulang konten yang sama ke penerima yang sama.
Jika Anda melihat tingkat pengiriman yang rendah dalam jangka waktu yang lama, kirimkan tiket permintaan dukungan ke Dukungan Langsung.
Klien API di Tempat WhatsApp Business membutuhkan database untuk menyimpan kode pesan dekripsi yang dikirim antara bisnis dan pelanggan. Semua pesan di WhatsApp dienkripsi dengan kode pengirim dan penerima. Kode pelanggan disimpan di perangkat seluler mereka dan kode bisnis disimpan di database bisnis. Pelajari selengkapnya tentang Keamanan WhatsApp.
WhatsApp Business Cloud API adalah alternatif ketika Meta meng-hosting database bisnis. Cloud API memungkinkan Anda untuk menerapkan API WhatsApp Business tanpa biaya hosting server Anda sendiri. Pelajari selengkapnya.
Tidak. Klien API WhatsApp Business membuka koneksi TCP keluar untuk port 5222 atau 443 pada server WhatsApp. Traffic TCP terjadi selama koneksi berjangka panjang ini. Biasanya firewall mengklasifikasikan ini sebagai mengizinkan “traffic keluar dan traffic yang sudah berjalan.” Tentu saja, paket akan mengalir ke dua arah setelah koneksi terjalin, tetapi awal koneksi berasal dari Klien API WhatsApp Business sehingga tidak perlu ada aturan yang mengizinkan koneksi masuk.
Kami mendukung MySQL dan PostgreSQL. Jika Anda sendiri menjalankan Docker, Anda harus menyediakan database MySQL/PostgreSQL untuk disambungkan dengan container. Penggunaan template AWS secara default akan menyiapkan database MySQL.
Persyaratan bergantung pada muatan dan situasi Anda. Solusinya akan berjalan di mesin yang terhubung ke internet yang menjalankan docker. Sebagai contoh, pengujian sederhana dapat dilakukan di laptop.
Untuk pengaturan server produksi instance tunggal, kami merekomendasikan setidaknya SSD 250 GB, RAM 16 GB, dan CPU 4 core. HDD tidak disarankan karena kecepatan I/O akan mengakibatkan kemacetan ketika terdapat muatan.
Untuk pengaturan server produksi Multikoneksi, kami merekomendasikan setidaknya SSD 50 GB, RAM 4 GB, dan CPU 2 core untuk setiap kontainer Coreapp/Master/Webapp.
Dalam sebagian besar kasus, Anda sebaiknya menjalankan database di server fisik yang terpisah dari kontainer core dan web. Latensi server database seharusnya hanya beberapa milidetik dari mesin komputasi.
Pengaturan ini mendukung pengiriman sekitar 20 pesan per detik.
Tentu saja! Hubungi perwakilan WhatsApp dan sampaikan permintaan ini.
Saat ini, tidak ada cara untuk melakukan ini. Jika Anda tidak dapat menangani tanggapan masuk dari pengguna melalui WhatsApp, kami menyarankan Anda untuk mengirimkan pesan balasan otomatis yang mengarahkan mereka ke saluran dukungan yang benar.
Dalam skenario konsumen normal, ini terjadi secara default saat pengirim belum tercantum di buku alamat Anda dan Anda belum pernah mengirimkan pesan kepada pengirim tersebut sebelumnya. Dalam skenario perusahaan, pelaku bisnis harus menggunakan Template Pesan saat pertama kali menghubungi pengguna untuk membangun "kepercayaan". Dalam melakukannya, Klien API WhatsApp Business akan dapat merender tautan itu dan menjadikannya dapat diklik.
Dalam skenario konsumen normal, ini terjadi secara default saat pengirim belum tercantum di buku alamat Anda dan Anda belum pernah mengirimkan pesan kepada pengirim tersebut sebelumnya. Dalam skenario perusahaan, pelaku bisnis harus menggunakan Template Pesan saat pertama kali menghubungi pengguna untuk membangun "kepercayaan". Dalam melakukannya, Klien API WhatsApp Business akan mematuhi pengaturan pengunduhan otomatis dalam aplikasi.
Sayangnya, Anda harus memilih nomor telepon lain yang dapat menerima SMS atau panggilan suara agar kami dapat mengirimkan kode pendaftaran. Kode pendaftaran manual didukung di masa lalu, tetapi sekarang tidak didukung lagi. Nomor telepon yang sebelumnya menggunakan kode pendaftaran manual akan terus didukung sesuai kebutuhan. Untuk nomor telepon baru, kami hanya akan mengirimkan kode pendaftaran melalui SMS atau panggilan suara.
Jika Anda ingin menggunakan nomor 1800 atau bebas pulsa, bacalah panduan ini.
Saat ini, tidak ada cara untuk mengetahui berapa atau siapa pengguna yang telah memblokir bisnis Anda. Indikator terbaik adalah callback status dan jika Anda tidak menerima status delivered
, artinya pengguna telah memblokir bisnis Anda atau mereka tidak memiliki koneksi jaringan. Lihat dokumentasi Webhook untuk perincian selengkapnya.
Jika pengguna telah memblokir bisnis Anda, API Kontak akan terus menampilkan nomor teleponnya sebagai pengguna WhatsApp yang valid. Namun, saat Anda mengirimkan pesan, pesan tidak akan pernah terkirim. Jika itu pesan berbayar, Anda tidak akan dikenai biaya.
Ya, kami dapat menyiapkan nomor telepon baru atau mengubah nama terverifikasi saat Anda siap untuk tayang.
Ukuran unggahan file maksimum adalah 64 MB, yang berarti batas ini juga berlaku untuk gambar, dokumen, atau video apa pun yang Anda kirim dengan pesan.
Tidak. Solusi API WhatsApp Business membutuhkan nomor yang belum pernah digunakan.
Untuk menemukan titik pemasangan volume media Anda, jalankan perintah docker.
docker volume inspect whatsappMedia
[ { "Driver": "local", "Labels": {}, "Mountpoint": "/var/lib/docker/volumes/whatsappMedia/_data", "Name": "whatsappMedia", "Options": {}, "Scope": "local" } ]
Kemudian, untuk melihat semua file media yang masuk, Anda dapat menjalankan perintah ls
dengan jalur file Mountpoint
yang diterima:
ls /var/lib/docker/volumes/whatsappMedia/_data/
Untuk penyiapan AWS, volume media dipasang ke jalur /mnt/wa/media
pada host.
Tidak ada mekanisme pembersihan baik untuk file media yang keluar maupun yang masuk. Anda dapat menghapus file media Anda secara manual dengan menemukan file tersebut di sistem file Anda.
Anda dapat memulai ulang container Docker dengan menjalankan kode berikut:
docker restart wacore<Current_WABA_Version>
docker restart webapp<Current_WABA_Version>
Anda dapat memeriksa versi mana yang Anda jalankan
docker ps
Ya! Secara default, Klien API WhatsApp Business mencoba untuk berkomunikasi menggunakan chatd
melalui port 5222. Untuk pengalaman terbaik, buka port 5222 untuk semua traffic keluar. Ini tidak menimbulkan masalah keamanan karena traffic hanya keluar dari pusat data Anda.
Jika Anda tidak dapat membuka port 5222, Klien API WhatsApp Business mencoba menggunakan port 443. Jika firewall atau proxy Anda masih memutus koneksi, hubungi tim WhatsApp dengan mengirimkan pertanyaan melalui Dukungan Langsung untuk melakukan debug.