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.
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 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.
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>" }
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"
}
}
]
}
]
}
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.
{ "content_type":"user_phone_number" }
Ketika pengguna mengetuk balasan cepat, nomor telepon akan diteruskan di atribut payload
dari peristiwa Webhooks messages
.
{
"object": "page",
"entry": [
{
"id": "
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.
{ "content_type":"user_email" }
Ketika pengguna mengetuk balasan cepat, alamat email akan diteruskan di atribut payload
dari peristiwa Webhooks messages
.
{
"object": "page",
"entry": [
{
"id": "
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.