Referensi Peristiwa Webhooks

Peristiwa Webhooks adalah cara Platform Messenger memberi tahu bot Anda ketika terjadi berbagai interaksi atau peristiwa, termasuk saat seseorang mengirimkan pesan. Peristiwa Webhooks dikirimkan oleh Platform Messenger sebagai permintaan POST ke Webhooks Anda.

Catatan: Anda harus berlangganan semua aplikasi berkirim pesan untuk bisnis Anda ke Webhooks berkirim pesan.

Daftar Peristiwa Webhook

Di bawah ini adalah daftar peristiwa yang dapat dikirimkan ke Webhooks Anda dari Platform Messenger.

Catatan: Disarankan agar Anda menggunakan versi API terbaru untuk menerima semua informasi yang tersedia untuk setiap Webhook.

Peristiwa Webhook	Keterangan
`messages`	Berlangganan peristiwa Pesan Diterima
`messaging_account_linking`	Berlangganan peristiwa Penautan Akun
`messaging_checkout_updates` (beta)	Berlangganan peristiwa Update Proses Pembayaran
`message_deliveries`	Berlangganan peristiwa Pesan Terkirim
`message_echoes`	Berlangganan peristiwa Pesan Echo
`messaging_game_plays`	Berlangganan ke peristiwa Game Instan
`messaging_handovers` (beta)	Berlangganan ke peristiwa Protokol Handover
`messaging_optins`	Berlangganan peristiwa Pilihan Menerima Plugin
`messaging_payments` (beta)	Berlangganan peristiwa Pembayaran
`messaging_policy_enforcement`	Berlangganan ke peristiwa Penegakan Kebijakan
`messaging_postbacks`	Berlangganan peristiwa Kiriman Ulang Diterima
`messaging_pre_checkouts` (beta)	Berlangganan ke peristiwa Sebelum Proses Pembayaran
`message_reads`	Berlangganan peristiwa Pesan Dibaca
`messaging_referrals`	Berlangganan peristiwa Referal
`standby` (beta)	Berlangganan ke peristiwa Saluran Siaga Protokol Handover

Format Peristiwa

Semua panggilan balik untuk Platform Messenger memiliki set properti umum yang menyediakan informasi yang akan Anda butuhkan untuk memproses dan menanggapi input dari orang yang menggunakan bot Anda. Selain properti di bawah ini, setiap peristiwa juga memiliki properti khusus yang memerinci peristiwa tersebut.

{
  "object":"page",
  "entry":[
    {
      "id":"<PAGE_ID>",
      "time":1458692752478,
      "messaging":[
        {
          "sender":{
            "id":"<PSID>"
          },
          "recipient":{
            "id":"<PAGE_ID>"
          },

          ...
        }
      ]
    }
  ]
}

Properti

Properti	Jenis	Deskripsi
`object`	String	Nilai akan berupa `page`
`entry`	Array `entry`	Array yang berisi data peristiwa

`entry`

Properti	Jenis	Deskripsi
`id`	String	ID Halaman
`time`	Angka	Waktu pembaruan (waktu epoch dalam milidetik)
`messaging`	Array<`messaging`>	Array berisi objek `messaging`. Perhatikan bahwa meskipun ini adalah array, ini hanya akan menyertakan satu objek `messaging`.

`entry.messaging`

Properti	Jenis	Deskripsi
`sender.id`	String	ID pengguna pengirim
`recipient.id`	String	ID pengguna penerima

Pelajari selengkapnya

Jika Anda memiliki beberapa aplikasi yang menangani pesan, contoh: satu aplikasi menangani tanggapan otomatis dan satu aplikasi menangani eskalasi ke agen manusia, Anda perlu menerapkan Protokol Serah Terima untuk meneruskan percakapan dari satu aplikasi ke aplikasi lainnya. Protokol Serah Terima