Menyesuaikan widget obrolan langsung menggunakan tag data

Anda dapat menyesuaikan widget obrolan langsung dengan menggunakan tag data dalam skrip widget. Anda dapat menggunakan tag berikut dalam skrip widget chat yang Anda salin dari aplikasi admin seperti pusat admin Copilot Service. Pelajari lebih lanjut di Sematkan widget chat di situs atau portal Anda.

Anda juga dapat menggunakan tag data di agen untuk menyajikan tombol atau opsi di jendela obrolan.

Nama atribut	Deskripsi	Example
data-hide-chat-button	Saat menerapkan widget chat, Anda dapat menambahkan tombol chat yang selaras dengan pengalaman aplikasi seluler alih-alih menggunakan tombol chat default. Dalam kasus seperti itu, gunakan tag data ini untuk menyembunyikan tombol obrolan terbuka default yang tersedia di widget obrolan langsung.	<script id="Microsoft_Omnichannel_LCWidget" src="<valid-src>" data-app-id="<valid-app-id>" data-org-id="<valid-org-id>" data-org-url="<valid-org-url>" data-hide-chat-button="true"></script>
data-hide-minimize-button	Saat menerapkan widget obrolan, Anda dapat menonaktifkan tombol minimalkan di dalam obrolan default. Gunakan tag data ini untuk menyembunyikan tombol minimalkan obrolan default yang tersedia di widget obrolan langsung.	<script id="Microsoft_Omnichannel_LCWidget" src="<valid-src>" data-app-id="<valid-app-id>" data-org-id="<valid-org-id>" data-org-url="<valid-org-url>" data-hide-minimize-button="true"></script>
data-disable-telemetry	Secara default, pengumpulan data telemetri diaktifkan untuk semua widget. Atur nilai tag data ini ke true jika Anda ingin menonaktifkan pengumpulan data telemetri. Informasi selengkapnya: Telemetri widget obrolan langsung	<script id="Microsoft_Omnichannel_LCWidget" src="<valid-src>" data-app-id="<valid-app-id>" data-org-id="<valid-org-id>" data-org-url="<valid-org-url>" data-disable-telemetry="true"></script>
data-render-mobile	Buka widget obrolan dalam mode seluler. Widget chat tidak memiliki header saat digunakan di perangkat seluler. Informasi selengkapnya: Menyesuaikan widget live chat untuk aplikasi seluler	<script id="Microsoft_Omnichannel_LCWidget" src="<valid-src>" data-app-id="<valid-app-id>" data-org-id="<valid-org-id>" data-org-url="<valid-org-url>" data-render-mobile="true" ></script>
data-font-family-override	Keluarga font default adalah Segoe UI. Gunakan tag data ini untuk mengganti keluarga font default dengan font lain yang aman dan didukung secara native. Widget tidak mendukung font khusus.	Contoh 1: Untuk mengganti font UI Segoe default dan mengatur keluarga font ke Arial: <script id="Microsoft_Omnichannel_LCWidget" src="<valid-src>" data-app-id="<valid-app-id>" data-org-id="<valid-org-id>" data-org-url="<valid-org-url>" data-font-family-override="Arial, Segoe UI"></script> Contoh 2: Untuk menambahkan keluarga font seperti Monotype Corsiva: <script id="Microsoft_Omnichannel_LCWidget" src="<valid-src>" data-app-id="<valid-app-id>" data-org-id="<valid-org-id>" data-org-url="<valid-org-url>" data-font-family-override="Monotype Corsiva"></script>
data-open-in-window	Gunakan tag data ini untuk membuka widget chat di jendela baru. Anda dapat mengatur tag ini ke true atau false (nilai default). Secara default, widget obrolan terbuka di jendela browser yang sama. Jika diatur ke true, widget obrolan terbuka di jendela browser baru saat dipilih.	<script id="Microsoft_Omnichannel_LCWidget" src="<valid-src>" data-app-id="<valid-app-id>" data-org-id="<valid-org-id>" data-org-url="<valid-org-url>" data-open-in-window="true"></script>
data-suggested-action-layout	Gunakan tag data ini untuk menampilkan tindakan yang disarankan secara vertikal. Secara default, tindakan yang disarankan ditampilkan secara horizontal. Untuk menampilkan tindakan yang disarankan secara vertikal, atur nilai tag data ini sebagai stacked.	<script id="Microsoft_Omnichannel_LCWidget" src="<valid-src>" data-app-id="<valid-app-id>" data-org-id="<valid-org-id>" data-org-url="<valid-org-url>" data-suggested-action-layout="stacked"></script>
data-enable-lcw-autofill	Gunakan tag data ini untuk mengaktifkan widget obrolan mengisi otomatis jendela browser dalam mode tertanam.	<script id="Microsoft_Omnichannel_LCWidget" src="<valid-src>" data-app-id="<valid-app-id>" data-org-id="<valid-org-id>" data-org-url="<valid-org-url>" data-enable-lcw-autofill="true"></script>
data-custom-close-button-text	Gunakan tag data ini untuk menyesuaikan tombol tutup widget obrolan. Input adalah string teks yang muncul sebagai pengganti tombol tutup default 'X'.	<script id="Microsoft_Omnichannel_LCWidget" src="<valid-src>" data-app-id="<valid-app-id>" data-org-id="<valid-org-id>" data-org-url="<valid-org-url>" data-custom-close-button-text="End Chat"></script>
data-enable-sso-magic-code	Gunakan tag data ini untuk secara otomatis mengirim kode ajaib ke pengguna setelah login, baik di chat atau secara diam-diam melalui klien. Fungsi ini mirip dengan otentikasi multifaktor dan membantu mencegah serangan phishing. Anda dapat mengatur tag ini ke true (nilai default) atau false. Jika diatur ke false, kode secara otomatis dikirim melalui klien secara diam-diam, setelah masuk. Jika disetel ke true, kode ajaib ditampilkan kepada pengguna untuk masuk ke obrolan secara manual, setelah masuk. Lihat bagian Pengaturan tambahan untuk browser di artikel ini untuk informasi selengkapnya.	Dalam contoh ini, kode ajaib secara otomatis diteruskan melalui klien setelah masuk, tanpa memerlukan input pengguna. <script id="Microsoft_Omnichannel_LCWidget" src="<valid-src>" data-app-id="<valid-app-id>" data-org-id="<valid-org-id>" data-org-url="<valid-org-url>" data-enable-sso-magic-code="false"></script>

Pengaturan tambahan untuk browser

Lakukan langkah-langkah khusus browser yang diuraikan di sini untuk meneruskan kode ajaib secara otomatis.

Browser berbasis Chromium

1. Di Microsoft Edge, masukkan "edge://flags/#third-party-storage-partitioning" di bilah alamat. Di Google Chrome, masukkan "chrome://flags/#third-party-storage-partitioning" di bilah alamat.
2. Pada halaman yang muncul, atur bendera Partisi Penyimpanan Pihak Ketiga ke Dinonaktifkan.

Firefox

1. Di Firefox, masukkan "about:preferences#privacy" di bilah alamat.
2. Pada halaman yang muncul, pilih Kustom, dan untuk Cookie, pilih Cookie pelacakan lintas situs.

Safari

Pada dialog pengaturan, pilih Bendera Fitur, dan kosongkan pilihan untuk Partisi Asal BroadcastChannel.

Langkah berikutnya

Kembangkan widget obrolan langsung kustom

Informasi terkait

Mulai obrolan secara proaktif
Telemetri widget obrolan langsung
Sesuaikan widget obrolan langsung untuk aplikasi seluler
Referensi SDK obrolan langsung