Balasan Cepat

Balasan cepat memberikan cara untuk menampilkan maksimum 13 tombol dalam percakapan yang berisi judul dan gambar opsional, serta terlihat jelas di atas kolom tulis. Anda juga dapat menggunakan balasan cepat untuk meminta lokasi, alamat email, dan nomor telepon seseorang.


Saat sebuah balasan cepat diketuk, tombol akan hilang, dan judul dari tombol yang diketuk itu akan diposting ke percakapan sebagai pesan. Peristiwa messages akan dikirim ke Webhooks Anda yang berisi judul tombol dan muatan opsional.

Untuk daftar lengkap properti permintaan, lihat Referensi Balasan Cepat.

Mengirim Balasan Cepat

Untuk mengirim balasan cepat, tambahkan array quick_replies ke pesan teks, dan sertakan objek yang menetapkan hingga 13 tombol balasan cepat.

Berikut adalah jenis balasan cepat yang didukung:

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient":{
    "id":"<PSID>"
  },
  "messaging_type": "RESPONSE",
  "message":{
    "text": "Pick a color:",
    "quick_replies":[
      {
        "content_type":"text",
        "title":"Red",
        "payload":"<POSTBACK_PAYLOAD>",
        "image_url":"http://example.com/img/red.png"
      },{
        "content_type":"text",
        "title":"Green",
        "payload":"<POSTBACK_PAYLOAD>",
        "image_url":"http://example.com/img/green.png"
      }
    ]
  }
}' "https://graph.facebook.com/v21.0/me/messages?access_token=<PAGE_ACCESS_TOKEN>"    

Balasan Cepat Teks

Balasan cepat teks dapat juga dikirimkan dengan gambar opsional yang muncul sebagai ikon di samping judul. Jika content_type untuk balasan cepat ditetapkan sebagai text, title harus diatur dan tidak boleh kosong.

Sintaksis

Untuk daftar lengkap properti permintaan, lihat Referensi Balasan Cepat.

{
  "content_type":"text",
  "title":"<BUTTON_TEXT>",
  "image_url":"http://example.com/img/red.png",
  "payload":"<DEVELOPER_DEFINED_PAYLOAD>"
}

Peristiwa Webhooks

Saat balasan cepat diketuk, sebuah pesan teks akan dikirim ke Webhooks Panggilan Balik Pesan Diterima Anda.

Properti text dari peristiwa itu akan sesuai dengan judul Balasan Cepat. Objek pesan juga akan berisi sebuah kolom bernama quick_reply yang berisi data payload di Balasan Cepat.

{
  "object": "page",
  "entry": [
    {
      "id": "<PAGE_ID>",
      "time": 1502905976963,
      "messaging": [
        {
          "sender": {
            "id": "1254459154682919"
          },
          "recipient": {
            "id": "682498171943165"
          },
          "timestamp": 1502905976377,
          "message": {
            "quick_reply": {
              "payload": "DEVELOPER_DEFINED_PAYLOAD_FOR_PICKING_GREEN"
            },
            "mid": "m_AG5Hz2Uq7tuwNEhXfYYKj8mJEM_QPpz5jdCK48PnKAjSdjfipqxqMvK8ma6AC8fplwlqLP_5cgXIbu7I3rBN0P",
            "text": "Green"
          }
        }
      ]
    }
  ]
}

Balasan Cepat Nomor Telepon Pengguna

Dengan balasan cepat nomor telepon pengguna, Anda dapat meminta nomor telepon pengguna. Ketika balasan cepat nomor telepon terkirim, Platform Messenger akan secara otomatis mengisi balasan cepat yang ditampilkan dengan nomor telepon dari informasi profil pengguna.

Jika profil pengguna tidak memiliki informasi nomor telepon, maka balasan cepat tidak akan ditampilkan.

Bot tidak akan menerima nomor telepon sampai pengguna mengeklik balasan cepat.

Memilih balasan cepat akan mengirimkan informasi satu kali dan bukan merupakan izin untuk mengakses informasi di masa mendatang.

Sintaksis

{
  "content_type":"user_phone_number"
}

Peristiwa Webhooks

Ketika pengguna mengetuk balasan cepat, nomor telepon akan diteruskan di atribut payload dari peristiwa Webhooks messages.

{
  "object": "page",
  "entry": [
    {
      "id": "

Balasan Cepat Email Pengguna

Dengan balasan cepat email pengguna, Anda dapat meminta email pengguna. Ketika balasan cepat email terkirim, Platform Messenger akan secara otomatis mengisi balasan cepat yang ditampilkan dengan email dari informasi profil pengguna.

Jika profil pengguna tidak memiliki informasi alamat email, maka balasan cepat tidak akan ditampilkan.

Bot tidak akan menerima email sampai pengguna mengeklik balasan cepat.

Memilih balasan cepat akan mengirimkan informasi satu kali dan bukan merupakan izin untuk mengakses informasi di masa mendatang.

Sintaksis

{
  "content_type":"user_email"
}

Peristiwa Webhooks

Ketika pengguna mengetuk balasan cepat, alamat email akan diteruskan di atribut payload dari peristiwa Webhooks messages.

{
  "object": "page",
  "entry": [
    {
      "id": "

Praktik Terbaik

Gunakan balasan cepat untuk meminta langkah spesifik selanjutnya.

Singkat dan padat — balasan cepat yang panjang akan dipotong.

Jangan digunakan untuk tindakan yang Anda inginkan untuk menjadi permanen: balasan cepat akan hilang setelah pesan selanjutnya.

Dukungan Developer