Platform Messenger

Tombol

Sebagian besar template pesan, juga menu persisten, tombol dukungan yang meminta berbagai jenis tindakan. Tombol-tombol ini memungkinkan Anda dengan mudah menawarkan tindakan penerima pesan yang dapat mereka lakukan untuk menanggapi template, seperti membuka tampilan web Messenger, memulai aliran pembayaran, mengirim pesan postback ke webhook Anda, dan banyak lagi.

Untuk template pesan, tombol ditentukan oleh objek di array buttons. Untuk menu persisten, tombol ditentukan oleh objek di array call_to_actions.

Tombol URL

Tombol URL membuka halaman web di tampilan web Messenger. Hal ini memungkinkan Anda untuk memperkaya percakapan dengan pengalaman berbasis web, tempat Anda memiliki fleksibilitas pengembangan web secara penuh. Contoh: Anda dapat menampilkan ringkasan produk dalam percakapan, lalu menggunakan tombol URL untuk membuka halaman produk lengkap di situs Anda.

Jika situs berisi Tautan Aplikasi, tombol tersebut akan meluncurkan aplikasi native yang ditentukan.

Crawler Facebook perlu membaca tanda meta tautan aplikasi agar pengalihan berfungsi. Perhatikan bahwa jika Anda baru saja menerapkan tanda di situs web Anda, Anda dapat meminta scrape baru dengan Fitur Sharing Debugger. Setelah crawler menghapus situs tersebut, tombol URL baru yang dikirim harus mengikuti perilaku pengalihan.

Penggunaan yang Didukung

Tombol URL didukung untuk digunakan dengan yang berikut:

  • Menu Persisten
  • Template Generik
  • Template Daftar
  • Template Tombol
  • Template Media

SDK Ekstensi Messenger - Wajib Memasukkan Domain ke Daftar Putih

Untuk menampilkan halaman web dengan SDK Ekstensi Messenger diaktifkan di tampilan web Messenger, Anda harus memasukkan domain dalam daftar putih, termasuk sub-domain, di whitelisted_domains properti Profil Messenger bot Anda. Ini memastikan bahwa hanya domain tepercaya yang memiliki akses ke informasi pengguna yang tersedia melalui fungsi SDK.

Untuk informasi selengkapnya tentang memasukkan domain dalam daftar putih, lihat referensi whitelisted_domains.

Format Tombol

Untuk daftar lengkap properti tombol, lihat referensi tombol URL.

{
  "type": "web_url",
  "url": "

Tombol Postback

Tombol postback mengirim peristiwa messaging_postbacks ke webhook Anda dengan string diatur di properti payload. Ini memungkinkan Anda mengambil tindakan arbitrer saat tombol diketuk. Contoh: Anda mungkin menampilkan daftar produk, lalu mengirimkan ID produk dalam postback ke webhook Anda, yang dapat digunakan untuk menanyakan database Anda dan menampilkan detail produk sebagai pesan terstruktur.

Penggunaan yang Didukung

Tombol postback didukung untuk digunakan dengan yang berikut ini:

  • Menu Persisten
  • Template Generik
  • Template Daftar
  • Template Tombol
  • Template Media

Format Tombol

Untuk daftar lengkap properti tombol, lihat referensi tombol postback.

{
  "type": "postback",
  "title": "

Tombol Panggil

Tombol telepon akan menghubungi nomor telepon saat diketuk. Nomor telepon haruslah dalam format +<COUNTRY_CODE><PHONE_NUMBER>, misal: +15105559999.

Penggunaan yang Didukung

Tombol telepon didukung untuk digunakan dengan yang berikut:

  • Template Generik
  • Template Daftar
  • Template Tombol
  • Template Media

Format Tombol

Untuk daftar lengkap properti tombol, lihat referensi tombol telepon.

{
  "type":"phone_number",
  "title":"

Tombol Login

Tombol login digunakan dalam alur penautan akun, yang memungkinkan Anda menautkan identitas penerima pesan di Messenger dengan akun mereka di situs Anda dengan mengarahkan mereka ke alur masuk berbasis web Anda untuk autentikasi.

Untuk informasi selengkapnya tentang menggunakan tombol login untuk penautan akun, lihat Penautan Akun.

Penggunaan yang Didukung

Tombol login didukung untuk digunakan dengan berikut ini:

  • Template Generik
  • Template Daftar
  • Template Tombol
  • Template Media

Format Tombol

Untuk daftar lengkap properti tombol, lihat referensi tombol login.

{
  "type": "account_link",
  "url": "

Tombol Keluar

Tombol keluar digunakan dalam alur penautan akun untuk memutuskan tautan identitas penerima pesan di Messenger dengan akun mereka di situs Anda.

Untuk informasi selengkapnya tentang menggunakan tombol keluar untuk membatalkan tautan akun, lihat Penautan Akun.

Penggunaan yang Didukung

Tombol keluar didukung untuk digunakan dengan yang berikut ini:

  • Template Generik
  • Template Daftar
  • Template Tombol
  • Template Media

Format Tombol

Untuk daftar lengkap properti tombol, lihat referensi tombol keluar.

{
  "type": "account_unlink"
}

Tombol Main Game

Tombol main game meluncurkan Game Instan yang dikaitkan dengan Halaman Facebook Anda. Untuk menyesuakan cara game Anda dibuka, Anda dapat mengatur properti payload dalam permintaan yang akan dikirim ke game saat peluncuran, serta properti game_metadata.player_id atau game_metadata.context_id opsional, yang mengizinkan bot Anda untuk memulai game dalam konteks tertentu melawan satu pemain atau grup yang sudah ada.

Format Tombol

Properti payload harus berserialisasi JSON. Itu dideserialisasi oleh SDK Game Instan.

Untuk daftar lengkap properti tombol, lihat Referensi Tombol Main Game.

{
  "type":"game_play",
  "title":"Play",
  "payload":"{

Buka peristiwa webhook Main Game untuk acara yang akan dikirim ke bot saat pengguna menyelesaikan babak permainan.

Praktik Terbaik

Gunakan tombol untuk meminta tindak lanjut atau interaksi lebih lanjut dengan pesan tertentu.

Mulailah dengan kata kerja untuk membantu orang memahami tindakan yang mereka lakukan.

Gunakan tombol URL untuk tugas yang ingin Anda selesaikan di situs web Anda (misal: pembelian, penautan akun, dsb.). Buat dengan jelas bahwa Anda mengirim orang keluar Messenger.

Kirim tanggapan setelah seseorang mengetuk tombol panggilan balik. Ini mengonfirmasi bahwa Anda sudah memproses atau menyelesaikan tindakan mereka (misal: membatalkan pemesanan, menjawab pertanyaan).

Jangan gunakan tombol jika tindakannya bergantung pada status bot saat ini, karena tombol tersebut akan tersedia secara permanen di utas.

Jangan gunakan lebih dari 1-3 kata atau menambahkan tanda baca. Coba jaga teks Anda tetap di bawah 20 karakter, termasuk spasi.

Jangan mengandalkan URL untuk setiap tombol. Makin banyak interaksi yang dapat Anda buat di Messenger, makin lancar pengalaman Anda nantinya.

Jangan gunakan satu tombol panggilan balik saja. Jika hanya ada satu tombol untuk dipilih, orang sering mengira itu lanjutan dari teks pesan Anda dan tidak memahami bahwa itu adalah tindakan yang Anda ingin mereka lakukan.