/dashboard/web-widgets), ThunderPhone’ın gömülebilir ses widget’ını çalıştıran yayımlanabilir anahtarları oluşturur ve yönetir.
Bu kılavuzun API sürümünün cURL ile yaptığı her şeyi bu sayfa bir form aracılığıyla yapar; ayrıca gömme kodunu sizin için oluşturur.
Widget oluşturun
1
Yeni widget'a tıklayın ve bir mod seçin
- Ajan modu — widget, açılır listeden seçtiğiniz tek bir ajanı her zaman çalıştırır. En basit kurulum.
- Webhook modu — her widget oturumunda ThunderPhone webhook URL’nizi çağırır ve sunucunuz bu ziyaretçi için ajan yapılandırmasını döndürür (sayfa bazlı yönlendirme, oturum açmış kullanıcılar, kademeli yayınlar). Kuruluşunuzun varsayılan webhook’unu kullanmak için URL’yi boş bırakın; yeni bir URL girdiğinizde bunu kuruluş varsayılanı olarak da ayarlayabilirsiniz.
2
İzin verilen alan adlarını listeleyin
Yayımlanabilir anahtarlar kaynağa kilitlidir: en az bir alan adı gereklidir
ve widget yalnızca listelediğiniz ana bilgisayar adlarında çalışır.
*.example.com gibi alt alan adı joker karakterlerine izin verilir (bunlar çıplak alan adıyla değil, alt alan adlarıyla eşleşir); * gibi çıplak joker karakterler reddedilir.
localhost ve 127.0.0.1 her zaman izinlidir; bu nedenle yerel geliştirme için bunları listelemeniz gerekmez.3
Adlandırın, etkinleştirin, oluşturun
Widget’ı etkinleştir anahtarı, anahtarın oturum kabul edip etmeyeceğini denetler; bir widget’ı devre dışı olarak oluşturabilir ve yayına alırken etkinleştirebilirsiniz.
Gömme kodunu alın
Oluşturmanın hemen ardından (veya her satırdaki Göm düğmesiyle), bir gömme iletişim kutusu yayımlanabilir anahtarınız eklenmiş, yapıştırmaya hazır kod oluşturur:- React — paketleyici uygulamalar için bir
<ThunderPhoneWidget />parçacığı. - Script etiketi — tüm siteler için CDN
<script>+ stil sayfası çifti.
Yayımlanabilir anahtarlar (
pk_live_…) tasarım gereği herkese açıktır; ön uç koduna eklemek güvenlidir. Bir anahtarı istediğiniz zaman satırındaki kopyalama düğmesiyle kopyalayın.Widget’ları listeden yönetin
Her satır yerinde düzenlenir:- Mod / Ajan — satır içi seçimlerle ajan ve webhook modları arasında geçiş yapın veya ajanı değiştirin.
- Alan adları — izin verilen alan adlarını etiket olarak ekleyin veya kaldırın.
- Etkinleştir/devre dışı bırak — her widget için bir anahtar; devre dışı bırakılan widget’lar oturum kabul etmeyi hemen durdurur.
- Kuruluşa aktar — widget’ı üyesi olduğunuz başka bir kuruluşa kopyalayın veya taşıyın (taşıma işlemi onu buradan kaldırır).
- Sil — yayımlanabilir anahtarı iptal eder; widget tüm alan adlarında hemen çalışmayı durdurur. Bu işlem geri alınamaz.
Sonraki adımlar
Widget SDK başvurusu
React bileşeni, headless kancası ve CDN betiği ayrıntıları.
Webhook modu yönlendirmesi
Sunucunuzdan ziyaretçi başına ajan yapılandırması döndürün.