Platform Messenger

Referensi Plugin Web

Platform Messenger mendukung serangkaian plugin web yang memudahkan Anda untuk memulai percakapan dengan orang yang mengunjungi Anda di web. Semua plugin diterapkan dengan Facebook SDK untuk JavaScript.

Konten

Plugin Obrolan Pelanggan (beta)

Dengan plugin obrolan pelanggan di Platform Messenger, Anda dapat mengintegrasikan bot Messenger langsung ke situs web Anda. Ini memungkinkan pelanggan Anda berinteraksi dengan bisnis Anda kapan saja dengan pengalaman personalisasi yang kaya akan media seperti yang mereka dapatkan di Messenger.

Untuk detail penggunaan, lihat Plugin Obrolan Pelanggan.

Sertakan Format

<div class="fb-customerchat"
 page_id="<PAGE_ID>">
</div>

Atribut

Atribut Jenis Deskripsi

class

String

Nilainya harus berupa fb-customerchat.

page_id

String

ID Halaman Anda

ref

String

Opsional. String khusus yang diteruskan ke Webhooks Anda dalam peristiwa messaging_postbacks dan messaging_referrals.

theme_color

String

Opsional. Warna yang akan digunakan sebagai tema untuk plugin, termasuk warna latar belakang ikon plugin obrolan pelanggan dan warna latar belakang pesan yang dikirimkan oleh pengguna. Mendukung kode warna heksadesimal yang diawali dengan tanda nomor (misalnya: #0084FF), kecuali putih. Kami sangat merekomendasikan Anda untuk memilih warna yang memiliki kontras tinggi terhadap warna putih.

logged_in_greeting

String

Opsional. Teks salam yang akan ditampilkan jika pengguna saat ini sudah login ke Facebook. Maksimal 80 karakter.

logged_out_greeting

String

Opsional. Teks salam yang akan ditampilkan jika pengguna saat ini belum login ke Facebook. Maksimal 80 karakter.

greeting_dialog_display

String

Opsional. Menetapkan bagaimana tampilan dialog salam. Nilai-nilai berikut didukung:


  • show: Dialog salam akan selalu ditampilkan ketika plugin dimuat.
  • fade: Dialog salam dari plugin akan ditampilkan, lalu memudar dan tetap tersembunyi setelahnya.
  • hide: Dialog salam dari plugin akan selalu tersembunyi sampai pengguna mengeklik plugin.

Default-nya adalah show di desktop dan hide di perangkat seluler.

greeting_dialog_delay

String

Opsional. Mengatur jumlah durasi penundaan dalam hitungan detik untuk tampilnya dialog salam setelah plugin dimuat. Ini dapat digunakan untuk menyesuaikan waktu tampilnya dialog salam.

minimized

Boolean

Pemberitahuan Penghentian

Atribut ini sekarang tidak berlaku lagi. Gunakan greeting_dialog_display untuk menyesuaikan plugin Anda sebagai gantinya. Atribut greeting_dialog_delay akan diutamakan daripada atribut minimized.

Opsional.

  • true Jika diatur ke true, efeknya akan sama dengan mengatur greeting_dialog_delay = "fade".
  • false Jika diatur ke false, efeknya akan sama dengan mengatur greeting_dialog_delay = "show".

Plugin Kirimi Kami Pesan

Membawa seseorang langsung ke percakapan di Messenger.

Untuk detail penggunaan, lihat Plugin Kirimi Kami Pesan.

Sertakan Format

<div class="fb-messengermessageus" 
  messenger_app_id="<APP_ID>" 
  page_id="<PAGE_ID>"
  color="<blue | white>"
  size="<standard | large | xlarge>">
</div>

Atribut

Atribut Atribut HTML5 Jenis Deskripsi

class

String

Nilainya harus berupa fb-messengermessageus.

page_id

String

ID Halaman Anda

messenger_app_id

Angka

ID Aplikasi Facebook Anda.

color

data-color

String

Warna tombol: blue atau white.


Default-nya adalah blue.

size

data-size

String

Ukuran tombol: standard, large, atau xlarge.


Default-nya adalah large.

ref

String

Opsional. String khusus yang diteruskan ke Webhooks Anda dalam peristiwa messaging_postbacks dan messaging_referrals.

Plugin Kirim ke Messenger

Mengirim pesan ke seseorang dari bot Messenger Anda di latar belakang dan buat mereka ikut serta.

Untuk detail penggunaan, lihat Plugin Kirim ke Messenger.

Sertakan Format

<div class="fb-send-to-messenger" 
  messenger_app_id="<APP_ID>" 
  page_id="PAGE_ID" 
  data-ref="<PASS_THROUGH_PARAM>" 
  color="<blue | white>" 
  size="<standard | large | xlarge>">
</div>

Atribut

Atribut Jenis Deskripsi

class

String

Nilainya harus berupa fb-send-to-messenger.

page_id

String

ID Halaman Anda

messenger_app_id

Angka

ID Aplikasi Facebook Anda.

color

String

Opsional. Warna tombol: blue atau white.


Default-nya adalah blue.

size

String

Opsional. Ukuran tombol: standard, large, atau xlarge.


Default-nya adalah large.

ref

String

Opsional. Parameter status khusus. Maks 250 karakter.


Karakter yang valid adalah a-z A-Z 0-9 +/=-._


Harus dienkode dan dienkripsi demi tujuan keamanan.

enforce_login

Boolean

Opsional. Jika true, pengguna yang telah login harus login lagi saat mengeklik tombolnya. Default-nya adalah false.

Gunakan parameter ref untuk melewati status dengan autentikasinya. Jika Anda memunculkan plugin di beberapa tempat, Anda mungkin ingin mengubah status berdasarkan tempat munculnya plugin.

Plugin Kotak Centang

Plugin kotak centang membuat seseorang berlangganan ke bot Messenger Anda sebagai bagian dari formulir, seperti proses pembayaran atau pendaftaran.

Untuk detail penggunaan, lihat Plugin Kotak Centang.

Sertakan Format

<div class="fb-messenger-checkbox"  
  origin=<PAGE_DOMAIN>
  page_id=<PAGE_ID>
  messenger_app_id=<APP_ID>
  user_ref="<UNIQUE_REF_PARAM>"
  prechecked="<true | false>"
  allow_login="<true>"
  size="<small | medium | large | standard | xlarge>"
  skin="<light|dark>"
  center_align="<true|false>">
</div>

Atribut

Atribut Jenis Deskripsi

class

String

Nilai harus berupa fb-messenger-checkbox

page_id

Angka

ID Halaman Facebook yang terkait dengan bot Anda.

messenger_app_id

Angka

ID Aplikasi Facebook Anda.

user_ref

String

Parameter unik untuk referensi pengguna. Maks 250 karakter.


Karakter yang valid adalah a-z A-Z 0-9 +/=-._

allow_login

Boolean

Opsional. Memungkinkan orang untuk login jika tidak ada sesi lagi saat ini. Default-nya adalah true.

size

String

Opsional. Ukuran plugin: small, medium, large, standard, xlarge.


Default-nya adalah large.

skin

String

Opsional. Mengatur tema warna untuk konten plugin. Opsi berikut didukung:

  • light: Plugin di-render dengan teks berwarna gelap.
  • dark: Plugin di-render dengan teks putih, ikon Messenger transparan, dan petir putih.

Default-nya adalah light.

center_align

Boolean

Opsional. Atur apakah konten plugin harus rata tengah.


Default-nya adalah false.