Notifikasi Satu Kali (Beta)

Ringkasan

API Notifikasi Satu Kali (Beta) di Platform Messenger memungkinkan halaman meminta pengguna untuk mengirim satu pesan tindak lanjut setelah termin berkirim pesan 24 jam berakhir. Pengguna akan ditawari untuk menerima notifikasi di masa mendatang. Setelah pengguna meminta untuk dikirimi notifikasi, halaman tersebut akan menerima token yang setara dengan izin untuk mengirim satu pesan ke pengguna. Token hanya dapat digunakan sekali dan akan kedaluwarsa dalam 1 tahun pembuatan.

Izin

Halaman yang tertarik untuk menggunakan API ini perlu mengajukan izin "Notifikasi Satu Kali" dalam bagian "Pesan Lanjutan" pada Pengaturan Halaman. Halaman harus menyetujui persyaratan beta dan akan diberikan izin jika halaman tersebut memenuhi kriteria kami.

Konten

• Penggunaan
• Mengirimkan permintaan Notifikasi Satu Kali
• Mengirim pesan tindak lanjut
• Peristiwa Webhook
• Larangan dan Batasan

Penggunaan

• Jangan membingungkan, menipu, menipu, menyesatkan, mengirim spam, atau mengejutkan siapa pun. Pastikan bahwa ada hubungan yang jelas antara pesan ide dan konten dari pesan. Konten permintaan notifikasi satu kali dan pesan harus sesuai dengan standar komunitas.
• Halaman yang menerima banyak masukan negatif dari pengguna, atau yang membingungkan, menipu, menipu, menyesatkan, atau secara negatif mengejutkan pengguna akan kehilangan akses ke API.

Mengirimkan permintaan Notifikasi Satu Kali

Menggunakan API Kirim, halaman dapat mengirim pesan permintaan notifikasi sebagai template. Jenis template haruslah one_time_notif_req. Isi permintaan mengikuti format standar untuk semua jenis template, dengan properti message.attachment.payload yang memuat jenis dan detail konten khusus untuk setiap jenis template. Anda hanya diizinkan untuk menyesuaikan judul dan muatan permintaan. Kolom title dibatasi 65 karakter.

{
  "recipient": {
    "id":"

Template permintaan Notifikasi Satu Kali akan ditampilkan dan setelah pengguna mengeklik tombol Beri Tahu Saya, webhook message_optins akan disampaikan ke backend Anda dan one_time_notif_token dapat digunakan untuk mengirim pesan tindak lanjut satu kali kepada pengguna di luar periode 24 jam.

Mengirim pesan tindak lanjut

Untuk mengirim pesan tindak lanjut, kirimkan permintaan POST ke API Kirim, dengan one_time_notif_token yang diperoleh melalui Webhooks dan message.text diatur di badan permintaan:

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient": {
    "one_time_notif_token":"<ONE_TIME_TOKEN>"
  },
  "message": {
    "text":"<MESSAGE_CONTENT>"
  }
}' "https://graph.facebook.com/v21.0/me/messages?access_token=<PAGE_ACCESS_TOKEN>"

Untuk mengirim pesan kaya, ganti teks dengan konten kaya. Baca Referensi API Kirim untuk daftar lengkap jenis pesan yang didukung. one_time_notif_token hanya dapat digunakan sekali dan akan dibatalkan setelah pengiriman pesan berhasil.

Peristiwa Webhooks

Saat pengguna setuju untuk dikirimi notifikasi tentang pembaruan tertentu, Anda akan mendapatkan peristiwa webhook dengan payload dan one_time_notif_token. Anda perlu menyimpan muatan dan token untuk mengirim pesan tindak lanjut ketika informasi tersedia. Perhatikan bahwa tidak akan ada API terpisah untuk membuat kueri daftar one_time_notif_token, karenanya penting bagi Anda untuk memproses dan menyimpan info webhook saat diterima. Setiap token hanya dapat digunakan sekali dan akan kedaluwarsa dalam satu tahun waktu pembuatan.

{
   "sender": {
     "id":"<PSID>"
   },
   "recipient": {
     "id":"<PAGE_ID>"
   },
   "timestamp":1458692752478,
   "optin": {
     "type": "one_time_notif_req",
     "payload": "<USER_DEFINED_PAYLOAD>",
     "one_time_notif_token":"<ONE_TIME_TOKEN>",
   }
}

Larangan dan Batasan

• Jangan gunakan kolom muatan untuk mengirim kata sandi, kredensial pengguna, informasi yang mengidentifikasi pengguna secara pribadi (yaitu, informasi seperti nama atau alamat email yang dengan sendirinya dapat digunakan untuk menghubungi seseorang atau mengidentifikasi siapa mereka), atau informasi sensitif lainnya (seperti kesehatan, keuangan, pembayaran atau data pemegang kartu, atau kategori informasi lain yang didefinisikan sebagai sensitif menurut hukum yang berlaku).
• Jumlah permintaan Notifikasi Satu Kali tunduk pada batas laju untuk menghindari pengalaman pengguna yang buruk.

Pertanyaan Umum

Informasi lebih lanjut dapat ditemukan di halaman pertanyaan umum.