Balasan Cepat

Balasan Cepat menyediakan cara baru untuk menyajikan tombol kepada pengguna. Balasan Cepat terlihat dengan jelas di atas bidang pembuat pesan, dengan keyboard tidak begitu terlihat. Ketika balasan cepat diketuk, pesan dikirim ke percakapan dengan metadata yang ditentukan pengembang di callback. Dan juga, tombol ini diabaikan untuk mencegah masalah di mana pengguna dapat mengetuk tombol yang disertakan ke pesan lama di dalam percakapan.

Balasan Cepat berisi teks. Secara opsional, Anda dapat menambahkan gambar.

Anda juga dapat menggunakan Balasan Cepat untuk meminta lokasi seseorang.

Contoh

Hanya teks

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient":{
    "id":"USER_ID"
  },
  "message":{
    "text":"Pick a color:",
    "quick_replies":[
      {
        "content_type":"text",
        "title":"Red",
        "payload":"DEVELOPER_DEFINED_PAYLOAD_FOR_PICKING_RED"
      },
      {
        "content_type":"text",
        "title":"Green",
        "payload":"DEVELOPER_DEFINED_PAYLOAD_FOR_PICKING_GREEN"
      }
    ]
  }
}' "https://graph.facebook.com/v2.6/me/messages?access_token=PAGE_ACCESS_TOKEN"    

Teks dan Gambar

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient":{
    "id":"USER_ID"
  },
  "message":{
    "text":"Pick a color:",
    "quick_replies":[
      {
        "content_type":"text",
        "title":"Red",
        "payload":"DEVELOPER_DEFINED_PAYLOAD_FOR_PICKING_RED",
        "image_url":"http://petersfantastichats.com/img/red.png"
      },
      {
        "content_type":"text",
        "title":"Green",
        "payload":"DEVELOPER_DEFINED_PAYLOAD_FOR_PICKING_GREEN",
        "image_url":"http://petersfantastichats.com/img/green.png"
      }
    ]
  }
}' "https://graph.facebook.com/v2.6/me/messages?access_token=PAGE_ACCESS_TOKEN"    

Lokasi

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient":{
    "id":"USER_ID"
  },
  "message":{
    "text":"Please share your location:",
    "quick_replies":[
      {
        "content_type":"location",
      }
    ]
  }
}' "https://graph.facebook.com/v2.6/me/messages?access_token=PAGE_ACCESS_TOKEN"

Bidang

Objek message

• quick_replies dibatasi hingga 11

Objek attachment

Balasan Cepat berfungsi dengan semua jenis pesan termasuk pesan teks, gambar, dan lampiran templat. Silakan baca dokumentasi API Kirim untuk informasi selengkapnya tentang cara menggunakan objek attachment .

Objek quick_reply

• title mempunyai batas 20 karakter, setelah itu akan dipotong
• payload memiliki batas 1000 karakter
• Jika content_type adalah location, title, dan payload tidak digunakan
• Gambar untuk image_url harus berukuran setidaknya 24x24 dan akan dipotong dan diubah ukurannya

Callback

Saat Balasan Cepat diketuk, sebuah pesan teks akan dikirim ke webhook Callback Pesan Diterima Anda. Teks pesan akan sesuai dengan judul Balasan Cepat. Objek pesan juga akan berisi bidang bernama quick_reply yang berisi data payload di Balasan Cepat.

{
  "sender": {
    "id": "USER_ID"
  },
  "recipient": {
    "id": "PAGE_ID"
  },
  "timestamp": 1464990849275,
  "message": {
    "mid": "mid.1464990849238:b9a22a2bcb1de31773",
    "seq": 69,
    "text": "Red",
    "quick_reply": {
      "payload": "DEVELOPER_DEFINED_PAYLOAD_FOR_PICKING_RED"
    }
  }
}    

Ketika seseorang membagikan lokasinya, callback akan tampil seperti ini:

{
  "object": "page",
  "entry": [
    {
      "id": "PAGE_ID",
      "time": 1472672934319,
      "messaging": [
        {
          "sender": {
            "id": "USER_ID"
          },
          "recipient": {
            "id": "PAGE_ID"
          },
          "timestamp": 1472672934259,
          "message": {
            "mid": "mid.1472672934017:db566db5104b5b5c08",
            "seq": 297,
            "attachments": [
              {
                "title": "Facebook HQ",
                "url": "https://www.facebook.com/l.php?u=https%....5-7Ocxrmg",
                "type": "location",
                "payload": {
                  "coordinates": {
                    "lat": 37.483872693672,
                    "long": -122.14900441942
                  }
                }
              }
            ]
          }
        }
      ]
    }
  ]
}