Skip to main content
Halaman Widget Web (/dashboard/web-widgets) membuat dan mengelola kunci yang dapat dipublikasikan yang mendukung widget suara ThunderPhone yang dapat disematkan. Semua yang dilakukan versi API dari panduan ini dengan cURL, dilakukan halaman ini dengan formulir — ditambah halaman ini menghasilkan kode sematan untuk Anda.

​
Buat widget

1

Klik Widget baru dan pilih mode

  • Mode agen — widget selalu menjalankan satu agen yang Anda pilih dari dropdown. Penyiapan paling sederhana.
  • Mode webhook — pada setiap sesi widget, ThunderPhone memanggil URL webhook Anda dan server Anda mengembalikan konfigurasi agen untuk pengunjung tersebut (perutean per halaman, pengguna yang sudah masuk, peluncuran bertahap). Biarkan URL kosong untuk menggunakan webhook default organisasi Anda; saat memasukkan URL baru, Anda juga dapat menjadikannya default organisasi.
2

Cantumkan domain yang diizinkan

Kunci yang dapat dipublikasikan dikunci ke origin: setidaknya satu domain diperlukan, dan widget hanya berfungsi pada nama host yang Anda cantumkan. Wildcard subdomain seperti *.example.com diizinkan (cocok dengan subdomain, bukan domain tanpa subdomain); wildcard tanpa domain seperti * ditolak. localhost dan 127.0.0.1 selalu diizinkan, sehingga pengembangan lokal berfungsi tanpa perlu mencantumkannya.
3

Beri nama, aktifkan, lalu buat

Toggle Aktifkan widget mengontrol apakah kunci menerima sesi — Anda dapat membuat widget dalam keadaan nonaktif lalu mengaktifkannya saat peluncuran.

​
Ambil kode sematan

Segera setelah pembuatan (atau melalui tombol Sematkan di setiap baris), dialog sematan menghasilkan kode siap tempel dengan kunci yang dapat dipublikasikan Anda sudah diisi:
  • React — cuplikan <ThunderPhoneWidget /> untuk aplikasi bundler.
  • Tag skrip — pasangan <script> CDN + stylesheet untuk situs apa pun.
Dialog juga mempratinjau opsi tampilan dasar — judul, warna utama, posisi sudut, dan tema terang/gelap — lalu memasukkan pilihan Anda ke dalam cuplikan. Untuk referensi prop lengkap, hook penataan gaya, dan opsi headless, lihat dokumentasi SDK widget.
Kunci yang dapat dipublikasikan (pk_live_…) bersifat publik secara desain — aman digunakan dalam kode front-end. Salin kapan saja dengan tombol salin pada barisnya.

​
Kelola widget dari daftar

Setiap baris dapat diedit langsung di tempat:
  • Mode / Agen — beralih antara mode agen dan webhook, atau ganti agen, dengan pemilih inline.
  • Domain — tambahkan atau hapus domain yang diizinkan sebagai chip.
  • Aktifkan/nonaktifkan — satu sakelar per widget; widget yang dinonaktifkan berhenti menerima sesi seketika.
  • Transfer ke organisasi — salin atau pindahkan widget ke organisasi lain yang Anda ikuti (memindahkan akan menghapusnya dari sini).
  • Hapus — mencabut kunci yang dapat dipublikasikan; widget berhenti berfungsi seketika di semua domain. Tindakan ini tidak dapat dibatalkan.
Sesi widget muncul di riwayat panggilan dengan transkrip, rekaman, dan penilaian yang sama seperti panggilan telepon.

​
Langkah berikutnya

Referensi SDK widget

Detail komponen React, hook headless, dan skrip CDN.

Perutean mode webhook

Kembalikan konfigurasi agen per pengunjung dari server Anda.