messages
Panggilan balik ini akan terjadi ketika pesan telah dikirim ke Halaman Anda. Pesan selalu dikirim berurutan. Anda mungkin menerima pesan teks atau pesan dengan lampiran.
Jenis lampiran image
, audio
, video
, file
, dan reel
adalah jenis utama yang didukung. Anda juga dapat menerima lampiran fallback
. Contoh umum dari 'fallback' adalah ketika pengguna membagikan URL dengan Halaman, lampiran dibuat berdasarkan pembagian tautan. Untuk pembagian yang tidak didukung yang dilakukan oleh pengguna ke Halaman Anda, fallback
tanpa muatan dapat dikirimkan.
Anda dapat berlangganan panggilan balik ini dengan memilih message
saat menyiapkan Webhooks Anda.
{ "sender":{ "id":"<PSID>" }, "recipient":{ "id":"<PAGE_ID>" }, "timestamp":1458692752478, "message":{ "mid":"mid.1457764197618:41d102a3e1ae206a38", "text":"hello, world!", "quick_reply": { "payload": "<DEVELOPER_DEFINED_PAYLOAD>" } } }
{ "sender":{ "id":"<PSID>" }, "recipient":{ "id":"<PAGE_ID>" }, "timestamp":1458692752478, "message":{ "mid":"m_1457764197618:41d102a3e1ae206a38", "text":"hello, world!", "reply_to": { "mid":"m_1fTq8oLumEyIp3Q2MR-aY7IfLZDamVrALniheU" } } }
{
"id": "682498302938465",
"time": 1518479195594,
"messaging": [
{
"sender": {
"id": "
Webhooks pesan dari template produk hanya tersedia di Graph API v8.0+
Webhooks ini berlaku untuk skenario ketika pengguna membagikan produk dari utas atau alur bagikan lain ke halaman. Webhooks ini terbatas hanya pada produk yang dimiliki oleh halaman. Aplikasi harus memiliki persetujuan izin catalog_management
untuk menerima detail produk di Webhooks.
{
"id": "682498302938465",
"time": 1518479195594,
"messaging": [
{
"sender": {
"id": "
Contoh berlaku untuk messages
di versi +v6.0
{ "object": "page", "entry": [ { "id": "<PAGE_ID>", "time": 1583173667623, "messaging": [ { "sender": { "id": "<PSID>" }, "recipient": { "id": "<PAGE_ID>" }, "timestamp": 1583173666767, "message": { "mid": "m_toDnmD...", "text": "This is where I want to go: https:\/\/youtu.be\/bbo_fZAjIhg", "attachments": [ { "type": "fallback", "payload": { "url": "<ATTACHMENT_URL >", "title": "TAHITI - Heaven on Earth" } } ] } } ] } ] }
Webhooks pesan dari halaman detail produk di Toko hanya tersedia di Graph API v8.0+
{ "sender":{ "id":"<PSID>" }, "recipient":{ "id":"<PAGE_ID>" }, "timestamp":1458692752478, "message":{ "mid":"mid.1457764197618:41d102a3e1ae206a38", "text":"hello, world!", "referral": { "product": { "id":"<PRODUCT_ID>" } } } }
{ "object": "page", "entry": [ { "id": "<PAGE_ID>", "time": 1697643211842, "messaging": [ { "sender": { "id": "<PSID>" }, "recipient": { "id": "<PAGE_ID>" }, "timestamp": 1697643027400, "message": { "mid": "m_3vs...", "text": "find flights from SFO to LAX next Thursday", "commands": [ { "name": "flights" } ] } } ] } ] }
sender
sender Field | Description |
---|---|
| The Page-scoped ID for the person who sent a message to your business |
| The reference for a person who used the Chat Plugin to messsage your business |
recipient
recipient Field | Description |
---|---|
| The ID for your Facebook Page |
message
Untuk v6.0+ sticker_id
dipindahkan dari message
, ke message.attachments.payload
Properti | Jenis | Deskripsi |
---|---|---|
| String | ID Pesan |
| String | Teks pesan |
| Objek | Data khusus opsional yang disediakan oleh aplikasi pengirim |
| Objek | Referensi ke ID pesan (mid) yang dibalas oleh pesan ini |
| Array< | Array berisi data lampiran |
| Objek | Rujukan pesan dari halaman detail produk di Toko. |
message.quick_reply
Muatan quick_reply
hanya disediakan dengan pesan teks ketika pengguna mengetuk tombol Balasan Cepat.
Properti | Jenis | Deskripsi |
---|---|---|
| String | Data khusus yang disediakan oleh aplikasi |
message.reply_to
Properti | Jenis | Deskripsi |
---|---|---|
| String | Referensi ke ID pesan yang dibalas oleh pesan ini |
message.attachments
Properti | Jenis | Deskripsi |
---|---|---|
| String |
|
| String |
message.attachments.payload
Properti | Jenis | Deskripsi |
---|---|---|
| String | URL dari jenis lampiran. Berlaku untuk jenis lampiran: |
| String | Judul lampiran. Berlaku untuk jenis lampiran: |
| Angka | Id persisten stiker ini, contoh: |
| Angka | ID video yang terkait dengan reel terlampir. Berlaku untuk jenis lampiran: |
message.attachments.payload.product.elements
Properti | Jenis | Deskripsi |
---|---|---|
| String | ID Produk dari katalog produk Facebook |
| String | ID eksternal yang dikaitkan dengan Produk. (misalnya: SKU / ID Konten) |
| String | URL produk |
| String | Judul produk |
| String | Subjudul produk |
message.referral
Muatan referral
hanya disediakan ketika pengguna mengirim pesan dari halaman detail produk di Toko.
Properti | Jenis | Deskripsi |
---|---|---|
| Objek | Informasi produk |
message.referral.product
Properti | Jenis | Deskripsi |
---|---|---|
| String | ID Produk |
message.commands
Properti | Jenis | Deskripsi |
---|---|---|
| String | Nama perintah |