Plugin Obrolan

Dokumen ini menunjukkan kepada Anda cara menambahkan Plugin Obrolan secara terprogram ke pengalaman Messenger Anda di situs web.

Jika Anda ingin menggunakan Meta Business Suite untuk menambahkan Plugin Obrolan ke halaman web Anda (direkomendasikan), kunjungi Pusat Bantuan Bisnis Meta untuk informasi selengkapnya.

Cara Kerjanya

Saat Anda menginstal Facebook SDK untuk JavaScript di halaman web Anda, Plugin Obrolan akan ditampilkan di halaman web. Secara default, dialog salam akan ditampilkan di desktop dan perangkat seluler. Seseorang juga dapat mengeklik tombol tutup untuk meminimalkan dialog. Anda dapat menyesuaikan salam, tampilan, seperti warna, dan pengalaman berkirim pesan, seperti menu dan balasan cepat, dari plugin. Status dialog di-cache, dimaksimalkan atau diminimalkan, dan berlanjut dari sesi ke sesi.

Login

Jika orang tersebut login ke Facebook, plugin akan menampilkan tombol "Lanjutkan sebagai [NAME]" dan "Lanjutkan sebagai Tamu". Jika orang tersebut tidak login ke Facebook, plugin akan menampilkan tombol "Masuk ke Messenger" dan "Lanjutkan sebagai Tamu".

Notifikasi Webhook

Ketika seseorang mengeklik plugin untuk memulai atau melanjutkan obrolan dengan bisnis Anda, notifikasi Webhooks akan dikirim ke server Anda yang berisi:

• Informasi tentang orang tersebut, seperti ID lingkup Halaman (PSID) atau ID referensi Pengguna
• Identifikasikan sumber pesan sebagai Plugin Obrolan
• Informasi rujukan yang disertakan dalam notifikasi

Jika Anda telah menerapkan Layar Selamat Datang di plugin dan orang tersebut mengeklik tombol Mulai untuk memulai percakapan dengan bisnis Anda, notifikasi Webhooks messaging_postbacks akan dikirim ke server Anda. Bisnis Anda kemudian dapat menggunakan ID referensi pengguna untuk mengirim pesan kepada orang tersebut dalam periode berkirim pesan standar 24 jam.

Percakapan yang Ada

Jika orang tersebut memiliki percakapan yang sudah ada dengan bisnis Anda, riwayat obrolan akan dimuat secara otomatis di plugin. Ketika orang tersebut melanjutkan percakapan, baik mengirim pesan, mengeklik tombol, atau mengambil tindakan lain yang telah Anda terapkan dalam percakapan, notifikasi Webhooks messaging akan dikirim ke server Anda atau notifikasi Webhooks messaging_referral jika Anda ingin menyertakan informasi rujukan. Bisnis Anda kemudian dapat menggunakan PSID untuk mengirim pesan kepada orang tersebut dalam periode berkirim pesan standar 24 jam.

Jenis Pesan yang Didukung oleh Plugin Obrolan

Plugin tidak mendukung:

Sebelum Memulai

Anda memerlukan:

• Izin pages_messaging
• Token akses Halaman yang diminta dari orang yang dapat melakukan tugas MODERATE di Halaman Facebook
• Aplikasi yang tertaut ke Halaman Facebook Anda berlangganan kolom Webhooks messaging, messaging_postbacks, dan messaging_referrals
• Domain untuk situs web Anda ditambahkan ke daftar diizinkan menggunakan API Profil Messenger atau Meta Business Suite

Ketentuan Fitur Meta Business berlaku sehubungan dengan penggunaan Anda atas Plugin Obrolan.

Batasan

• Situs web Anda harus aktif atau masuk daftar diizinkan sebelum Plugin Obrolan dapat berhasil diterapkan
• Jika Halaman Anda bisnis Anda memiliki pembatasan usia atau negara yang diatur di pengaturan Halaman, Plugin Obrolan tidak akan di-render kepada pengguna yang tidak login ke akun Facebook mereka saat mengunjungi situs web Anda.
• Dialog salam tidak di-cache untuk browser Safari 12+ dan Firefox

Menambahkan Plugin Obrolan

Langkah 1. Tambahkan SDK

Tambahkan Facebook SDK untuk JavaScript ke setiap halaman situs web Anda tempat Anda ingin me-render plugin.

<!-- Messenger Chat Plugin Code --> <div id="fb-root"></div> <div id="fb-customer-chat" class="fb-customerchat"></div> <script> var chatbox = document.getElementById('fb-customer-chat'); chatbox.setAttribute("page_id", "PAGE-ID"); chatbox.setAttribute("attribution", "biz_inbox"); </script> <script> window.fbAsyncInit = function() { FB.init({ xfbml : true, version : 'API-VERSION' }); }; (function(d, s, id) { var js, fjs = d.getElementsByTagName(s)[0]; if (d.getElementById(id)) return; js = d.createElement(s); js.id = id; js.src = 'https://connect.facebook.net/en_US/sdk/xfbml.customerchat.js'; fjs.parentNode.insertBefore(js, fjs); }(document, 'script', 'facebook-jssdk')); </script> 

Langkah 2. Sesuaikan Plugin

Menggunakan API

Kirim permintaan POST ke endpoint /PAGE-ID/chat_plugin untuk menyesuaikan salam, warna, ikon, dan lainnya, untuk plugin Anda.

Contoh Permintaan

curl -i -X POST "https://graph.facebook.com/v21.0/PAGE-ID/chat_plugin
    ?welcome_screen_greeting:YOUR-WELCOME-TEXT
    &theme_color:553399
    &entry_point_icon:MESSENGER-ICON
    &entry_point_label:CHAT
    &access_token=PAGE-ACCESS-TOKEN"

Kunjungi Referensi Plugin Obrolan untuk informasi selengkapnya tentang kolom yang digunakan untuk menyesuaikan plugin Anda.

Gunakan atribut HTML

Kami merekomendasikan Anda hanya menggunakan metode ini untuk penyesuaian yang tidak tersedia melalui fitur pengaturan Halaman atau API.

Notifikasi Webhooks

Ketika seseorang mengirim pesan ke bisnis Anda, notifikasi Webhooks akan dikirim ke server Anda.

Percakapan yang Ada

Notifikasi Webhooks messaging dikirim ketika seseorang mengirim pesan ke percakapan yang sudah ada dengan bisnis Anda. Notifikasi akan menyertakan ID lingkup Halaman seseorang dan parameter source objek tags diatur ke customer_chat_plugin.

Notifikasi Berkirim Pesan

{
    "object": "page",
    "entry": [
        {
            "id": "PAGE-ID",
            "time": 1559598624359,
            "messaging": [
                {
                    "sender": {
                        "id": "PSID"
                    },
                    "recipient": {
                        "id": "PAGE-ID"
                    },
                    "timestamp": 1559598623749,
                    "message": {
                        "tags": {
                            "source": "customer_chat_plugin"
                        },
                        "mid": "nhEqs_THGoYyAhpK93uNCrIfLZD...",
                        "text": "hello, from customer chat!"
                    }
                }
            ]
        }
    ]
}

Notifikasi Rujukan Berkirim Pesan

Jika Anda mengatur atribut ref untuk Plugin Obrolan Anda, notifikasi Webhooks messaging_referrals akan dikirim ke server Anda.

{
    "object": "page",
    "entry": [
        {
            "id": "PAGE-ID",
            "time": 1559598385735,
            "messaging": [
                {
                    "recipient": {
                        "id": "PAGE-ID"
                    },
                    "timestamp": 1559598385735,
                    "sender": {
                        "user_ref":"USER-REFERENCE-ID"
                    },
                    "referral": {
                        "ref": "REF-PARAMETER-INFORMATION",
                        "source": "CUSTOMER_CHAT_PLUGIN",
                        "type": "OPEN_THREAD",
                        "referer_uri": "REFERRAL-URI"
                    }
                }
            ]
        }
    ]
}

Percakapan Baru

Notifikasi Webhooks messaging_postbacks dikirim ketika seseorang memulai percakapan dengan mengeklik tombol Mulai di Layar Selamat Datang di plugin.

Notifikasi Postback Berkirim Pesan

{
    "object": "page",
    "entry": [
        {
            "id": "PAGE-ID",
            "time": 1559598624359,
            "messaging": [
                {
                    "sender": {
                        "user_ref": "USER-REFERENCE-ID"
                    },
                    "recipient": {
                        "id": "PAGE-ID"
                    },
                    "timestamp": 1559598623749,
                    "postback":{
                        "title": "TITLE-FOR-THE-CTA",  
                        "payload": "PAYLOAD-DEFINED-BY-CTA",
                        "referral": {
                            "ref": "ADDITIONAL-INFORMATION",
                            "source": "CUSTOMER_CHAT_PLUGIN",
                            "type": "OPEN_THREAD",
                    }
                }
            ]
        }
    ]
}

Permintaan Ikut Serta Pesan Marketing

Kunjungi Panduan Pesan Marketing kami untuk cara membuat permintaan ikut serta pesan marketing.

Batasan

Hanya topik Pembaruan & Promosi yang didukung untuk Pesan Marketing untuk Plugin Obrolan.

Notifikasi Ikut Serta Berkirim Pesan

Notifikasi Webhooks messaging_optins akan dikirim ke server Anda ketika seseorang memilih ikut serta untuk menerima Pesan Marketing dari bisnis Anda.

"object": "page",
    "entry": [
        {
            "id": "PAGE-ID",
            "time": TIMESTAMP,
            "messaging": [
                {
                    "recipient": {
                        "id": "PAGE-ID"
                    },
                    "timestamp": TIMESTAMP,
                    "optin": {
                        "type": "notification_messages",
                        "payload": "empty_payload",
                        "notification_messages_token": "NOTIFICATION-MESSAGE-TOKEN",
                        "notification_messages_frequency": "MESSAGE-FREQUENCY",
                        "topic": "NOTIFICATION-MESSAGE-TOPIC",
                        "token_expiry_timestamp": EXPIRATION-DATE-TIMESTAMP,
                        "ref": "ADDITIONAL-INFORMATION",
                        "user_token_status": "NOT_REFRESHED",
                        "notification_messages_status": "RESUME_NOTIFICATIONS"
                    }
                }
            ]
        }
    ]
}

Anda dapat mengatur nilai notification_messages_token ke nilai ID dalam objek recipient untuk mengirim Pesan Marketing kepada seseorang.

Kiat Pemecahan Masalah

• Menolak menampilkan...

  • Pastikan domain Anda telah dimasukkan daftar putih
  • Pastikan headerReferrer-Policy diatur sehingga URL perujuk terkirim

• Plugin Obrolan tidak me-render di Firefox

  • Hapus Add-On Kontainer Facebook di Firefox.
  • Nonaktifkan pemblokiran konten (klik perisai abu-abu pada bilah pencarian) untuk membuat plugin di-render.

Langkah Berikutnya

• Mengirim balasan
• Mengirim Pesan Marketing

Lihat Juga

• Menonaktifkan Menu Persisten
• Facebook SDK untuk JavaScript
• Mode Tamu - Memungkinkan pengguna memulai percakapan tanpa login ke Facebook.
• Pencair Suasana - Memungkinkan pengguna memulai percakapan dengan bisnis dengan daftar pertanyaan umum.
• Menu Persisten - Membantu orang lain lebih mudah menemukan dan mengakses fungsi selama percakapan.