Webhooks dari Meta

Webhooks dari Meta

Webhooks memungkinkan Anda menerima notifikasi HTTP realtime tentang perubahan objek tertentu di grafik sosial Meta. Contoh: kami dapat mengirimi Anda notifikasi ketika salah satu Pengguna aplikasi Anda mengubah alamat email mereka atau kapan pun mereka mengomentari Halaman Facebook Anda. Hal ini mencegah Anda dari harus kueri Graph API untuk perubahan pada objek yang mungkin atau mungkin tidak terjadi, dan membantu Anda menghindari mencapai batas laju Anda.

Langkah konfigurasi Webhooks untuk Pembayaran dan Webhooks untuk Messenger sedikit berbeda. Jika Anda sedang menyiapkan Webhooks untuk salah satu produk ini, silakan lihat dokumen masing-masing untuk petunjuk pengaturan.

Objek, Kolom, dan Nilai

Ada banyak jenis objek di grafik sosial Meta, seperti objek Pengguna dan objek Halaman, jadi setiap kali Anda mengonfigurasi Webhooks, Anda harus terlebih dahulu memilih jenis objek. Karena objek yang berbeda memiliki kolom yang berbeda, maka Anda harus berlangganan kolom tertentu untuk jenis objek tersebut. Setiap kali ada perubahan nilai dari setiap kolom objek yang Anda telah berlangganan, kami akan mengirimi Anda notifikasi.

Notifikasi dikirimkan kepada Anda sebagai permintaan POST HTTP dan berisi muatan JSON yang menggambarkan perubahan tersebut. Contoh: misalkan Anda menyiapkan Webhooks User dan berlangganan kolom Photos. Jika salah satu Pengguna aplikasi Anda mengunggah foto, kami akan mengirimi Anda notifikasi yang akan terlihat seperti ini:

Contoh Notifikasi

{
  "entry": [
    {
      "time": 1520383571,
      "changes": [
        {
          "field": "photos",
          "value": {
            "verb": "update",
            "object_id": "10211885744794461"
          }
        }
      ],
      "id": "10210299214172187",
      "uid": "10210299214172187"
    }
  ],
  "object": "user"
}

Server HTTP

Webhooks dikirim menggunakan HTTPS, sehingga server Anda harus dapat menerima dan memproses permintaan HTTPS, dan harus telah menginstal sertifikat TLS/SSL yang valid. Sertifikat yang ditandatangani sendiri tidak didukung.

Tinjauan Aplikasi

Webhooks tidak memerlukan Tinjauan Aplikasi. Namun, untuk menerima notifikasi Webhooks tentang perubahan objek saat aplikasi Anda dalam mode Aktif, aplikasi Anda harus telah diberikan izin yang relevan untuk mengakses objek tersebut. Lihat Izin di bawah ini.

Izin

Sebelum sebuah aplikasi dapat dipublikasikan, biasanya aplikasi harus melalui Tinjauan Aplikasi. Selama tinjauan, aplikasi dapat meminta persetujuan untuk izin tertentu, yang mengontrol jenis data yang dapat diakses aplikasi saat menggunakan Graph API.

Meskipun produk Webhooks tidak memerlukan Tinjauan Aplikasi, produk ini menghormati izin. Ini berarti bahwa meskipun Anda menyiapkan Webhooks dan berlangganan kolom tertentu pada jenis objek, Anda tidak akan menerima notifikasi tentang perubahan apa pun pada objek jenis itu kecuali:

  • aplikasi Anda telah disetujui untuk izin yang sesuai dengan jenis data tersebut, dan
  • objek yang memiliki data telah memberi aplikasi Anda izin untuk mengakses data tersebut (misalnya: Pengguna yang mengizinkan aplikasi Anda untuk mengakses Kabar mereka)

Mode Pengembangan

Aplikasi dalam mode pengembangan hanya dapat menerima notifikasi pengujian yang dimulai melalui dasbor aplikasi atau notifikasi yang dimulai oleh orang-orang yang memiliki peran di aplikasi.

Perhatikan bahwa perilaku mode pengembangan berbeda untuk Peristiwa Webhooks Messenger. Baca dokumen Webhooks untuk Messenger untuk detailnya.

Penyiapan

Untuk menggunakan Webhooks, Anda perlu menyiapkan endpoint di server aman (HTTPS), lalu menambahkan dan mengonfigurasi produk Webhooks di dasbor aplikasi Anda. Sisa dokumen ini menjelaskan cara menyelesaikan kedua langkah ini.

Siap? Ayo mulai!

Pelajari Selengkapnya