Sesli aramalar, metin sohbeti veya her ikisini destekleyen özelleştirilebilir bir widget ile AI asistanınızı herhangi bir web sitesine ekleyin.
Genel Bakış
Web Widget, web sitesi ziyaretçilerinin AI asistanınızla doğrudan etkileşim kurmasını sağlar:
- Sesli konuşmalar: Tarayıcıda gerçek zamanlı sesli aramalar
- Metin sohbeti: Metin tabanlı etkileşimler için mesajlaşma arayüzü
- Hibrit mod: Ses ve sohbet arasında sorunsuz geçiş
- Asistanınızın düzenleme sayfasına gidin
- “Web widget” düğmesine (sarı/uyarı rengi) tıklayın
- Canlı önizlemeli widget yapılandırma paneli açılır
Web Widget premium bir özelliktir. Yapılandırmadan önce planınızın web widget erişimini içerdiğinden emin olun.
Ziyaretçilerin asistanınızla nasıl etkileşim kuracağını seçin:
Ses ve Sohbet (Önerilen)
Kullanıcılar konuşmalar sırasında ses ve metin arasında sorunsuz geçiş yapabilir.
Şunlar için en uygun:
- Kullanıcılar için maksimum esneklik
- Erişilebilirlik (mobilde ses, sessiz ortamlarda sohbet)
- Her iki modu gerektiren karmaşık etkileşimler
Yalnızca Sohbet
Yalnızca metin tabanlı mesajlaşma arayüzü.
Şunlar için en uygun:
- Müşteri desteği ve SSS
- Sesin uygun olmadığı ortamlar
- Müşteri yakalama ve değerlendirme formları
Yalnızca Ses
Yalnızca gerçek zamanlı sesli konuşmalar.
Şunlar için en uygun:
- Web sitesinde telefon benzeri deneyim
- Ses öncelikli kullanım alanları
- Eller serbest etkileşimler
Yapılandırma Seçenekleri
Genel Sekmesi
Widget Modu: Ses, Sohbet veya Ses ve Sohbet
Widget Boyutu: Standart veya ekstra büyük düzen arasından seçin
- Standart: Çoğu kullanım alanına uygun kompakt yüzen widget
- Ekstra Büyük: Masaüstünde yarım ekran panel, mobilde tam ekran — ayrıntılı konuşmalar için ideal
Konum: 8 konumdan birini seçin (sağ-alt, sol-alt, orta-alt, sağ-orta, sol-orta, sağ-üst, sol-üst, orta-üst)
Ana Renk: Düğmeler ve vurgular için marka rengi
Açma/Kapama Düğmesi Boyutu: Küçük veya Normal
Açma/Kapama Düğmesi Stili: Animasyonlu (cam morfizm) veya Basit (düz tasarım)
Sayfa Yüklendiğinde Otomatik Aç: Etkinleştirildiğinde, widget sayfa yüklendiğinde otomatik olarak genişler — ziyaretçinin tıklamasına gerek yoktur.
Düğme Sekmesi
Özel Avatar: Varsayılan widget simgesini değiştirmek için kendi avatar resminizi yükleyin. Açma/kapama düğmesinde ve sohbet başlığında görünür. Maksimum dosya boyutu: 512KB, 1:1 en-boy oranı (kare).
Düğme Ana Metni (varsayılan: “Need help?”) — widget düğmesindeki birincil metin
Düğme Alt Metni (varsayılan: “Chat with us”) — ikincil metin, küçük düğme boyutu kullanıldığında gizlenir
Sekme Etiketleri (yalnızca Ses ve Sohbet modu):
- Ses Sekmesi Etiketi (varsayılan: “Voice”) — marka dilinize uyacak şekilde yeniden adlandırın (örn. “Bizi Arayın”, “Konuşun”)
- Sohbet Sekmesi Etiketi (varsayılan: “Chat”) — marka dilinize uyacak şekilde yeniden adlandırın (örn. “Mesaj”, “Yazın”)
Başlık ve Modal Sekmesi
Başlık (varsayılan: “AI Assistant”)
Alt Başlık (varsayılan: “Ready to help you ✨”)
Modal Başlığı (varsayılan: “Ready to chat?”)
Başlat Düğmesi Metni (varsayılan: “Start Voice Chat”)
Modal Açıklaması (varsayılan: “Click below to start your conversation”)
Sohbet Ayarları Sekmesi
Bu sekme yalnızca widget modu sohbet içerdiğinde görünür (Yalnızca Sohbet veya Ses ve Sohbet).
Sohbet Yer Tutucusu (varsayılan: “Type your message…”)
Gönder Düğmesi Etiketi (varsayılan: “Send message”) — gönder düğmesi için erişilebilirlik etiketi
Fonksiyon Çağrılarını Göster: Devre dışı bırakıldığında (varsayılan), LLM araç çağrıları (örn. takvim aramaları, bilgi bankası sorguları) sohbette gizlenir ve son kullanıcılar için konuşma temiz tutulur. Araç kullanım ayrıntılarını göstermek için etkinleştirin.
Sohbette Tıklanabilir Bağlantılar
Sohbet widget’ı markdown biçimlendirmesini destekler, böylece AI asistanınız tıklanabilir bağlantılar, kalın metin, listeler ve daha fazlasını gönderebilir.
Sohbet mesajlarına tıklanabilir URL’ler eklemek için asistanınızın talimatında veya ilk mesajında markdown bağlantı biçimini kullanın:
En son [tekliflerimize](https://example.com/offers) göz atın veya [yardım merkezimizi](https://example.com/help) ziyaret edin.
Asistanınızın talimatına şu şekilde bir yönerge ekleyin: “Bağlantı veya URL paylaşırken, bunları her zaman tıklanabilir markdown bağlantıları olarak biçimlendirin: bağlantı metni” — bu, AI’ın düz metin URL’ler yerine tutarlı olarak tıklanabilir bağlantılar üretmesini sağlar.
Ses Ayarları Sekmesi
Bu sekme yalnızca widget modu ses içerdiğinde görünür (Yalnızca Ses veya Ses ve Sohbet).
Bağlanıyor Metni (varsayılan: “Connecting…”)
Bağlantıyı Kes Metni (varsayılan: “Disconnect”)
Hata Metni (varsayılan: “Connection failed. Please try again.”)
Konuşmalara başlamadan önce bilgi toplayın:
Form Yapılandırması:
- Ön Form Başlığı (varsayılan: “Before we start…”)
- Ön Form Açıklaması (varsayılan: “Please provide some information to help us assist you better”)
- Gönder Düğmesi Metni (varsayılan: “Continue”)
Form Alanları:
Veri toplamak için özel alanlar ekleyin:
- Değişken Adı: Dahili değişken adı (asistan değişkenlerine eşlenir). Yalnızca harfler, sayılar, tireler ve alt çizgiler kullanılabilir.
- Alan Etiketi: Kullanıcılara gösterilen görüntüleme etiketi
- Alan Türü: Metin, E-posta, Telefon veya Metin Alanı
- Zorunlu: Alanı zorunlu yapın
- Yer Tutucu: Alanda gösterilen yer tutucu metin
- Yardımcı Metin: Alanın altında isteğe bağlı açıklama
Değişken Eşleme:
Form alan adları otomatik olarak asistanınızın değişkenlerine eşlenir ve toplanan verilerin konuşmalar sırasında kullanılabilir olmasını sağlar.
Örnek Form Alanları:
Ad: Tam Ad (zorunlu, metin)
E-posta: E-posta Adresi (zorunlu, e-posta)
Şirket: Şirket Adı (isteğe bağlı, metin)
Mesaj: Size nasıl yardımcı olabiliriz? (isteğe bağlı, metin alanı)
AI Yanıt Ayarları
AI Etkin: Açık konuma getirildiğinde (varsayılan), AI asistanı gelen mesajlara otomatik olarak yanıt verir. Widget’ı yalnızca manuel konuşmalar için kullanmak istiyorsanız kapatın — mesajlar toplanır ancak AI yanıt vermez.
Konuşma Webhook
Webhook URL: Widget üzerinden yeni bir konuşma başladığında webhook bildirimi almak için bir URL girin. Bunu otomasyon akışlarını tetiklemek, olayları CRM’inize kaydetmek veya ekibinizi gerçek zamanlı bilgilendirmek için kullanın.
Widget’ı Etkinleştir: Widget’ın web sitenizde yüklenip yüklenmeyeceğini kontrol eden ana anahtar. Devre dışı bırakıldığında, yerleştirme kodu sitenize yüklenmiş olsa bile widget görünmez. Web sitenizden kod kaldırmadan widget’ı geçici olarak gizlemek için bunu kullanın.
Yapılandırma panelinin üst kısmında, canlı bir önizleme widget’ınızın bir web sitesinde tam olarak nasıl görüneceğini ve davranacağını gösterir. Önizleme, herhangi bir ayarı değiştirdiğinizde gerçek zamanlı olarak güncellenir.
Önizleme URL’sini Kopyala — önizleme URL’sini panonuza kopyalar, böylece ayrı bir tarayıcı sekmesinde açabilir veya inceleme için ekibinizle paylaşabilirsiniz.
Verileri Sıfırla — önizlemedeki tüm saklanan konuşma geçmişini, form gönderimlerini ve tercihleri temizler. Test ettikten sonra ilk kez ziyaretçi deneyimini simüle etmek için bunu kullanın.
Önizleme tamamen etkileşimlidir — widget düğmesine tıklayabilir, sohbet öncesi formu doldurabilir ve dağıtmadan önce yapılandırmanızı test etmek için gerçek bir konuşma başlatabilirsiniz.
Yerleştirme Kodu
Yerleştirme kodu bölümü, kopyalamaya hazır bir script etiketi sağlar. Panonuza kopyalamak için Kopyala düğmesine tıklayın, ardından web sitenizde kapanış </body> etiketinden önce yapıştırın:
<script src="https://app.whattalk.ai/embed.js"
data-assistant-id="your-assistant-id">
</script>
Yerleştirme kodunu kopyalamadan önce widget ayarlarınızı kaydedin. Script tüm yapılandırmayı sunucudan yükler, bu nedenle kaydedilmemiş değişiklikler web sitenizde görünmez.
Kurulum
- Widget ayarlarınızı yapılandırın ve kaydedin
- Yerleştirme Kodu bölümünden yerleştirme kodunu kopyalayın
- Script etiketini web sitenizde kapanış
</body> etiketinden önce yapıştırın
- Web sitenizi ziyaret edin ve widget’ın yapılandırılan konumda göründüğünü doğrulayın
- Ses/sohbet işlevselliğini ve sohbet öncesi formu (yapılandırıldıysa) test edin
İlk Ziyaret
- Widget düğmesi yapılandırılan konumda görünür
- Tıklama modal/sohbet arayüzünü açar
- Sohbet öncesi form görüntülenir (yapılandırıldıysa)
- Form gönderildikten sonra konuşma başlar
Tekrar Ziyaretler
- Önceki konuşma durumu geri yüklenebilir
- Form verileri hatırlanır (ziyaretçi çerezleri temizlemediyse)
- Destek deneyiminin sorunsuz devamı
Konuşma Takibi
Tüm widget konuşmaları inceleme ve analiz için Konuşmalar sayfanızda görünür.
Ses işlevselliği için HTTPS (SSL sertifikası) gereklidir. HTTP siteler, tarayıcı güvenlik kısıtlamaları nedeniyle yalnızca sohbet modunu kullanabilir.
Sorun Giderme
Kurulum ve yapılandırma sorunları için Web Widget Sorun Giderme sayfasına bakın.
Sonraki Adımlar
- Canlı önizlemeyi kullanarak widget’ı test edin
- Yerleştirme kodunu web sitenize ekleyin
- Konuşmalar sayfasında konuşmaları izleyin