Webhooks untuk Halaman

Webhooks untuk Halaman dapat mengirimi Anda notifikasi perubahan pada Halaman Anda secara realtime. Contoh: Anda dapat menerima pembaruan realtime setiap kali pengguna memposting ke kabar Anda, mengomentari postingan, atau menyukai postingan Anda.

Untuk menyiapkan Webhooks Halaman:

Siapkan endpoint Anda dan konfigurasikan produk Webhooks.
Instal aplikasi Anda menggunakan halaman Facebook Anda.

Menyiapkan Endpoint dan Produk Webhook Anda

Ikuti panduan Memulai kami untuk membuat endpoint dan mengonfigurasi produk Webhooks. Selama konfigurasi, pastikan untuk memilih objek Halaman dan berlangganan satu atau beberapa kolom Halaman di bawah ini.

Kolom	Deskripsi
`feed`	Memberi tahu Anda ketika beranda Halaman telah berubah; postingan, tanggapan, bagikan, dsb.
`messages`	Memberi tahu Anda ketika halaman Anda telah menerima pesan melalui Messenger. Lihat Panduan Webhooks untuk Messenger untuk daftar semua pesan yang tersedia di kolom Webhooks

Instal Aplikasi Anda

Notifikasi Webhooks hanya akan dikirim jika Halaman Anda telah menginstal aplikasi yang sudah dikonfigurasi Webhooks, dan jika Halaman belum menonaktifkan platform Aplikasi di Pengaturan Aplikasi. Untuk membuat Halaman Anda menginstal aplikasi, minta aplikasi Anda mengirim permintaan POST ke edge subscribed_apps Halaman menggunakan token akses Halaman.

Persyaratan

Token akses Halaman diminta dari orang yang dapat melakukan tugas CREATE_CONTENT, MANAGE, atau MODERATE di Halaman yang sedang di-kueri
Izin pages_manage_metadata dan pages_show_list wajib untuk Webhooks feed
Izin pages_messaging juga wajib untuk messages

Hanya untuk kolom terkait pesan

Token akses Halaman yang diminta dari orang yang dapat melakukan tugas MESSAGING di Halaman yang sedang di-kueri
pages_messaging

Contoh Permintaan

curl -i -X POST "https://graph.facebook.com/{page-id}/subscribed_apps
  ?subscribed_fields=feed
  &access_token={page-access-token}"

Contoh Tanggapan

{
  "success": "true"
}

Untuk melihat aplikasi mana yang telah diinstal Halaman Anda, kirim permintaan GET:

Contoh Permintaan

curl -i -X GET "https://graph.facebook.com/{page-id}/subscribed_apps &access_token={page-access-token}

Contoh Tanggapan

{
  "data": [
    {
      "category": "Business",
      "link": "https://my-clever-domain-name.com/app",
      "name": "My Sample App",
      "id": "{page-id}"
    }
  ]
}

Jika Halaman Anda belum menginstal aplikasi apa pun, API akan menampilkan set data kosong.

Graph API Explorer

Jika tidak ingin menginstal aplikasi Anda secara terprogram, Anda dapat dengan mudah melakukannya dengan Graph API Explorer sebagai gantinya:

Pilih aplikasi Anda di menu pilihan Aplikasi. Ini akan memberikan token akses aplikasi Anda.
Klik Dapatkan Token dan pilih Dapatkan Token Akses Pengguna, lalu pilih izin pages_manage_metadata. Ini akan menukar token aplikasi Anda dengan token akses pengguna dengan izin pages_manage_metadata yang diberikan.
Klik Dapatkan Token lagi dan pilih Halaman Anda. Ini akan menukar token akses Pengguna Anda dengan token akses Halaman.
Ubah metode operasi dengan mengeklik menu pilihan GET dan memilih POST.
Ganti kueri me?fields=id,name default dengan id Halaman diikuti dengan /subscribed_apps, lalu kirimkan kueri.

Penggunaan Umum

Mendapatkan Detail Beranda Halaman

Aplikasi Anda dapat berlangganan Beranda Halaman dan mendapatkan notifikasi kapan saja saat terjadi perubahan terkait Beranda Halaman. Contoh: berikut adalah notifikasi yang dikirim ketika Pengguna memposting ke Halaman.

Contoh Tanggapan Webhooks

[
  {
    "entry": [
      {
        "changes": [
          {
            "field": "feed",
            "value": {
              "from": {
                "id": "{user-id}",
                "name": "Cinderella Hoover"
              },
              "item": "post",
              "post_id": "{page-post-id}",
              "verb": "add",
              "created_time": 1520544814,
              "is_hidden": false,
              "message": "It's Thursday and I want to eat cake."
            }
          }
        ],
        "id": "{page-id}",
        "time": 1520544816
      }
    ],
    "object": "page"
  }
]

Gunakan post_id dari notifikasi ke komentar pada postingan Halaman itu.

Contoh Permintaan API

curl -i -X POST   "https://graph.facebook.com/{page-post-id}/comments
  ?message=I%20want%20chocolate%20cake%20!
  &access_token=page-access-token"

Contoh Tanggapan API

{
  "id": "{comment-id}"
}