Plugin Kirim ke Messenger

Ketika aplikasi Facebook Anda dalam Mode Pengembangan, plugin dan fungsi API hanya akan berfungsi untuk admin, developer, dan penguji aplikasi yang memiliki sesi yang valid. Setelah aplikasi Anda disetujui dan bersifat publik, aplikasi akan berfungsi untuk khalayak ramai.

Plugin "Kirim ke Messenger" digunakan untuk memicu peristiwa autentikasi ke Webhooks Anda. Anda dapat meneruskan data untuk mengetahui pengguna dan transaksi mana yang terkait dengan peristiwa autentikasi, dan menautkan pengguna di back-end Anda.

Saat pertama kali seseorang mengeklik tombol ini, akan ada pop-up konfirmasi.

Persyaratan

Facebook SDK untuk JavaScript

Untuk menggunakan plugin kirim ke Messenger, Anda harus menyertakan Facebook SDK untuk JavaScript di halaman tempat plugin akan di-render.

Untuk petunjuk cara menyertakan SDK, lihat Memulai Cepat Facebook SDK untuk JavaScript.

Pengaturan

<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>

Untuk deskripsi lengkap tentang atribut yang tersedia, lihat referensi plugin kirim ke Messenger.

Langganan Peristiwa

Berlangganan peristiwa plugin.

<script>

      FB.Event.subscribe('send_to_messenger', function(e) {
      // callback for events triggered by the plugin

      });

      </script>

Kolom Peristiwa

Nama Kolom Jenis Deskripsi

event

Enum

Nama peristiwa. Nilai yang mungkin: rendered, clicked, not_you, opt_in.

ref

String

Berisi set nilai parameter data-ref pada plugin. Hanya karakter alfanumerik serta -, _, dan = yang didukung.

is_after_optin

Boolean

Menunjukkan apakah peristiwa terjadi setelah pop-up konfirmasi dikonfirmasi.

pluginID

undefined

Kolom ini tidak digunakan.

Peristiwa Webhooks

Plugin kirim ke Messenger memicu peristiwa Webhooks messaging_optins.

Menyesuaikan Perilaku Login

Jika tidak ada pengguna Facebook yang login, plugin akan ditampilkan tanpa identitas pengguna. Mengeklik tombol akan meminta pengguna untuk login.

Jika Anda mengatur allow_login ke false, plugin tidak akan di-render untuk pengguna yang tidak login.

Perhatikan bahwa plugin akan di-render tanpa sesi Facebook hanya jika aplikasi disetujui dan terbuka untuk publik.

Opsi teks CTA

Plugin Kirim ke Messenger juga mendukung atribut cta_text. Hal ini memungkinkan Anda untuk memilih teks tombol plugin dari daftar string yang telah ditentukan sebelumnya. Ketika atribut cta_text digunakan, sebagian besar pengguna yang masuk hanya perlu mengeklik tombol plugin itu sendiri untuk ikut serta, tanpa harus mengonfirmasi ulang dengan pop-up, dan peristiwa messaging_optins akan segera tersampaikan.

Nilai-nilai berikut didukung untuk atribut cta_text:

  • GET_THIS_IN_MESSENGER
  • RECEIVE_THIS_IN_MESSENGER
  • SEND_THIS_TO_ME
  • GET_CUSTOMER_ASSISTANCE
  • GET_CUSTOMER_SERVICE
  • GET_SUPPORT
  • LET_US_CHAT
  • SEND_ME_MESSAGES
  • ALERT_ME_IN_MESSENGER
  • SEND_ME_UPDATES
  • MESSAGE_ME
  • LET_ME_KNOW
  • KEEP_ME_UPDATED
  • TELL_ME_MORE
  • SUBSCRIBE_IN_MESSENGER
  • SUBSCRIBE_TO_UPDATES
  • GET_MESSAGES
  • SUBSCRIBE
  • GET_STARTED_IN_MESSENGER
  • LEARN_MORE_IN_MESSENGER
  • GET_STARTED