Pertanyaan Umum

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.

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.

Untuk membaca Pertanyaan Umum mengenai GDPR dan Platform Messenger, buka Platform Messenger dan Peraturan Perlindungan Data Umum.

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.

Saat aplikasi Anda dalam mode pengembangan, plugin hanya akan dapat dilihat oleh pengurus, pengembang, dan penguji aplikasi. Setelah aplikasi ditinjau dan disetujui, maka Anda membuat aplikasi tersebut tersedia untuk publik di tab Tinjauan Aplikasi dalam Dasbor Aplikasi.

No. Unlike subscriptions where a business can send multiple messages to people on a recurring basis, the one-time notification API limits the business to a single message per user request. If the person engages with the message, the standard messaging window will reopen.

Yes. Pages interested in using the One-time Notification API need to apply for permission. Go to the Advanced Messaging section of your Page Settings and consent to the terms. A Page will be granted permission if the Page meets our criteria.

Common uses of the API include various promotional and non-promotional use cases where the User explicitly requested a follow-up. Examples include:

• Back in stock alerts
• Collection launches
• Concert tickets going on sale
• Price drop alerts
• Train tickets available for purchase
• CSAT surveys

Your Page is not allowed to send a notification on a topic for which the User has not agreed to receive a notification. Please see the Usage and Restrictions and Limitations sections of the One-time Notification guide for more information.

A Page can send multiple requests however, the 24-hour policy will be applied to all the requests being sent. We also have controls in place to prevent spamming users with multiple requests.

The 24 hour standard messaging window will open only if the user interacts with the opt-in message. The behavior is consistent with interactions with other elements in the Messenger experience.

Pages will need to subscribe to message_optins webhook to receive notifications about User consent.

Once a person asks to be notified, the Page will receive a token which is equivalent to a permission to send a single message to the person. The token can be used to send a message to the person outside the 24 hour window. The token can only be used once and unused tokens will expire within 1 year of creation.

Yes. However, while it is possible to send another notification request using an existing token, there is no clear benefit for the business to send these type of requests.

Token is for one-time use only. Once a token is used it can not be used again.

No. The API does not return tokens available to a Page.

Page level. Permissions for the One-time Notification API are given at the Page level.

No. The app does not need to specify any message tags when sending a message outside the 24-hour standard messaging window using this API.

Ada beberapa alasan mengapa hal ini terjadi:

• Anda menggunakan ID dari Facebook Login. ID Pengguna dari Facebook Login tidak dimaksudkan untuk berfungsi dengan API Kirim/Terima. Hanya ID pengguna yang diperoleh melalui autentikasi dengan Platform Messenger yang akan berfungsi dengan Platform Messenger.
• Anda menggunakan ID dengan Token Akses Halaman yang salah. ID pengguna untuk Platform Messenger mencakup halaman, karena itulah, spesifik terhadap halaman tertentu. Jika Anda menggunakan ID pengguna yang valid namun dengan token akses halaman yang terhubung dengan halaman yang berbeda, maka panggilan tersebut tidak akan berfungsi. Pastikan untuk menggunakan ID pengguna dan token akses halaman yang terhubung dengan halaman yang sama.
• Anda baru saja mengirim nomor telepon yang belum diverifikasi. Saat menggunakan API Kirim dengan nomor telepon, kami hanya akan mengirim pesan jika nomor telepon baru saja diverifikasi. Bahkan jika nomor telepon ditampilkan sebagai sudah diverifikasi, namun ternyata belum diverifikasi, maka pengiriman akan gagal. Verifikasi ulang nomor telepon Anda dan tunggu 24 jam sebelum mencobanya lagi.

Berikut ini adalah solusi sementara untuk menggunakan pengguna uji platform pada integrasi platform messenger Anda:

1. Dari halaman Peran aplikasi Anda, buat pengguna uji baru dengan cara mengeklik tombol Tambahkan.
2. Toggle opsi Otorisasi Pengguna Uji untuk Aplikasi Ini? dan berikan izin "manage_pages" serta "page_messaging".
3. Gunakan Tombol Sunting dan dapatkan token akses untuk pengguna ini (menggunakan v2.6). Simpan ini untuk nanti.
4. Gunakan tombol Sunting untuk masuk sebagai pengguna uji.
5. Setelah masuk, buat halaman sebagai pengguna uji.
6. Gunakan token akses pengguna untuk pengguna uji guna mendapatkan token akses halaman untuk pengguna ini. Anda dapat melakukan hal ini dengan panggilan berikut:

   https://graph.facebook.com/v2.6/me/accounts?access_token=[TEST_USER_ACCESS_TOKEN]

   (Dokumentasi)
7. Gunakan token akses halaman ini untuk menautkan Aplikasi Facebook dengan Halaman Anda:

   https://graph.facebook.com/v2.6/me/subscribed_apps?method=POST&access_token=[TEST_USER_PAGE_ACCESS_TOKEN]
           

   (Dokumentasi)
8. Setelah Anda mengikuti langkah berikut ini, Anda akan menerima pembaruan RTU di Halaman Uji Anda dan Anda akan dapat mengirim pesan ke Pengguna Uji dari Halaman Uji Anda. Sebagai tambahan, Anda dapat mengganti token akses dengan token yang masa berlakunya panjang jika token tersebut terlalu cepat kedaluwarsa untuk pengujian Anda. Harap ikuti dokumentasi tersebut di sini:

   GET /oauth/access_token?  
       grant_type=fb_exchange_token&           
       client_id={app-id}&
       client_secret={app-secret}&
       fb_exchange_token={short-lived-token} 
           

Ya, bot dapat berisi kedua jenis pengiriman pesan tersebut. Seseorang harus memicu pengiriman pesan platform standar melalui salah satu pemicu yang memenuhi syarat dan harus menyetujui pengiriman pesan berlangganan.

Secara teknis, bot tidak akan dapat mengirim pesan kepada pengguna lebih dari sekali setelah interval 24 jam (pesan tidak akan dikirim). Selama masa transisi bot yang sudah ada, pesan ini akan masuk tetapi akan ditandai jika ditemukan.

Tidak. Platform Messenger tidak menawarkan API yang mengembalikan daftar PSID untuk semua orang yang telah memilih untuk menerima pesan dari bot Anda.

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.

Panggilan ke webhook berisi kolom di header yang bernama X-Hub-Signature, yang bisa digunakan untuk memvalidasi panggilan yang berasal dari Facebook.

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.

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