Ana içeriğe geç

Yazılı Kanal – Widget Konfigürasyonu

V
Yazar: Volkan Ersever

Genel Bakış ve Navigasyon

Bu doküman, yöneticilerin web sitelerinde kullanılan Voyce yazılı kanal widget'ını yapılandırabilmesi için hazırlanmıştır.

İlgili modüle girildiğinde üstte 4 ana sekme görünür:

  • Akış

  • Web Chat

  • Copilot

  • Bilgi Tabanı

Akış

Amaç: Sayfa yüklenir yüklenmez müşteriye ilk karşılayan mesajı göstermek ve hazır cevaplar üzerinden akış bazlı sohbet senaryoları oluşturmak.

Akış Mantığı Nasıl Çalışır?

  1. Sayfa yüklendiğinde ilk mesaj gösterilir.

  2. Kullanıcı, bu mesaj altında yer alan hazır cevaplardan birini seçer (veya izin verildiyse kendi cevabını yazar).

  3. Seçilen cevaba göre sistem, belirlenen aksiyonu uygular:

    • Sonraki mesaja geç

    • Kuyruğa yönlendir

    • AI Bot'a aktar

    • Görüşmeyi sonlandır

Yeni Proaktif Mesaj Oluşturma

  • Mesaj Metni: Örn. "Merhaba! Size nasıl yardımcı olabilirim?"

  • "Özel mesaj gönderebilir" seçeneği: İşaretliyse kullanıcı serbest metin yazabilir; boşsa yalnızca tanımlı hazır cevap butonlarını kullanabilir.

  • Hazır Cevaplar (Butonlar): Örn. "Ürünler hakkında bilgi", "Fiyatlar hakkında bilgi", "Teknik destek talep etmek istiyorum"

Hazır Cevap Aksiyonları

Aksiyon

Açıklama

Sonraki Mesaja Gönder

Daha önce oluşturulan başka bir mesaja yönlendirir

Kuyruğa Yönlendir

Kullanıcıyı seçilen çağrı kuyruğuna aktarır

AI Bot'a Gönder

Müşteriyi tanımlı AI Bot senaryosuna yönlendirir

Konuşmayı Bitir

Sohbeti sonlandırır

Örnek Akış Senaryosu

Senaryo: Satış ve Destek Ayrımı

  • İlk mesaj: "Merhaba! Size nasıl yardımcı olabilirim?"

  • Hazır cevaplar:

    • "Satış öncesi bilgi almak istiyorum" → Kuyruğa yönlendir: Satış Kuyruğu

    • "Teknik destek talep ediyorum" → Kuyruğa yönlendir: Destek Kuyruğu

    • "Sık sorulan soruları görmek istiyorum" → AI Bot'a yönlendir

Bileşenler (Web Chat)

Amaç: Web sitenizin farklı sayfaları/bölümleri için birden fazla bağımsız widget ("Bileşen") oluşturup ayrı ayrı yapılandırmak.

Web Chat sekmesine girildiğinde sol tarafta Bileşenler listesi görünür (ör. "Anasayfa", "İletişim"). Her bileşenin kendi Ön-Form, Çalışma Saatleri ve Marka & Tema ayarları vardır.

  • + Yeni Bileşen butonu ile yeni bir widget bileşeni oluşturulur.

  • Listede her bileşenin yanında bir çöp kutusu ikonu bulunur (silme).

  • Bir bileşen seçildiğinde sağ panelde şu alanlar görünür:

    • Bileşen Adı — widget'ın panel içi görünen adı (ör. "Anasayfa")

    • Widget ID — sistem tarafından otomatik üretilen benzersiz kimlik (ör. voyce_widget_anasayfa), salt okunur

    • Hızlı Test butonu — widget'ı canlı test etmek için

    • Entegrasyon Kodu butonu — web sitesine eklenecek embed kodunu almak için

Seçilen bileşenin altında üç alt sekme yer alır: Ön-Form, Çalışma Saatleri, Marka & Tema

Ön-Form

Amaç: Sohbet başlamadan önce müşteriden temel bilgileri toplamak (isim, e-posta, telefon vb.) ve KVKK/açık rıza onayını almak.

Her bileşen için Ön-Form sekmesi ayrı ayrı yapılandırılır.

Alan Yapısı

Her alan üç ana kısımdan oluşur:

  • Alan Etiketi — kullanıcının gördüğü metin (ör. "Adınız", "Mail", "Telefon")

  • Alan Adı — sistem içi değişken adı

  • Yer Tutucu (Placeholder) — alanın içindeki gri açıklama metni (ör. "Your Name", "Your E-Mail", "Your Phone Number")

Alanın yanındaki "Zorunlu" kutusu işaretlendiğinde kullanıcı bu alanı doldurmadan sohbeti başlatamaz. Alt kısımdaki "+ Ekle" butonuyla yeni alan eklenir, sağdaki çöp kutusu ikonuyla alan silinir.

Sistem Alanları: Şu anda üç alan sistem alanı olarak geliyor ve Alan Adı kilitli / değiştirilemez:

  • Adınız → contact

  • Mail → email

  • Telefon → phone

Bu üç alanın Alan Etiketi ve Yer Tutucu metinleri düzenlenebilir, ancak Alan Adı sabittir. "+ Ekle" ile oluşturulan yeni özel alanlarda Alan Adı serbestçe girilebilir.

Kişiselleştirilmiş Mesaj Kullanımı

Ön-formda toplanan alanlar, proaktif mesajlarda kişiselleştirme için kullanılabilir.

Örnek:

  • Ön-form alan adı: contact

  • Proaktif mesaj: "Merhaba {{contact}}, size nasıl yardımcı olabilirim?"

Kullanıcı formda "Volkan" yazdıysa mesaj ekranda: "Merhaba Volkan, size nasıl yardımcı olabilirim?" şeklinde görünür.

(Değişken formatı sistemdeki gerçek sözdizimine göre uyarlanmalıdır.)

KVKK Onay Kutusu

  • "KVKK onay kutusunu etkinleştir" — işaretlendiğinde formda bir onay kutusu görünür.

  • "KVKK onayı zorunlu" — işaretlenirse kullanıcı KVKK kutusunu işaretlemeden sohbet başlatamaz.

  • KVKK metni: Örn. "KVKK koşullarını kabul ediyorum."

  • KVKK Bağlantısı: Örn. /kvkk-metni

Açık Rıza Metni

KVKK bölümünün altına, ayrı bir onay bloğu olarak Açık Rıza Metni eklendi:

  • "Açık Rıza Metni Göster" — işaretlendiğinde ayrı bir açık rıza onay kutusu görünür.

  • Açık Rıza Metni: Örn. "Açık Rıza Metni"

  • Açık Rıza Metni Linki: Örn. /acik-riza-metni

  • "Zorunlu Alan" — işaretlenirse kullanıcı bu kutuyu onaylamadan sohbet başlatamaz.

Bu bölüm, KVKK aydınlatma metninden bağımsız olarak ayrı bir açık rıza beyanı (ör. pazarlama izni) almak için kullanılır.

Çalışma Saatleri

Amaç: Widget'ın hangi gün ve saatlerde "online" görüneceğini belirlemek, mesai dışı zamanlar için otomatik mesaj göstermek.

Üstte "Çalışma saatlerini etkinleştir" kutusu bulunur; işaretlenmediği sürece alt ayarlar (gün/saat, offline mesajı) görünmez/pasiftir. İşaretlendiğinde aşağıdaki alanlar açılır:

Zaman Dilimi ve Gün Seçimi

  • Önce Zaman Dilimi seçilir (örn. Europe/Istanbul).

  • Ardından her gün için:

    • Günü aktif/pasif yapan bir kutu

    • Aktif günlerde Başlangıç Saati ve Bitiş Saati (ÖÖ/ÖS formatında)

    • Satırın sağında geçerlilik durumunu gösteren yeşil bir onay işareti

Offline Modu ve Mesajı

Çalışma saatleri dışında veya kapalı günlerde gösterilecek bir Offline Mesajı belirlenir.

Örnek: "Şu anda mesai saatleri dışında bulunuyoruz. Çalışma saatlerimiz 09:00 ile 18:00 arasındadır."

Bu mesaj, kullanıcı widget'ı açtığında otomatik olarak gösterilir.

Sayfanın altında Sıfırla ve Kaydet butonları bulunur.

Marka & Tema

Amaç: Widget'ın görünümünü ve davranışını markanıza ve web sitenize uygun hale getirmek. Diğer sekmeler gibi bileşen bazlıdır (ör. "İletişim" bileşeninin Marka & Tema ayarları "Anasayfa"dan bağımsızdır).

Ekran iki ana blok halinde düzenlenmiştir: Renk Ve Tema ve Genel Ayarlar. Altlarında ayrıca Bildirim Ayarları ve Mesaj Kutusu Özellikleri kartları yer alır.

Renk Ve Tema

  • Ana Renk: Renk seçici (gradient alan + ton kaydırıcısı) üzerinden veya doğrudan HEX kodu girilerek belirlenir (ör. #3214B8). Altında sık kullanılan renklerden oluşan bir palet/swatch listesi bulunur (kırmızı, pembe, mor, indigo tonları), buradan hızlı seçim yapılabilir.

  • İkincil Renk: Ana Renk ile aynı yapıya sahiptir, ayrı bir HEX değeri girilir (ör. #2709AA).

  • Tema: Dropdown'dan Koyu veya Açık tema seçilir.

Widget'ın butonları, balonları ve vurgu alanları bu renklere göre şekillenir.

Genel Ayarlar

  • Widget Başlığı: Widget başlığında görünen metin (ör. "Voyce AI")

  • Widget Konumu: Dropdown — "Sağ Alt", "Sol Alt" vb.

  • Varsayılan Durum: Dropdown — "Kapalı" (küçük balon halinde başlar) veya "Açık" (sohbet penceresi açık gelir)

  • Boyut: Dropdown — Küçük / Orta / Büyük / Çok Büyük

  • Widget İkonu: "Yeni İkon Seç (Varolanı Değiştir)" ile logo/ikon yüklenir; "İkonu Kaldır" ile mevcut ikon silinir

  • Önizleme: Yapılan renk/tema/başlık değişikliklerinin canlı önizlendiği alan

Bildirim Ayarları

  • Sesli bildirimleri etkinleştir — yeni mesaj geldiğinde ses uyarısı çalar

  • Okunmamış rozetini göster — widget ikonunun üzerinde okunmamış mesaj sayısı rozeti gösterilir

Mesaj Kutusu Özellikleri

Sohbet mesaj kutusunda kullanıcıya hangi araçların sunulacağını belirler:

  • Emoji seçici — mesaj kutusunda emoji seçme aracı gösterilir

  • Sesli mesaj (ses ile yazma) — kullanıcının sesli mesaj/konuşarak yazma özelliğini kullanmasına izin verilir

📸 Görsel yerleşimi: Buraya (6. bölümün tamamına) en son paylaşılan Marka & Tema görseli eklenmeli — Renk Ve Tema, Genel Ayarlar, Bildirim Ayarları ve Mesaj Kutusu Özellikleri kartlarının tamamının göründüğü tam ekran görünümü.

Copilot

Amaç: Temsilcilere sohbet sırasında yapay zeka destekli cevap önerileri sunan asistanı (Copilot) yapılandırmak.

Genel Ayarlar

  • Sağ üstte Aktif anahtarı ile Copilot açılıp kapatılır.

System Prompt

Copilot'un rolünü, tonunu ve cevap yapısını tanımlayan sistem talimatı buraya yazılır. Örnek yapı:

  • Rol tanımı (ör. "profesyonel, çözüm odaklı ve empatik bir Müşteri Destek Stratejisti")

  • Tonlama kuralları

  • Yapı (Selamlama ve Empati → Çözüm/Bilgi → Eylem Çağrısı/Kapanış)

  • Düzeltme kuralı (temsilci eksik bilgi verirse Copilot'un ne yapacağı)

  • Dil (ör. "Tüm çıktıları akıcı ve kurumsal bir Türkçe ile hazırla")

  • Format (temsilcinin doğrudan kopyalayıp gönderebileceği taslak sunma kuralı)

Bilgi Tabanı Bağlantısı

  • Knowledge Base Seçin — Copilot'un RAG (Retrieval-Augmented Generation) ile cevap üretmesi için Bölüm 8'de oluşturulan bilgi tabanlarından biri seçilir.

AI Model Ayarları

Alan

Açıklama

AI Provider

Kullanılacak yapay zeka sağlayıcısı (ör. DeepSeek)

Model Adı

Sağlayıcıya ait model adı (ör. deepseek/deepseek-v4-flash)

Sıcaklık (Temperature)

0–1 arası kaydırıcı; düşük değer daha "kesin"/tutarlı, yüksek değer daha yaratıcı cevaplar üretir

Max Tokens

Maksimum cevap uzunluğu

Top K (RAG Sonuç)

Bilgi tabanından çekilecek sonuç sayısı

Değişiklikler Kaydet butonuyla uygulanır.

Bilgi Tabanı

Amaç: Copilot'un (ve varsa AI Bot akışlarının) RAG ile cevap üretmesi için kullanılacak bilgi tabanlarını (knowledge base / index) oluşturmak ve yönetmek.

Bilgi Tabanı Listesi

Ana ekranda mevcut tüm bilgi tabanları kart görünümünde listelenir. Her kartta:

  • Görünen Ad ve Index Adı (ör. "voyce_teknikdestek")

  • İçerik özeti rozetleri: Dosya sayısı, Website sayısı, Metin sayısı, Chunk sayısı

  • Kullanılan AI Provider / Embedding Modeli (ör. voyce_ai_provider_cagri_analizi_ai / text-embedding-3-small)

  • Son güncelleme tarihi

  • Silme ikonu

Üstte bir arama kutusu ile bilgi tabanları filtrelenebilir; sağ üstte "+ Ekle" butonu ile yeni bilgi tabanı oluşturulur.

Yeni Bilgi Tabanı Oluşturma

"+ Ekle" butonuna tıklandığında açılan modalda:

Temel Bilgiler

  • Görünen Ad (ör. "Müşteri Bilgileri")

  • Index Adı — Redis'te kullanılacak benzersiz index adı (ör. "musteri_bilgileri")

  • Açıklama (opsiyonel)

Embedding Ayarları

  • AI Provider (dropdown)

  • Model Adı (ör. "text-embedding-3-small")

  • Chunk Boyutu — karakter sayısı (varsayılan 512)

  • Chunk Overlap — örtüşen karakter sayısı (varsayılan 50)

Kaynaklar

  • Dosyalar — "Dosya Seç" ile birden fazla dosya yüklenebilir (PDF, TXT, DOCX, DOC, CSV — dosya başına maks. 20MB)

  • Website URL'leri — "+ URL Ekle" ile web sayfası linkleri eklenir

  • Metin İçerikleri — "+ Metin Ekle" ile doğrudan metin girilir

Modal altında İptal / Oluştur butonları bulunur.

En İyi Uygulamalar ve Tavsiyeler

  • Proaktif mesajı kısa ve net tutun. Tek cümlede ne sunduğunuzu anlatın, en fazla 2–3 hazır cevapla başlayın.

  • Ön-formda gerçekten ihtiyaç duyduğunuz alanları sorun; çok fazla alan kullanıcıyı formu kapatmaya yöneltebilir.

  • KVKK ve Açık Rıza metinlerini güncel tutun ve yasal ekibinizle uyumlu şekilde kullanın; ikisini birbirine karıştırmayın (KVKK aydınlatma, Açık Rıza ayrı bir izin beyanıdır).

  • Renkleri web sitenize uyumlu seçin; kontrastı düşük yapan kombinlerden kaçının.

  • Copilot System Prompt'unu yazarken cevap yapısını (selamlama → çözüm → kapanış) net tanımlayın; belirsiz talimatlar tutarsız cevaplara yol açar.

  • Copilot'a bağlanan Bilgi Tabanı'nı güncel tutun; eski/yanlış içerik RAG cevaplarının kalitesini doğrudan etkiler.

  • Birden fazla Bileşen (widget) kullanıyorsanız, her birinin Widget ID'sini doğru sayfaya entegre ettiğinizden emin olun.

  • Her değişiklikten sonra Hızlı Test ile bir kullanıcı gibi baştan sona senaryoyu deneyerek eksik veya yanlış yönlendirme olup olmadığını kontrol edin.

İlgili Makaleler
Bu cevap sorunuzu yanıtladı mı?