Gerçek sem.chat kontrol paneli akışından oluşturulmuş, ekran görüntüsü destekli bir SEMJAT kılavuzu. Her kılavuz size neye tıklamanız gerektiğini, tıklamanın ardından ne olması gerektiğini, nasıl test edeceğinizi, sorunu nasıl gidereceğinizi ve bundan sonra ne yapacağınızı anlatır.
Eşleşen kılavuz bulunamadı. Widget, API, ses, faturalandırma, web kancası, WordPress, SendPulse veya planlama gibi daha kısa bir anahtar kelimeyi deneyin.
Ekran görüntüsü notu: bu kılavuzdaki her görsel, demo çalışma alanı kullanılarak gerçek sem.chat uygulamasından yakalandı. Hassas hesap ayrıntıları, müşteri verileri, API anahtarları, ödeme bilgileri ve özel konuşma içerikleri yayımlanmadan önce maskelenir.
01
Başlarken
Hesabı oluşturun, katılımı tamamlayın, kontrol panelini anlayın, ilk botu oluşturun, özel olarak test edin, kurun ve doğru planı seçin.
/yetkilendirmeKayıt olma, deneme ve ilk bot
1Herkese açık site veya uygulamadan Kaydol veya Oturum Aç ile başlayın.
2Bildirimlere veya faturalandırma mesajlarına güvenmeden önce e-posta adresini doğrulayın.
3Kontrol panelini açmadan önce ilk botu oluşturmak için katılım özelliğini kullanın.
/genel bakışGiriş yaptıktan sonra genel bakış
1Bot oluşturmak, botları görüntülemek, analitiği açmak veya faturalamayı yönetmek için hızlı işlemleri kullanın.
2Değişiklik yapmadan önce etkin botları, conversations, sesli dakikaları ve memnuniyeti inceleyin.
3Her kurulum testinden sonra son etkinliği kontrol edin.
İlk lansman
Kaydolun, denemeyi başlatın ve kontrol panelini anlayın
Bu ne için: Yepyeni bir çalışma alanı için veya sem.chat kullanmamış bir ekip arkadaşını işe alırken bu iş akışını kullanın.
Başlamadan önce
Doğrulama ve faturalandırma e-postalarını alabilecek bir iş e-postası kullanın.
Ekibin geri kalanını davet etmeden önce çalışma alanının kime ait olacağına karar verin.
Widget kurulumu için güvenli bir test web sitesini veya hazırlama sayfasını hazır bulundurun.
1
Uygulama kayıt sayfasını açın
Web sitesinde Oturum Aç / Kaydol düğmesinden app.sem.chat/auth adresine gidin.
Beklenen sonuç: Kimlik doğrulama sayfası oturum açma ve hesap oluşturma seçeneklerini gösterir.
2
Hesabı oluştur
İş e-postasını girin, şifreyi oluşturun ve kayıt formunu gönderin.
Beklenen sonuç: Uygulama, hesap kabul edildikten sonra doğrulama ister veya katılıma geçer.
3
E-postayı doğrulayın
Doğrulama e-postasını açın ve onay bağlantısını tıklayın.
Beklenen sonuç: Hesap faturalandırma, davet, rapor ve uyarı mesajları alabilir.
4
İlk katılım işlemini tamamlayın
İşletme adını girin, asistan hedefini tanımlayın, bir başlangıç rengi seçin ve ilk botu oluşturun.
Beklenen sonuç: Çalışma alanı bir bot taslağı ve etkin deneme durumuyla açılır.
5
Genel Bakışı Aç
Sol kenar çubuğunda Genel Bakış'ı tıklayın.
Beklenen sonuç: Kontrol panelinde usage kartlar, hızlı işlemler ve son etkinlikler gösterilir.
6
Sonraki eylemi seç
Kurulum için Yeni Bot Oluştur'u, yönetim için Tüm Botları Görüntüle'yi, performans için Analytics'i veya plan sınırları için Faturalandırma'yı kullanın.
Beklenen sonuç: Çalışma alanının durumuna göre nereye devam edeceğinizi biliyorsunuz.
Nasıl test edilir: Bir özel test botu oluşturun ve ekip arkadaşlarınızı davet etmeden önce bir test mesajı gönderin. Testten sonra Genel Bakış etkinliği değişikliklerini onaylayın.
Sorun
Düzeltme
Doğrulama e-postası gelmiyor
Spam'ı kontrol edin, e-postanın yazımını onaylayın ve ardından başka bir doğrulama e-postası isteyin.
Faturalandırma'da kontrol paneli açılır
Çalışma alanının aktif bir denemeye veya plana ihtiyacı olabilir. Denemeyi başlatın veya kurulumdan önce doğru planı seçin.
Bir ekip arkadaşı çalışma alanına erişemiyor
Sahip giriş bilgilerini paylaşmak yerine onları Ayarlar, Ekip'ten davet edin.
Bundan sonra ne yapılmalı: İlk botu oluşturun, özel olarak test edin ve ardından widget'ı bir hazırlama sayfasına yükleyin.
Özel başlatma testi
Yayına geçmeden önce ilk özel bot testini oluşturun
Bu ne için: Müşteriler asistanı görmeden önce hesap, bot, widget ve geçmiş takibini doğrulamak için bunu kullanın.
Başlamadan önce
Bir örnek müşteri sorusunu hazır bulundurun.
Bir hazırlık sayfasını veya yerel HTML test sayfasını hazır bulundurun.
İlk testte gerçek müşteri verilerini kullanmayın.
1
My Bots'ı aç
Kenar çubuğunda My Bots öğesini tıklayın veya Genel Bakıştan Tüm Botları Görüntüle seçeneğini kullanın.
Beklenen sonuç: Yeni Bot düğmesiyle, katılım sırasında oluşturulan botu veya boş durumunu görebilirsiniz.
2
Bot oluşturucuyu açın
Mevcut botta Yeni Bot'a veya Düzenle'ye tıklayın.
Beklenen sonuç: Bot Builder Temel Bilgiler, Widget, Bilgi, Ses ve entegrasyon kontrolleriyle açılır.
3
Botu bir kez kaydedin
Gerekli bot adını ve ilk mesajı girin, ardından Kaydet'e tıklayın.
Beklenen sonuç: Bot geçerli bir kimlik alır ve yerleştirme kodu oluşturabilir.
4
Özel olarak önizleyin
Önizleme panelini kullanın ve örnek sorunuzu sorun.
Beklenen sonuç: Cevap talimatlarınızla eşleşmeli veya hangi bilgilerin eksik olduğunu ortaya çıkarmalıdır.
5
Aşamaya yükleme
Embed'i açın, HTML pasajını kopyalayın ve hazırlama sayfasındaki kapanış gövde etiketinin öncesine yapıştırın.
Beklenen sonuç: Widget, masaüstü ve mobil cihazlarda yapılandırılmış köşede görünür.
6
Takibi onayla
Test görüşmesinden sonra Gelen Kutusu'nu veya Chat History'ı açın.
Beklenen sonuç: Test görüşmesi doğru bot, kanal ve mesaj geçmişiyle görüntülenir.
Nasıl test edilir: Ses etkinse bir kısa mesaj ve bir ses testi gönderin. Her ikisinin de Chat History'da göründüğünü doğrulayın.
Sorun
Düzeltme
Ekleme kodu kullanılamıyor
Önce botu kaydedin. Ses senkronizasyonu hâlâ beklemedeyse senkronizasyonu bekleyin veya gerekli alanlar tamamlandıktan sonra tekrar kaydedin.
Chat History'yi yenileyin, botun etkin olduğunu onaylayın ve testin eski bir sayfada değil, yüklü widget'ta gerçekleştiğinden emin olun.
Bundan sonra ne yapılmalı: Bot Builder kurulum ve bilgi eğitimine geçin.
02
Bir Bot Oluşturun ve Yapılandırın
My Bots ve Bot Builder'den botlar oluşturun, düzenleyin, önizleyin, etkinleştirin, aktarın veya kaldırın.
/kontrol paneliMy Bots kontrol merkezi
1Yeni bir asistan başlatmak için Yeni Bot'a tıklayın.
2Her bot kartında Düzenle, Göm, Aktar, Etkinleştir veya Sil'i kullanın.
3Test etmeden önce aktif durumu ve son güncelleme zamanını kontrol edin.
/botlar/:id/düzenleBot Builder temel bilgiler sekmesi
1Bot adını, avatarını, ilk mesajını ve sistem talimatlarını girin.
2Yayınlamadan önce test etmek için Önizleme'yi kullanın.
3Ekleme kodunu kopyalamadan önce kaydedin ve senkronize edin.
Bot oluştur
My Bots adresinden yeni bir bot oluşturun
Bu ne için: Yeni bir markanın, web sitesinin, destek kuyruğunun veya kampanyanın kendi asistanına ihtiyacı olduğunda bu iş akışını kullanın.
Başlamadan önce
Bot adını, hedefini, ilk mesajını ve iki veya üç örnek soruyu hazırlayın.
İçeriği içe aktarmayı planlıyorsanız URL genel web sitesini toplayın.
Planın ihtiyaç duyduğunuz sayıda bot ve ses/avatar özelliğine izin verdiğini doğrulayın.
1
My Bots'ı aç
Kenar çubuğunda My Bots öğesini tıklayın.
Beklenen sonuç: Mevcut botlar ve Yeni Bot düğmesi görünür.
2
Yeni Bot'a tıklayın
My Bots sayfasından yeni bir bot başlatın.
Beklenen sonuç: Bot Builder bir taslak asistanıyla açılır.
3
Bot kimliğini ayarla
Bot Adını girin, bir avatar yükleyin veya seçin ve ziyaretçilerin göreceği ilk mesajı yazın.
Beklenen sonuç: Önizleme paneli asistanın adını, avatarını ve selamlamayı yansıtır.
4
Sistem talimatlarını yazın
Botun ne yapması gerektiğini, nasıl konuşması gerektiğini, nelerden kaçınması gerektiğini ve ne zaman insan yardımı istemesi gerektiğini açıklayın.
Beklenen sonuç: Asistanın bilgi eklenmeden önce net davranış kuralları vardır.
5
Temel bilgileri ekleyin
Temel şirket, ürün, destek, fiyatlandırma ve iletişim bilgilerini bilgi alanına yapıştırın.
Beklenen sonuç: Bot, henüz web sitesini içe aktarmaya gerek kalmadan sık sorulan soruları yanıtlayabilir.
6
Botu kaydet
Kaydet'e tıklayın ve kaydedilen veya senkronize edilen onayı bekleyin.
Beklenen sonuç: Botun sabit bir kimliği vardır, önizleme test edilebilir ve yerleştirme seçenekleri kullanılabilir hale gelir.
7
Sonucu önizleyin
Hazırlanan örnek soruları Önizleme'de sorun.
Beklenen sonuç: Cevaplar talimatlara uygun olmalı ve girdiğiniz bilgileri kullanmalıdır.
8
Yalnızca hazır olduğunuzda etkinleştirin
Özel test geçtikten sonra botu aktif hale getirin.
Beklenen sonuç: Bot, widget veya kanal trafiğine hazırdır.
Nasıl test edilir: En az beş gerçekçi soru sorun. Cevabın doğru olup olmadığını, marka üzerinde kalıp kalmadığını ve gerektiğinde insan yardımı isteyip istemediğini kontrol edin.
Sorun
Düzeltme
Cevap çok genel
Daha spesifik bilgiler ekleyin ve talimatları iyi yanıt örnekleriyle yeniden yazın.
Bot cevaplaması gereken soruları reddediyor
Aşırı katı talimatları kaldırın ve o konu için güvenilir bilgiler ekleyin.
Kaydetme yerleştirme kodu oluşturmaz
Gerekli alanları kontrol edin ve ses sağlayıcı senkronizasyonu bittikten sonra tekrar kaydedin.
Bundan sonra ne yapılmalı: Widget ayarlarını yapılandırın, web sitesi bilgilerini ekleyin ve ardından botu yükleyin.
Botları yönet
Bir botu düzenleyin, iş akışını kopyalayın, aktarın, devre dışı bırakın veya silin
Bu ne için: Bir botun güncellemelere, sahiplik değişikliklerine, geçici duraklatmaya veya kalıcı olarak kaldırılmasına ihtiyaç duyduğunda bu iş akışını kullanın.
Başlamadan önce
Bir botu silmeden önce saklamanız gereken tüm konuşma veya iletişim verilerini dışa aktarın.
Botu silmeden veya aktarmadan önce, botun canlı bir web sitesine gömülü olmadığını doğrulayın.
Bir üretim botunu devre dışı bırakmadan önce ekip arkadaşlarınıza söyleyin.
1
My Bots'ı aç
Bot kartını ada veya duruma göre bulun.
Beklenen sonuç: Kart mevcut durumu ve mevcut eylemleri gösterir.
2
Düzenle'yi tıklayın
Bot oluşturucuyu açın ve gerekli değişiklikleri yapın.
Beklenen sonuç: Editör geçerli konfigürasyonu yükler.
3
Kaydet ve yeniden test et
Her önemli değişiklikten sonra Kaydet'e tıklayın ve ardından önizleme sorularını çalıştırın.
Beklenen sonuç: Kaydedilen konfigürasyon, önizleme ve kurulu widget tarafından kullanılır.
4
Geçici olarak devre dışı bırak
Botun şimdilik ziyaretçilerle ilgilenmeyi bırakması gerekiyorsa aktif geçişi kullanın.
Beklenen sonuç: Bot, yapılandırmayı korurken canlı trafik sunmayı durdurur.
5
Sahipliği aktar
Aktar'ı kullanın, alıcının e-postasını girin ve onaylayın.
Beklenen sonuç: Seçilen hesap, uygulama aktarım akışına göre sahiplik alır.
6
Yalnızca kontrollerden sonra sil
Sil'i kullanın, uyarıyı okuyun ve yalnızca bota artık ihtiyaç duyulmadığında onaylayın.
Beklenen sonuç: Uyarıya göre bot ve ilgili konfigürasyon kaldırılır.
Nasıl test edilir: Düzenledikten sonra yüklü widget'ı açın ve değişikliğin nedeni olan soruyu tam olarak sorun. Canlı yanıtın değiştiğini onaylayın.
Sorun
Düzeltme
Eski yanıt hâlâ görünüyor
Web sitesi sayfasını yenileyin, doğru botu kaydettiğinizi onaylayın ve içe aktarılan bilgilerin senkronizasyon gerektirip gerektirmediğini kontrol edin.
Aktarım başarısız oluyor
Alıcı e-postasının geçerli olduğunu ve hedef hesabın botu kabul edebildiğini doğrulayın.
Yanlışlıkla Sil'e tıklandı
Son onaydan önce durun. İşlemin bot verilerini kalıcı olarak kaldırabilmesi nedeniyle silme uyarıları mevcuttur.
Bundan sonra ne yapılmalı: Ziyaretçi deneyiminin iyileştirildiğinden emin olmak için canlı değişikliklerden sonra analizleri ve geçmişi inceleyin.
03
Widget'ı Yükle
Doğru yerleştirme kodunu kopyalayın, HTML, WordPress, React veya gelişmiş SDK bağlamlarına yükleyin, ardından masaüstü ve mobil davranışı doğrulayın.
Modu yerleştirWeb sitesi yükleme pasajını kopyalayın
1Site yığınına göre HTML, WordPress, React veya NPM/SDK seçeneğini seçin.
2Bot kaydedilip senkronize edildikten sonra kodu kopyalayın.
3Parçacığı kapanış gövde etiketinin öncesine veya çerçeve düzenine yapıştırın.
HTML yükleme
Widget'ı standart bir HTML web sitesine yükleyin
Bu ne için: Sayfa şablonunu, tema altbilgisini veya genel HTML düzenini düzenleyebildiğinizde bunu kullanın.
Başlamadan önce
Yerleştirme modunun gerçek bir bot kimliğine sahip olması için önce botu kaydedin.
Üretimden önce bir hazırlama alanı kullanın.
Tam komut dosyası sürümünü ve data-bot-id değerini modaldan uzak tutun.
1
My Bots'ı aç
Yüklemek istediğiniz botu bulun ve Yerleştir'e tıklayın.
Beklenen sonuç: Gömme modeli kurulum sekmeleriyle açılır.
2
HTML seçeneğini seçin
HTML sekmesini seçin ve Kodu Kopyala'yı tıklayın.
Beklenen sonuç: Widget komut dosyası, bot kimliği eklenmiş olarak kopyalanır.
3
Web sitesi şablonunu açın
Widget'ın görünmesi gereken her sayfada oluşturulan genel altbilgiyi veya düzen dosyasını düzenleyin.
Beklenen sonuç: Kasıtlı olmadığı sürece izole edilmiş tek bir sayfayı değil, paylaşılan site kabuğunu düzenliyorsunuz.
4
Gövdeyi kapatmadan önce yapıştırın
Parçayı kapanış gövde etiketinin hemen öncesine yapıştırın.
Beklenen sonuç: Komut dosyası, sayfa içeriğinden sonra yüklenir ve widget kapsayıcısını bağlayabilir.
5
Yayımlayın veya dağıtın
Şablonu kaydedin ve siteyi dağıtın.
Beklenen sonuç: Widget komut dosyası hedef sayfalarda yayındadır.
6
Masaüstünü ve mobil cihazını test edin
Siteyi yeni bir tarayıcı penceresinde ve mobil görünümde açın.
Beklenen sonuç: Widget yapılandırılmış konumda görünür ve konsol hatası olmadan açılır.
Nasıl test edilir: Yayındaki sayfadan bir mesaj gönderin, ardından ileti dizisinin doğru bot'a ait olduğunu doğrulamak için Gelen Kutusu'nu ve Chat History'ı açın.
Sorun
Düzeltme
Widget eksik
Kodun kapanış gövde etiketinden önce olduğunu, komut dosyalarının site oluşturucu tarafından engellenmediğini ve botun etkin olduğunu doğrulayın.
Yanlış bot görünüyor
Parçacığı tekrar kopyalayın ve data-bot-id'yi istenen botla karşılaştırın.
Widget sayfa kontrolleriyle örtüşüyor
Widget Ayarlarında konumu veya boyutu değiştirin ve mobil cihazda tekrar test edin.
Bundan sonra ne yapılmalı: Widget ayarlarını yapın ve kurulumdan sonra potansiyel müşteri yakalamayı yapın.
Beklenen sonuç: Canlı widget amaçlanan asistana bağlanır.
5
Konsolu kontrol edin
Tarayıcı geliştirici araçlarını açın ve yeniden yükleyin.
Beklenen sonuç: Engellenen komut dosyası, yinelenen kapsayıcı veya ağ hatası yoktur.
Nasıl test edilir: Yüklü siteden bir test iletisini tamamlayın ve ardından bu iletinin Gelen Kutusu'nda beklenen URL sayfasıyla göründüğünü doğrulayın.
Sorun
Düzeltme
React yinelenen widget'ları yükler
Komut dosyası eklemeyi bir referansla koruyun veya bileşeni yalnızca kök düzende oluşturun.
WordPress komut dosyası etiketlerini çıkarır
Komut dosyalarına izin veren bir altbilgi ekleme eklentisi veya tema dosyası kullanın.
SDK çağrı başlatılamıyor
Genel anahtarı, asistan kimliğini, tarayıcı izinlerini kontrol edin ve ses erişimini planlayın.
Bundan sonra ne yapılmalı: Davranışı, markalamayı ve potansiyel müşteri yakalamayı kontrol etmek için Widget Ayarları'na gidin.
npm install @vapi-ai/web
import Vapi from '@vapi-ai/web';
const vapi = new Vapi('YOUR_VAPI_PUBLIC_KEY');
await vapi.start('YOUR_ASSISTANT_ID');
vapi.on('call-start', () => console.log('Call started'));
vapi.on('call-end', () => console.log('Call ended'));
04
Widget Ayarları
Modu, temayı, boyutu, konumu, rengi, markalamayı, tepkileri, sesi, izni, potansiyel müşteri yakalamayı, derecelendirmeleri, takip e-postasını ve etkinleştirme durumunu yapılandırın.
Bot Builder / WidgetWidget görünümü ve ziyaretçi davranışı
1chat, ses veya karma modu seçin.
2Temayı, rengi, konumu, boyutu, markayı, izni ve sesi ayarlayın.
3Potansiyel müşteri yakalamayı, derecelendirmeleri, tepkileri ve takip davranışını yapılandırın.
Widget davranışı
Ziyaretçiye yönelik widget davranışını yapılandırma
Bu ne için: Bunu ilk kurulumdan sonra veya widget'ın web sitesiyle eşleşmesi ve daha iyi potansiyel müşteriler yakalaması gerektiğinde kullanın.
Başlamadan önce
Widget'ı bir hazırlama sayfasına yükleyin.
Ziyaretçilerin chat ile mi, sesle mi, yoksa her ikisiyle mi başlaması gerektiğini öğrenin.
Bölge için gerekiyorsa onay ve potansiyel müşteri yakalama kopyasını hazırlayın.
1
Bot oluşturucuyu açın
My Bots'yi açın, Düzenle'yi tıklayın, ardından Widget sekmesini seçin.
Beklenen sonuç: Seçilen bot için widget kontrolleri görünür.
2
Modu seçin
İstediğiniz ziyaretçi deneyimine göre Sohbet, Ses veya Karma'yı seçin.
Beklenen sonuç: Önizleme seçilen modu gösterecek şekilde değişir.
3
Görünümü ayarla
Tema, renk, boyut, düğme konumu ve markalama seçeneklerini seçin.
Beklenen sonuç: Widget, önemli içeriği kapsamadan siteyle eşleşir.
4
Ziyaretçi kontrollerini etkinleştir
Tepkileri, sesi, derecelendirmeleri ve izin istemlerini açın veya kapatın.
Beklenen sonuç: Ziyaretçiler yalnızca kullanmalarını istediğiniz kontrolleri görür.
5
Potansiyel müşteri yakalamayı yapılandırma
Gerekli alanları, isteğe bağlı açıklama alanını ve formun ne zaman görüneceğini seçin.
Beklenen sonuç: Kişiler, kurulumunuza göre conversations öncesinde veya sırasında toplanır.
6
Takip e-postasını ayarlayın
Planınız içeriyorsa takip e-postası davranışını yapılandırın.
Beklenen sonuç: Ziyaretçiler conversations çözüldükten sonra takip mesajları alabilirler.
7
Kaydet ve test et
Kaydet'e tıklayın, hazırlama sayfasını yeniden yükleyin ve widget'ı açın.
Beklenen sonuç: Canlı widget kaydedilen ayarlarla eşleşir.
Nasıl test edilir: Widget'ı masaüstü ve mobil cihazlarda açın, bir müşteri adayı formu gönderin, bir derecelendirme bırakın ve kişi ile görüşmenin kaydedildiğini onaylayın.
Sorun
Düzeltme
Renk güncellenmedi
Botu kaydedin, web sitesini kalıcı olarak yenileyin ve yüklü widget'ın aynı bot kimliğini kullandığını doğrulayın.
Potansiyel müşteri alanları eksik
Potansiyel müşteri yakalamanın etkinleştirildiğini ve seçilen tetikleme koşulunun karşılandığını doğrulayın.
Ziyaretçiler ses kullanamıyor
Ses ayarlarını, tarayıcı mikrofonu iznini, erişim planını ve ses dakikası sınırlarını kontrol edin.
Bundan sonra ne yapılmalı: Prodüksiyonun başlatılmasından önce ses/avatar ayarlarını ve bilgi kaynaklarını ekleyin.
05
Ses ve Avatarlar
Hazır sesleri seçin, ses modunu ve sınırlarını yapılandırın, transkriptleri okuyun, sesleri klonlayın, klonlanmış sesleri atayın ve hazır veya özel avatarları yönetin.
Bot Builder / SesSes, sınırlar, transkriptler ve avatarlar
1Bir stok sesi veya kayıtlı bir klonlanmış sesi seçin.
2Ses dakikası sınırlarını ve transkript kaydetmeyi ayarlayın.
3Hisse senedi avatarlarını seçin veya plan izin veriyorsa özel bir avatar yükleyin.
Ses kurulumu
Sesli aramaları ve transkriptleri ayarlama
Bu ne için: Ziyaretçilerin yalnızca yazmak yerine botla konuşması gerektiğinde bunu kullanın.
Başlamadan önce
Planın sesli dakikaları ve istenen ses/avatar seçeneklerini içerdiğini onaylayın.
Test için sessiz bir tarayıcı ortamı kullanın.
Sesle test etmek için gerçekçi bir destek veya satış sorusu hazırlayın.
1
Ses ayarlarını aç
Bot oluşturucuyu açın ve Ses veya Ses ve Avatarlar alanını seçin.
Beklenen sonuç: Ses kontrolleri ve mevcut ses seçimi görülebilir.
2
Bir stok ses seçin
Mevcut sesleri önizleyin, en uygun olanı seçin ve seçimi kaydedin.
Beklenen sonuç: Bot, çağrılar için seçilen sesi kullanır.
3
Ses modunu yapılandırma
Sesin ziyaretçilere sunulması gerektiğinde Ses veya Hibrit seçeneğini seçmek için Widget Ayarlarını kullanın.
Beklenen sonuç: Ziyaretçiler widget'ta bir ses seçeneği görüyor.
4
Ses sınırlarını ayarlayın
Varsa kullanıcı başına veya çalışma alanı sınırlarını tanımlayın.
Beklenen sonuç: Uzun veya tekrarlanan aramalar, planlanandan daha fazla dakika tüketemez.
Nasıl test edilir: Klonlanmış ses seçiliyken kısa bir soru sorun ve çağrının beklenen sesi/avatarını kullandığını onaylayın.
Sorun
Düzeltme
Klon kalitesi kötü
Tek hoparlörle, sabit ses seviyesinde ve müziksiz olarak daha net örnekler kaydedin.
Özel avatar yükleme kullanılamıyor
Plana bağlı avatar limitleri için Faturalandırmayı kontrol edin.
Eski ses hala çalıyor
Yeni sesi seçtikten sonra botu kaydedin ve widget sayfasını yeniden yükleyin.
Bundan sonra ne yapılmalı: Ses deneyiminin doğru yanıtlara sahip olması için Bilgi ve Veri bölümüne geçin.
06
Bilgi ve Veri
Manuel bilgi ekleyin, web sitesi içeriğini içe aktarın, tarama sonuçlarını uygulayın, içe aktarılan içeriği senkronize edin, ürün feed'i URL ekleyin, feed'leri yenileyin veya kaldırın ve yanıtları test sorularıyla doğrulayın.
Bot Builder / BilgiBilgi kaynakları ve cevap testi
1Politika, fiyatlandırma ve marka kuralları için manuel bilgi ekleyin.
2Web sitesi sayfalarını içe aktarın ve tarama sonuçlarını uygulayın.
3Ürün feed'leri ekleyin ve envanter değiştiğinde bunları senkronize edin.
Bilgi kaynakları
Botu manuel bilgiler, web sitesi içe aktarma ve ürün yayınlarıyla eğitin
Bu ne için: Asistan eksik yanıtlar verdiğinde veya yeni ürün, politika veya web sitesi bilgilerine ihtiyaç duyduğunda bunu kullanın.
Başlamadan önce
Kaynak URLs ve ürün beslemesi URLs'yi hazırlayın.
Yönetici sayfaları veya özel sayfalar gibi hangi sayfaların içe aktarılmaması gerektiğine karar verin.
Eklediğiniz her konu için test soruları oluşturun.
1
Açık Bilgi
Bot Builder açın ve Bilgi veya Veri sekmesini seçin.
Beklenen sonuç: Manuel bilgi, web sitesi içe aktarma ve ürün besleme araçları görünür.
2
Manuel bilgi ekleyin
Kısa bilgileri, politikaları, fiyatları, iletişim ayrıntılarını ve yanıt stili notlarını yapıştırın.
Beklenen sonuç: Bot, yüksek öncelikli yanıtlar için anında güvenilir bir kaynağa sahiptir.
3
Web sitesi içeriğini içe aktar
URL genel web sitesini yapıştırın ve taramayı/içe aktarmayı başlatın.
Beklenen sonuç: Tarama sonuçları, keşfedilen sayfaları veya içe aktarma durumunu gösterir.
4
Sonuçları inceleyin ve uygulayın
Yararlı sayfaları koruyun, alakasız sayfaları kaldırın ve ardından seçilen içeriği uygulayın.
Beklenen sonuç: Bilgi tabanına yalnızca onaylanmış web sitesi içeriği girer.
5
URLs ürün feed'i ekleyin
Google Merchant Center veya desteklenen yayın URLs'yi yapıştırın ve içe aktarın.
Beklenen sonuç: Ürünler, fiyatlar, stok durumu ve özellikler botun kullanımına sunulur.
6
Yayınları yenileyin veya kaldırın
Katalog verileri değiştiğinde yenilemeyi kullanın ve artık kullanılmayan yayınları kaldırın.
Beklenen sonuç: Bot, eski veya yinelenen ürün verilerini önler.
7
Kaydet ve senkronize et
Botu kaydedin ve senkronizasyonun tamamlanmasını bekleyin.
Beklenen sonuç: En son bilgiler, önizleme ve canlı widget yanıtları tarafından kullanılır.
8
Doğrulama soruları sorun
Eklediğiniz kaynak başına bir test sorusu sorun.
Beklenen sonuç: Yanıt, güncellenen içeriği doğru bir şekilde belirtiyor veya yansıtıyor.
Nasıl test edilir: Fiyatlandırma, iadeler, stok durumu, şirket bilgileri ve desteklenmeyen konular hakkında sorular sorun. Botun bilinen konulara yanıt verdiğini ve bilinmeyen ayrıntıları icat etmediğini doğrulayın.
Sorun
Düzeltme
Tarayıcı alakasız sayfaları içe aktarır
Bu sayfaları seçilen sonuçlardan kaldırın ve daha net manuel talimatlar ekleyin.
Ürün fiyatları eski
Özet akışını yenileyin ve URL özet akışının kendisinin geçerli değerleri içerdiğini doğrulayın.
Bot cevapları oluşturur
Botun emin olmadığını söylemesi ve bilgi eksik olduğunda insan desteği sunması gereken bir kural ekleyin.
Bundan sonra ne yapılmalı: Önizleme'ye dönün, tekrar test edin, ardından widget'ı yükleyin veya güncelleyin.
07
Gelen Kutusu, Live Support, Geçmiş, Kişiler
Günlük conversations işlemlerini gerçekleştirin, canlı destek isteklerini talep edin, kontrolü yapay zekaya geri verin, geçmişi dışa aktarın, kişileri yönetin ve kişileri SendPulse ile senkronize edin.
/gelen kutusuGelen kutusu konuşma iş akışı
1Bot veya kanala göre filtreleyin.
2Bir sohbet açın ve gerektiğinde insan gibi yanıt verin.
3Çeviri, çözümleme ve aktarma kontrollerini dikkatli bir şekilde kullanın.
/canlı destekCanlı destek aktarım kontrolü
1Bekleyen devirleri hızlı bir şekilde talep edin.
2Temsilci olarak yanıt verin veya konuşmayı yapay zekaya geri verin.
3Ziyaretçinin artık insan yardımına ihtiyacı kalmadığında sorunu çözün.
/chat-geçmişKonuşma geçmişi ve dışa aktarmalar
1Ziyaretçiye, bota, kanala veya tarihe göre arama yapın.
2Metin ve sesli oturumlar için tam transkriptleri açın.
3Gerektiğinde CSV veya JSON'yi dışa aktarın.
/kişilerKişiler ve SendPulse dışa aktarma
1Kişileri bot veya kaynağa göre filtreleyin.
2İletişim ayrıntılarını ve konuşma içeriğini açın.
3Seçilen kişileri SendPulse'ye aktarın veya senkronize edin.
Gelen kutusu yanıtı
Bir görüşme açın ve bir insan yanıtı gönderin
Bu ne için: Bir operatörün yapay zekanın tek başına devam etmesine izin vermek yerine sem.chat adresinden müşteriye yanıt vermesi gerektiğinde bunu kullanın.
Başlamadan önce
Operatörün bota veya çalışma alanına erişimi olduğunu doğrulayın.
Yanıt vermeden önce konuşmayı okuyun.
Ziyaretçinin aynı dili bekleyip beklemediğini bilin.
1
Gelen Kutusunu Aç
Kenar çubuğunda Gelen Kutusu'nu tıklayın.
Beklenen sonuç: En son conversations bot, kanal, ziyaretçi, durum ve zamanla birlikte görünür.
2
Gerekirse filtreleyin
Konuşmayı bulmak için kanal, bot, okunmamış veya durum filtrelerini kullanın.
Beklenen sonuç: Liste ihtiyacınız olan konuşma setini içerecek şekilde daraltılır.
3
Konuşmayı aç
Ziyaretçi satırını tıklayın.
Beklenen sonuç: Konu başlığının tamamı, ziyaretçi bilgileri ve yanıt kontrolleri görünür.
4
Gerekirse tercüme et
Ziyaretçi dili aracının dilinden farklı olduğunda çeviri kontrollerini kullanın.
Beklenen sonuç: Temsilci anlayabilir ve uygun şekilde yanıt verebilir.
5
Yanıt gönder
İnsan yanıtını yazın ve gönderin.
Beklenen sonuç: Mesaj, bir aracı/insan yanıtı olarak konuya eklenir.
6
Çözün veya açık tutun
Görüşme tamamlandıysa çözümleyin veya takip için açık bırakın.
Beklenen sonuç: Gelen kutusu durumu gerçek müşteri durumuyla eşleşir.
Nasıl test edilir: Bir test görüşmesine güvenli bir test yanıtı gönderin ve bunun ziyaretçi widget'ında ve Chat History'da göründüğünü onaylayın.
Sorun
Düzeltme
Yanıt gönderilemiyor
Ağ durumunu, görüşme durumunu ve canlı desteğin talep edilip edilmediğini kontrol edin.
Ziyaretçi dili yanlış
Yanıt vermeden önce çeviriyi kullanın veya bot dili ayarlarını güncelleyin.
Görüşme Gelen Kutusu'nda değil
Chat History araması yapın ve widget testinin doğru botu kullandığını doğrulayın.
Bundan sonra ne yapılmalı: Aktif geçiş kuyrukları için Live Support ve denetimler için Chat History kullanın.
Canlı destek
Talep edin, yanıtlayın, yapay zekaya geri verin ve aktarımı çözün
Bu ne için: Yapay zeka bir insan istediğinde veya bir ziyaretçinin açıkça bir aracıya ihtiyacı olduğunda bunu kullanın.
Başlamadan önce
Canlı desteği etkinleştirmeden önce bir temsilciyi hazır bulundurun.
Yapay zekanın bot talimatlarında ne zaman aktarım istemesi gerektiğini tanımlayın.
Devir uyarıları için bildirim ayarlarını etkin tutun.
1
Live Support'ı aç
Kenar çubuğunda Live Support öğesini tıklayın.
Beklenen sonuç: Bekleme ve etkin aktarım conversations görülebilir.
2
Talebi talep edin
Bekleyen görüşmede Talep Et'e tıklayın.
Beklenen sonuç: Diğer temsilciler görüşmenin aktif olarak yürütüldüğünü görebilir.
3
İçeriği oku
Yanıtlamadan önce mesajları ve ziyaretçi ayrıntılarını açın.
Beklenen sonuç: Temsilci devir işleminin neden gerçekleştiğini anlıyor.
4
İnsan yanıtını gönder
Açıkça yanıt verin ve konuyu güncel tutun.
Beklenen sonuç: Ziyaretçi insani bir yanıt alır.
5
Uygunsa yapay zekaya geri verin
Sorun yanıtlandığında ve yapay zeka devam edebildiğinde geri verin.
Beklenen sonuç: Yapay zeka konuşmayı yönetmeye devam ediyor.
6
Bittiğinde çöz
Ziyaretçinin artık yardıma ihtiyacı kalmadığında Çözümle'ye tıklayın.
Beklenen sonuç: Aktarma kapatılır ve etkin kuyruktan kaldırılır.
Nasıl test edilir: Bir test aktarımı oluşturun, talep edin, bir kez yanıtlayın, geri verin ve Live Support ve Chat History'deki durum değişikliklerini onaylayın.
Sorun
Düzeltme
Temsilciler istekleri kaçırıyor
Tarayıcı/e-posta/anında bildirimleri etkinleştirin ve kuyruk sahipliği için bir süreç ekleyin.
Yapay zeka kontrolü çok çabuk ele geçirmeye devam ediyor
Talimatları ve aktarım kurallarını, insan kontrolünün çözülene veya geri verilene kadar aktif kalmasını sağlayacak şekilde ayarlayın.
Harici CRM senkronize değil
Geliştirici Tarifleri bölümündeki web kancalarını veya anketi kullanın.
Bundan sonra ne yapılmalı: Destek ekipleri sem.chat dışında çalışıyorsa CRM/webhooks'a bağlanın.
Geçmiş ve kişiler
Görüşme/kişi kayıtlarını arayın, dışa aktarın ve kullanın
Bu ne için: Bunu denetimler, potansiyel müşteri incelemesi, CSV dışa aktarma ve SendPulse senkronizasyonu için kullanın.
Başlamadan önce
conversations'a mı, kişilere mi yoksa her ikisine birden mi ihtiyacınız olduğuna karar verin.
Dışa aktarmadan önce doğru tarih aralığını uygulayın.
Gerekenden fazla kişisel veriyi dışarı aktarmayın.
1
Chat History'ı aç
Kenar çubuğunda Chat History öğesini tıklayın.
Beklenen sonuç: Konuşma filtreleri, istatistikler ve transkript listesi görünür.
2
Ara ve filtrele
Bot, kanal, mod, ziyaretçi veya tarih aralığına göre filtreleyin.
Beklenen sonuç: Yalnızca eşleşen conversations görünür durumda kalır.
3
Transkript açma
Mesaj dizisinin tamamını okumak için bir konuşmaya tıklayın.
Beklenen sonuç: Tam bağlam, iletişim bilgileri ve konuşma meta verileri görünür.
4
conversations dosyasını dışa aktar
Dışa Aktar'a tıklayın ve varsa gerekli formatı seçin.
Beklenen sonuç: Dışa aktarma, filtrelenen görüşme verilerini içerir.
5
Kişileri Aç
Kenar çubuğunda Kişiler'i tıklayın.
Beklenen sonuç: Müşteri adayı/kişi kayıtları kaynak, bot ve durumla birlikte görüntülenir.
6
Kişileri filtreleyin ve dışa aktarın
Kişileri arayın, istenen kayıtları seçin, ardından SendPulse'ye aktarın veya senkronize edin.
Beklenen sonuç: Seçilen kişiler, seçilen eyleme göre sem.chat dışında kullanılabilir.
Nasıl test edilir: Filtrelenmiş küçük bir CSV dosyasını dışa aktarın ve sütunların ve tarih aralığının doğru olduğunu onaylamak için bunu yerel olarak açın.
Sorun
Düzeltme
Kişiler'de kişi eksik
Potansiyel müşteri yakalamanın etkinleştirildiğini ve ziyaretçinin formu gönderdiğini doğrulayın.
İhracat çok büyük
Dışa aktarmadan önce tarih aralığını veya bot filtresini daraltın.
SendPulse senkronizasyon kullanılamıyor
Önce Entegrasyonlar'da SendPulse'ye bağlanın, ardından Kişiler'e dönün.
Bundan sonra ne yapılmalı: Operasyonlar başladıktan sonra performans eğilimlerini anlamak için Analytics'i inceleyin.
08
Kanallar ve Entegrasyonlar
Slack, Facebook, Instagram, WhatsApp, Telegram'yi BotFather, manuel kimlik bilgileri, alternatif chat bağlantıları, SendPulse ve CRM entegrasyonları aracılığıyla bağlayın.
/entegrasyonlarKanallar, CRM ve e-posta bağlantıları
1Kanalı veya CRM entegrasyon kartını seçin.
2Her sağlayıcı için OAuth veya kimlik bilgisi adımlarını izleyin.
3Aynı sayfadan entegrasyonların bağlantısını kesin veya yeniden test edin.
Kanalları bağlayın
Bir mesajlaşma kanalına veya CRM entegrasyonuna bağlanın
Bu ne için: sem.chat'nin web sitesi widget'ı dışından conversations alması veya kişileri diğer araçlara göndermesi gerektiğinde bunu kullanın.
Başlamadan önce
Harici platforma yönetici erişimine sahip olun.
Hangi botun kanal mesajlarını alması gerektiğini bilin.
Üretim hesaplarını bağlamadan önce test kanallarını kullanın.
1
Açık Entegrasyonlar
Kenar çubuğunda Entegrasyonlar'ı tıklayın.
Beklenen sonuç: Kullanılabilir kanallar, CRM araçları, SendPulse ve web sitesi widget seçenekleri görünür.
2
Entegrasyonu seçin
Slack, Meta kanalları, Telegram, SendPulse, CRM veya manuel kimlik bilgilerinde Bağlan'a tıklayın.
Beklenen sonuç: Kurulum iletişim kutusu veya OAuth akışı açılır.
3
Sağlayıcı kurulumunu tamamlayın
OAuth kanalları için istenen izinleri onaylayın. Manuel kanallar için gerekli jetonu, sırrı, hesap kimliğini veya web kancasını (URL) yapıştırın.
Beklenen sonuç: sem.chat bağlantıyı saklar ve entegrasyonu bağlı olarak gösterir.
4
Botu atayın
İletişim kutusu sorulduğunda o kanaldan gelen mesajları hangi botun işleyeceğini seçin.
Beklenen sonuç: Gelen mesajlar doğru asistana yönlendirilir.
5
Kanalı test edin
Harici kanaldan bir test mesajı gönderin.
Beklenen sonuç: Mesaj Gelen Kutusu'nda veya Chat History doğru kanal altında görünüyor.
6
Gerekirse bağlantıyı kesin
Kanalın durması gerektiğinde entegrasyon kartıyla bağlantıyı kes seçeneğini kullanın.
Beklenen sonuç: sem.chat bu entegrasyon aracılığıyla almayı veya göndermeyi durdurur.
Nasıl test edilir: Bağlı kanal üzerinden bir test mesajı gönderin ve bot yanıtını, Gelen Kutusu satırını ve geçmiş kaydını onaylayın.
Sorun
Düzeltme
Telegram belirteci başarısız oluyor
Belirteci BotFather'da oluşturun veya sıfırlayın ve tekrar yapıştırın.
Slack mesajları gelmiyor
Uygulama kapsamlarını, etkinlik aboneliğini URL, bot jetonunu, imzalama sırrını ve kanal üyeliğini kontrol edin.
Meta kanal bağlantısı başarısız oluyor
Facebook/Instagram/WhatsApp hesabının yönetici izinlerine ve gerekli iş erişimine sahip olduğunu doğrulayın.
SendPulse senkronizasyonu başarısız oluyor
SendPulse yeniden bağlanın ve kişi alanlarının eşlendiğini onaylayın.
Bundan sonra ne yapılmalı: Ekibin kanal sahipliğini belgeleyin ve lansmandan sonra Inbox'ı izleyin.
09
Planlama
Etkinlik türleri oluşturun, müsaitlik durumunu yapılandırın, takvimleri bağlayın, rezervasyonları yönetin, tek seferlik bağlantılar oluşturun, rezervasyon e-postalarını yapılandırın, analizleri inceleyin, ücretli etkinlikler ayarlayın ve genel rezervasyon bağlantılarını test edin.
/zamanlamaÇalışma alanını planlama
1Etkinlik Türleri, Rezervasyonlar, Analizler, Tek Seferlik Bağlantılar, Takvimler, E-postalar ve Ayarlar sekmelerini kullanın.
2Etkinlik türlerini düzenleyin, kopyalayın, ekleyin, etkinleştirin veya duraklatın.
3Genel bağlantıyı kopyalayın ve özel bir rezervasyon testi çalıştırın.
Etkinlik düzenleyiciEtkinlik türü yapılandırması
1Adı, açıklamayı, süreyi, konumu ve arabellekleri girin.
/book/:kullanıcı adı/:eventSlugHerkese açık rezervasyon sayfası
1Ziyaretçiler genel rezervasyon sayfasından bir tarih seçerler.
2Ziyaretçiler uygun bir zaman aralığı seçerler.
3Ziyaretçiler rezervasyonu onaylar ve onay e-postası alırlar.
Etkinlik türü
Bir etkinlik türü oluşturun ve bir rezervasyon bağlantısı yayınlayın
Bu ne için: Ziyaretçilerin demolar, danışmanlıklar, satış görüşmeleri, katılım veya destek oturumları için rezervasyon yapması gerektiğinde bunu kullanın.
Başlamadan önce
Etkinlik adını, süresini, toplantı türünü ve sahibini seçin.
Bağlantıları paylaşmadan önce saat dilimini ve kullanılabilirliği ayarlayın.
Çifte rezervasyon önemliyse takvimleri bağlayın.
1
Planlamayı Aç
Kenar çubuğunda Planlama'yı tıklayın.
Beklenen sonuç: Planlama çalışma alanı etkinlik türleri, rezervasyonlar, analizler, tek seferlik bağlantılar, takvimler, e-postalar ve ayarlara ilişkin sekmeleri gösterir.
2
Bir etkinlik türü oluşturun
Oluştur'a tıklayın ve ardından adı, açıklamayı, süreyi, konumu, arabelleği ve ayırma kurallarını ekleyin.
Beklenen sonuç: Etkinlik, ziyaretçilerin anlayabileceği kadar halka açık bilgi içeriyor.
3
Kullanılabilirliği ayarla
Haftalık saatleri, tarih geçersiz kılmalarını, bildirim pencerelerini ve rezervasyon penceresini yapılandırın.
Beklenen sonuç: Ziyaretçiler yalnızca sunmak istediğiniz saatleri görür.
4
Soru ekle
Telefon, şirket, web sitesi veya toplantı hedefi gibi gerekli soruları ekleyin.
Beklenen sonuç: Rezervasyonlar, çağrıdan önce ekibinizin ihtiyaç duyduğu bağlamı toplar.
5
Takvimleri bağlayın
Takvimleri açın ve varsa Google, Outlook veya iCal'ye bağlanın.
Beklenen sonuç: Yoğun zamanlar bloke edilebilir ve onaylanmış rezervasyonlar takvime yazılabilir.
6
E-postaları ve hatırlatıcıları ayarlama
E-postaları açın ve onay, hatırlatma, iptal ve yeniden planlama mesajlarını yapılandırın.
Beklenen sonuç: Ziyaretçiler doğru rezervasyon iletişimini alır.
7
Herkese açık bağlantıyı paylaşın ve test edin
Etkinlik bağlantısını kopyalayın, özel bir pencerede açın, bir slot seçin ve test rezervasyonunu tamamlayın.
Beklenen sonuç: Rezervasyon, Rezervasyonlar sekmesinde görünür ve onay mesajları gönderilir.
Nasıl test edilir: Bir test rezervasyonunu, bir yeniden planlamayı ve bir iptali tamamlayın. Her etkinliğin Planlama ve bağlı takvimlerde göründüğünü doğrulayın.
Sorun
Düzeltme
Herkese açık sayfada hiçbir zaman görünmüyor
Saat dilimini, haftalık kullanılabilirliği, tarih geçersiz kılmalarını, bildirim penceresini ve bağlantılı takvim çakışmalarını kontrol edin.
Rezervasyon e-postası eksik
E-posta ayarlarını ve spam klasörünü kontrol edin, ardından başka bir test rezervasyonu gönderin.
Ücretli etkinlikte ödeme başarısız oluyor
Yayınlamadan önce faturalandırma/ödeme entegrasyonu ayarlarının ve para biriminin geçerli olduğunu onaylayın.
Bundan sonra ne yapılmalı: Rezervasyon bağlantılarını bota, web sitesine veya takip e-postalarına yerleştirin.
Gelişmiş planlama
Tek seferlik bağlantıları, analizleri, yerleştirmeleri ve ücretli etkinlikleri kullanın
Bu ne için: Planlamanın geçici kullanılabilirlik, raporlama, yerleşik rezervasyon veya ödeme gerektirdiği durumlarda bunu kullanın.
Başlamadan önce
Öncelikle en az bir etkinlik türü oluşturun.
Tek seferlik bağlantıları yoğun bir şekilde kullanmadan önce takvimleri bağlayın.
Ücretli etkinlikleri etkinleştirmeden önce geri ödeme/iptal politikasını tanımlayın.
1
Tek seferlik bir bağlantı oluşturun
Tek Seferlik Bağlantıları açın, sunulan alanları veya kuralları seçin ve ardından bağlantıyı oluşturun.
Beklenen sonuç: Alıcı yalnızca seçilen kontenjandan rezervasyon yapabilir.
Beklenen sonuç: Rezervasyonları, tamamlama eğilimlerini ve etkinlik türü performansını görebilirsiniz.
4
Ücretli etkinlikleri etkinleştir
Etkinlik düzenleyiciyi açın, fiyatı, para birimini ve ödeme davranışını ayarlayın.
Beklenen sonuç: Ziyaretçilerin ödeme adımını etkinlik kurulumuna göre tamamlamaları gerekmektedir.
5
Denetim rezervasyonları
Rezervasyonları açın ve yaklaşan, tamamlanan, iptal edilen ve yeniden planlanan girişleri inceleyin.
Beklenen sonuç: Ekip katılımı ve takibi yönetebilir.
Nasıl test edilir: Herkese açık sayfa üzerinden ve eğer kullanılıyorsa gömülü bir sayfa aracılığıyla rezervasyon yapın. Her ikisinin de aynı türde rezervasyon kaydı oluşturduğunu doğrulayın.
Sorun
Düzeltme
Tek seferlik bağlantı yanlış slotları ortaya çıkarıyor
Bağlantıyı daha küçük bir zaman aralığı kümesiyle veya daha katı bir tarih aralığıyla yeniden oluşturun.
Yerleşik rezervasyon çok dar
Yerleştirmeyi daha geniş bir içerik kabına yerleştirin ve mobil düzeni kontrol edin.
Analitik boş görünüyor
Gerçek rezervasyonlar oluşturun veya bekleyin; analizler rezervasyon kayıtlarına bağlıdır.
Bundan sonra ne yapılmalı: Planlama sonuçlarını Raporlara ve Analitiklere bağlayın.
10
Analizler ve Raporlar
Tarih aralıklarını seçin, özel tarihleri kullanın, temel ölçümleri okuyun, CSV dosyasını dışa aktarın, memnuniyet ve görüşme eğilimlerini inceleyin, e-posta raporlarını yapılandırın ve teslimatı doğrulayın.
/analitikAnalitik kontrol paneli
1Tarih aralıklarını veya özel tarihleri seçin.
2Konuşma, memnuniyet, dil, kanal ve dönüşüm ölçümlerini okuyun.
3Çevrimdışı analiz için CSV dosyasını dışa aktarın.
Ayarlar / RaporlarE-posta raporu kurulumu
1Günlük, haftalık veya aylık rapor temposunu seçin.
2Rapor alıcılarını ekleyin.
3Test teslimatı için anında rapor gönderin.
Analitik incelemesi
Analizleri okuyun ve performans verilerini dışa aktarın
Bu ne için: Bunu haftalık incelemeler, başlatma kontrolleri, destek kalitesi incelemesi ve dönüşüm analizi için kullanın.
Başlamadan önce
Metrikleri okumadan önce tarih aralığını seçin.
Hangi botu veya kanalı değerlendirdiğinizi bilin.
Üretim performansını raporlarken özel test tarihlerini hariç tutun.
1
Analytics'i açın
Kenar çubuğunda Analytics'i tıklayın.
Beklenen sonuç: Kontrol paneli ölçümleri ve grafik panelleri görülebilir.
2
Tarih aralığını seçin
Bugünü, 7 günü, 30 günü veya özel tarihleri seçin.
Beklenen sonuç: Tüm grafikler seçilen döneme göre güncellenir.
3
Temel metrikleri okuyun
conversations, sesli dakikaları, memnuniyeti, dönüşümü ve kanal karmasını inceleyin.
Beklenen sonuç: Müşteri etkileşimlerinin hacmini ve kalitesini anlıyorsunuz.
4
Trendleri inceleyin
Konuşma eğilimlerine, memnuniyet değişikliklerine, en sık sorulan sorulara ve dil/kanal kalıplarına bakın.
Beklenen sonuç: Bot talimatlarını veya personeli nerede geliştireceğinizi belirleyebilirsiniz.
5
CSV dosyasını dışa aktar
Ekibin e-tablo analizine ihtiyacı olduğunda Dışa Aktarma CSV seçeneğini kullanın.
Beklenen sonuç: CSV seçilen tarih aralığını ve metrikleri içerir.
6
Bulguları değişikliklere dönüştürün
Bot talimatlarını, bilgileri, widget ayarlarını veya destek kapsamını verilere göre güncelleyin.
Beklenen sonuç: Analizler somut ürün iyileştirmelerine yol açar.
Nasıl test edilir: Küçük bir özel tarihi (CSV) dışa aktarın ve tarih aralığı ile ölçümlerin kontrol panelinde gösterilenlerle eşleştiğini doğrulayın.
Sorun
Düzeltme
Metrikler çok yüksek görünüyor
Aşama/test conversations'nin seçilen tarih aralığına dahil edilip edilmediğini kontrol edin.
Memnuniyet boş
Widget Ayarlarında derecelendirmeleri etkinleştirin ve ziyaretçilerin derecelendirme bırakmasını bekleyin.
Ses dakikaları beklentileri karşılamıyor
Ses modunun yalnızca amaçlanan botlarda etkinleştirildiğini doğrulayın.
Bundan sonra ne yapılmalı: Tekrarlanan görünürlük için e-posta raporlarını planlayın.
Raporlar
Yinelenen e-posta raporlarını ve test teslimatını yapılandırın
Bu ne için: Sahipler, yöneticiler veya müşteriler otomatik performans özetlerine ihtiyaç duyduğunda bunu kullanın.
Başlamadan önce
Raporları kimin alması gerektiğine karar verin.
Doğrulanmış e-posta adreslerini kullanın.
İş inceleme ritimlerine uygun bir tempo seçin.
1
Ayarlar'ı ve ardından Raporlar'ı açın
Ayarlar'a gidin ve Raporlar sekmesini seçin veya varsa Raporlar yönlendirmesini kullanın.
Beklenen sonuç: Rapor temposu, alıcılar ve geçmiş görünür.
2
Kadansı seç
Günlük, haftalık veya aylık raporları etkinleştirin.
Beklenen sonuç: Rapor zamanlaması çalışma alanı için saklanır.
3
Alıcı ekle
Raporları alması gereken e-posta adreslerini girin.
Beklenen sonuç: Raporlar doğru paydaşlara gönderilir.
4
Anlık rapor gönder
Şimdi Gönder'e veya eşdeğer anlık rapor eylemine tıklayın.
Beklenen sonuç: Doğrulama için hemen bir rapor e-postası gönderilir.
5
Rapor geçmişini inceleyin
Raporlar gönderildikten sonra geçmiş panelini kontrol edin.
Beklenen sonuç: Teslimat durumunu ve zamanlamasını onaylayabilirsiniz.
Nasıl test edilir: Test alıcısına anında rapor gönderin ve alındı ve biçimlendirmeyi onaylayın.
Sorun
Düzeltme
Rapor e-postası gelmiyor
Alıcının yazımını, spam klasörünü ve rapor geçmişi durumunu kontrol edin.
Yanlış kişiler rapor alıyor
Alıcıları güncelleyin ve bir sonraki planlı gönderimden önce kaydedin.
Rapor içeriği gürültülü geliyor
Tarih aralığı beklentilerini ayarlayın ve daha ayrıntılı manuel inceleme için Analytics'i kullanın.
Bundan sonra ne yapılmalı: Rapor ritmini bot iyileştirmeleri için çalışma ritmi olarak kullanın.
11
Faturalandırma, Ekip, Güvenlik, Ayarlar, Satış Ortaklığı
Planları başlatın veya yükseltin, faturalandırma portalını yönetin, ekip arkadaşlarını davet edin, rolleri ayarlayın, profili/dili düzenleyin, bildirimleri yapılandırın, 2FA'yı etkinleştirin, tehlike bölgesi eylemlerini kullanın ve ortaklık iş akışını çalıştırın.
/faturalandırmaPlan ve faturalandırma kontrolleri
1Mevcut planı, deneme durumunu ve usage sınırlarını inceleyin.
2Yükseltmeden önce plan özelliklerini karşılaştırın.
3Faturalar, ödeme yöntemleri, iptal veya yeniden etkinleştirme için faturalandırma portalını açın.
/ayarlarAyarlar, ekip ve güvenlik
1Profil ve dil için Genel'i kullanın.
2Davetler ve roller için Ekip'i kullanın.
32FA, API anahtarları ve tehlike bölgesi eylemleri için Güvenliği kullanın.
/bağlı kuruluşOrtaklık programı kontrolleri
1Bir yönlendirme bağlantısı oluşturmak için programa katılın.
2Kampanyalar için yönlendirme bağlantısını kopyalayın.
3Ödeme e-postasını ayarlayın ve uygun ödemeleri isteyin.
Faturalandırma
Bir planı başlatın, yükseltin, iptal edin veya yeniden etkinleştirin
Bu ne için: Çalışma alanının deneme aktivasyonuna, daha fazla limite, faturaya, ödeme güncellemesine veya abonelik değişikliğine ihtiyacı olduğunda bunu kullanın.
Başlamadan önce
Hesap sahibi veya faturalandırma yöneticisi faturalandırma işlemlerini gerçekleştirmelidir.
Hangi özelliklerin planlı olduğunu doğrulayın: ses, klonlanmış sesler, özel avatarlar, API, ekip, CRM ve kanallar.
Ödeme yöntemi ve fatura değişiklikleri için güvenli faturalandırma portalını kullanın.
1
Faturalandırmayı Aç
Kenar çubuğunda Faturalandırma'yı tıklayın.
Beklenen sonuç: Mevcut plan, deneme durumu, usage limitleri ve plan kartları görünür.
2
Planları karşılaştır
chat, ses, ekip, API, avatar, entegrasyon, planlama ve destek sınırlarını inceleyin.
Beklenen sonuç: Hangi planın gerekli özelliğin kilidini açtığını biliyorsunuz.
3
Faturalandırma aralığını seçin
Geçiş mevcutsa aylık veya yıllık seçeneğini seçin.
Beklenen sonuç: Seçilen aralık için fiyatlandırma ve tasarruf güncellemesi.
4
Yükseltme veya ödeme işlemini başlatma
İstediğiniz planı seçin ve ödeme işlemini tamamlayın.
Beklenen sonuç: Abonelik, ödeme onaylandıktan sonra aktif hale gelir.
5
Müşteri portalını aç
Ödeme yöntemi, faturalar, iptal veya yeniden etkinleştirme için faturalandırma portalını kullanın.
Kilitli olan özelliğe geri dönün ve uygulamayı yeniden yükleyin.
Beklenen sonuç: Planda yer alıyorsa kilidi açılmış özellik artık kullanılabilir.
Nasıl test edilir: Yükseltmeden sonra, ses klonlama veya API tuşları gibi önceden kilitlenen özelliği açın ve kilidin kalktığını onaylayın.
Sorun
Düzeltme
Özellik yükseltme sonrasında kilitli kalır
Uygulamayı yenileyin, abonelik senkronizasyonu için bir süre bekleyin ve ardından Faturalandırmayı tekrar kontrol edin.
Ödeme iptal edildi
Faturalandırma'ya dönün ve ödeme işlemini tekrar başlatın; İptal edilen bir ödeme sonrasında plan değişikliği yapılmaz.
Fatura veya kart değişikliği gerekiyor
Uygulamanın içinde ödeme ayrıntılarını düzenlemek yerine müşteri portalını açın.
Bundan sonra ne yapılmalı: Ekip arkadaşlarınızı davet edin ve sahip hesabını güvence altına alın.
Ekip ve güvenlik
Ekip arkadaşlarını davet edin, rolleri ayarlayın, profili düzenleyin, 2FA'yı etkinleştirin ve ayarları yönetin
Bu ne için: Çalışma alanı tek başına kurulumdan ekip çalışmasına geçtiğinde bunu kullanın.
Başlamadan önce
Davet göndermeden önce her takım arkadaşının rolünü öğrenin.
En az ayrıcalıklı erişimi kullanın: Sahip, Yönetici, Düzenleyici, Görüntüleyici.
2FA için hazır bir kimlik doğrulayıcı uygulamanız olsun.
1
Ayarları Aç
Kenar çubuğunda Ayarlar'ı tıklayın.
Beklenen sonuç: Genel, bildirimler, ekip, raporlar, geliştiriciler, güvenlik ve ilgili sekmeler görünür.
2
Profili ve dili düzenleyin
Genel bölümünde görünen adı, profil bilgilerini ve tercih edilen dili güncelleyin.
Beklenen sonuç: Uygulama, kullanıcıyı doğru bir şekilde tanımlar ve mümkün olduğunda seçilen dili kullanır.
3
Ekip üyelerini davet edin
Ekibi açın, bir e-posta girin, bir rol seçin ve daveti gönderin.
Beklenen sonuç: Takım arkadaşı bir davet bağlantısı alır ve kabul edilene kadar beklemede olarak görünür.
4
Rol izinlerini ayarlayın
Tam kontrol için Sahip'i, yönetim için Yönetici'yi, içerik değişiklikleri için Düzenleyici'yi ve salt okunur erişim için Görüntüleyici'yi kullanın.
Beklenen sonuç: Her kullanıcı kendi sorumluluğuna uygun erişime sahiptir.
5
Bildirimleri yapılandırma
E-posta, tarayıcı, push, canlı destek, faturalandırma ve rapor bildirimlerini seçin.
Beklenen sonuç: Doğru kişiler gereksiz gürültü olmadan uyarı alır.
6
2FA'yı etkinleştir
Güvenliği açın, iki faktörlü kimlik doğrulamayı etkinleştirin, kodu tarayın ve kurtarma ayrıntılarını saklayın.
Beklenen sonuç: Hesap, şifreyle giriş yaptıktan sonra ikinci bir faktör gerektirir.
7
Tehlikeli bölge eylemlerini dikkatli kullanın
Gerekli verileri dışa aktarın ve yıkıcı hesap eylemlerinden önce etkin widget'ları/entegrasyonları onaylayın.
Beklenen sonuç: Çalışma alanı kazara veri kaybını önler.
Nasıl test edilir: Bir test ekip arkadaşını davet edin, daveti ayrı bir tarayıcıda kabul edin ve rolün yalnızca amaçlanan özellikleri ortaya çıkardığını onaylayın.
Sorun
Düzeltme
Davet e-postası eksik
Spam'i kontrol edin, daveti yeniden gönderin ve adresi doğrulayın.
Takım arkadaşı çok fazla şey görüyor
Rollerini azaltın ve bot erişim ayarlarını gözden geçirin.
2FA kurulumu başarısız oluyor
Kullanmadan önce cihazın saatini kontrol edin, QR kodunu yeniden tarayın ve kurtarma ayrıntılarını saklayın.
Bundan sonra ne yapılmalı: API anahtarlarını yalnızca onlara ihtiyaç duyan kullanıcılar ve hizmetler için yapılandırın.
Ortaklık
Satış ortağına katılın, yönlendirme bağlantısını kopyalayın, ödeme e-postasını ayarlayın ve ödeme talep edin
Bu ne için: Bir iş ortağı veya müşteri yeni sem.chat kullanıcılara yönlendirmek ve komisyon etkinliğini izlemek istediğinde bunu kullanın.
Başlamadan önce
Yönlendirme özelliğine sahip olması gereken hesabı kullanın.
Ödeme talebinde bulunmadan önce ödeme e-postasını hazırlayın.
Yönlendirme kampanyalarını yayınlamadan önce program kurallarını kontrol edin.
1
Ortaklık Aç
Kenar çubuğunda Üye Ol'a tıklayın veya oraya bağlıysa Ayarlar'dan ortaklık sekmesini açın.
Beklenen sonuç: Ortaklık programı sayfasında katılım, yönlendirme, ödeme ve geçmiş alanları gösterilir.
2
Programa katılın
Hesap henüz katılmamışsa Katıl'a tıklayın.
Beklenen sonuç: Bir yönlendirme kodu ve yönlendirme bağlantısı oluşturulur.
3
Yönlendirme bağlantısını kopyala
Benzersiz bağlantıyı kopyalayın ve içerikte, kampanyalarda veya iş ortağı mesajlarında kullanın.
Beklenen sonuç: Bağlantı aracılığıyla yapılan kayıtlar ortaklık hesabına atfedilebilir.
4
Ödeme e-postasını ayarlayın
Ödeme e-postasını girin ve kaydedin.
Beklenen sonuç: Uygun ödemeler doğru şekilde yönlendirilebilir.
5
Yönlendirmeleri ve komisyonları inceleyin
Yönlendirme listesini, komisyon durumunu ve ödeme geçmişini kontrol edin.
Beklenen sonuç: Neyin beklemede olduğunu, neyin uygun olduğunu veya zaten ödenmiş olduğunu biliyorsunuz.
6
Ödeme talep et
Program kuralları ve minimum tutarlar karşılandığında Ödeme İste'ye tıklayın.
Beklenen sonuç: Ödeme talebi işlenmek üzere kaydedilir.
Nasıl test edilir: Yönlendirme bağlantısını özel bir tarayıcıda açın ve yönlendirme izlemeyle beklenen kayıt akışına ulaştığını doğrulayın.
Sorun
Düzeltme
Yönlendirme bağlantısı eksik
Önce programa katılın veya katıldıktan sonra ortaklık sayfasını yenileyin.
Ödeme isteği kullanılamıyor
Minimum ödeme eşiğini, uygun komisyon durumunu ve ödeme e-postasını kontrol edin.
Yönlendirme ilişkilendirilmedi
Ziyaretçinin tam yönlendirme bağlantısını kullandığını ve izleme parametrelerini çıkarmadığını doğrulayın.
Bundan sonra ne yapılmalı: Varsa, belirtilen müşteri etkisini izlemek için Analitikleri ve Raporları kullanın.
12
Bildirimler ve App Updates
Uyarıları inceleyin, bildirimleri okundu olarak işaretleyin, önemli olayları filtreleyin ve yeni ürün değişikliklerini anlamak için uygulama güncellemelerini kullanın.
/bildirimlerBildirim merkezi
1Okunmamış uyarıları inceledikten sonra Tümünü okundu olarak işaretle seçeneğini kullanın.
2Okunmamış, faturalandırma, canlı destek veya sistem olaylarına göre filtreleyin.
3Uyarıyı okuduktan sonra ilgili özelliği açın.
/app-güncellemeleriUygulama güncellemeleri feed'i
1Yeni özellikler ve düzeltmeler için sürüm notlarını okuyun.
2İş akışı değişmeden önce ekip arkadaşlarınızı eğitmek için ayrıntıları kullanın.
3Kullanıcı arayüzü veya davranış değişikliklerini fark ettikten sonra güncellemeleri kontrol edin.
Bildirimler
Bildirimleri inceleyin ve uyarılara göre hareket edin
Bu ne için: Uygulama aktarımları, fatura durumunu, sistem olaylarını, rapor teslimini veya önemli çalışma alanı etkinliğini raporladığında bunu kullanın.
Nasıl test edilir: Canlı destek isteği veya anlık rapor gibi güvenli bir test etkinliği oluşturun, ardından bildirimin göründüğünü ve okundu olarak işaretlenebileceğini onaylayın.
Sorun
Düzeltme
Hiçbir bildirim gelmiyor
Ayarlar bildirim tercihlerini, tarayıcı iznini ve olayın gerçekten gerçekleşip gerçekleşmediğini kontrol edin.
Çok fazla uyarı
Gürültülü kategorileri devre dışı bırakın veya bunları yalnızca sorumlu ekip üyelerine gönderin.
Okunmamış sayım sıkışmış görünüyor
Tüm okundu işaretlerini işaretledikten sonra uygulamayı yenileyin ve filtrelerin okunmamış öğeleri gizlemediğini onaylayın.
Bundan sonra ne yapılmalı: Davranış değişiklikleri veya yeni kontroller göründüğünde App Updates'yi inceleyin.
Uygulama güncellemeleri
Ürün değişikliklerini anlamak için uygulama güncellemelerini kullanın
Bu ne için: Takım arkadaşlarınızın yeni bir özelliği kullanmadan önce nelerin değiştiğini öğrenmesi gerektiğinde bunu kullanın.
Başlamadan önce
Büyük sürümlerden sonra veya kullanıcı arayüzü değiştiğinde güncellemeleri açın.
İlgili güncelleme notlarını destek ve satış kullanıcılarıyla paylaşın.
Büyük değişikliklerden sonra kritik iş akışlarını yeniden test edin.
1
App Updates'ı aç
Kenar çubuğunda App Updates öğesini tıklayın.
Beklenen sonuç: Güncelleme akışında yeni özellikler, düzeltmeler ve sürüm notları gösterilir.
2
En son güncellemeyi okuyun
En son güncelleme kartını veya ayrıntılı görünümü açın.
Beklenen sonuç: Neyin değiştiğini ve bunun hangi iş akışını etkilediğini görüyorsunuz.
Beklenen sonuç: Doğru ekip üyeleri neyi kontrol etmeleri gerektiğini bilir.
4
Kritik yolları yeniden test edin
Güncelleme bir üretim iş akışını etkiliyorsa bu belgedeki ilgili manuel adımları tekrarlayın.
Beklenen sonuç: Ekip, değiştirilen iş akışının hâlâ çalıştığını doğruladı.
5
Dahili olarak paylaşın
Güncelleme özetini etkilenen alanın sahibi olan kullanıcılara gönderin.
Beklenen sonuç: Ekibin benimsemesi daha sorunsuz oluyor ve destek soruları azalıyor.
Nasıl test edilir: İlgili bir güncellemeden sonra, etkilenen özellik için kılavuzu tekrarlayın ve ekran görüntülerinin veya adım adlarının hâlâ eşleştiğini doğrulayın.
Sorun
Düzeltme
Güncelleme kilitli bir özellikten bahsediyor
Mevcut planın bunu içerip içermediğini doğrulamak için Faturalandırma'yı açın.
Takım değişikliği kaçırdı
Yayına veya haftalık operasyon rutinlerine App Updates incelemesini ekleyin.
Güncellemeden sonra belgeler eski görünüyor
Ekran görüntülerini ve adımları güncellemek için Mühendis Kılavuzunu kullanın.
Bundan sonra ne yapılmalı: Özellikler geliştikçe genel belgeleri güncel tutun.
13
Geliştirici Tarifleri
API anahtarları oluşturun, x-api-key kimlik doğrulamasını kullanın, eylem tabanlı uç noktaları çağırın, canlı desteği CRM ile köprüleyin, web kancalarını kaydedin, imzaları doğrulayın ve widget'ı koda ekleyin.
Ayarlar / GeliştiricilerAPI tuşları, hızlı başlangıç ve usage sekmeleri
1API Anahtarlar sekmesinden API anahtarlarını oluşturun ve iptal edin.
2İlk kıvrılma örnekleri için Quick Start kullanın.
3Yüksek hacimli otomasyonu etkinleştirmeden önce Kullanımı inceleyin.
API hızlı başlangıç
Bir API anahtarı oluşturun ve ilk API çağrılarını yapın
Bu ne için: Komut dosyalarını, özel uygulamaları, CRM köprüleri, harici canlı desteği veya otomasyonu raporlamak için bunu kullanın.
Başlamadan önce
Sunucu tarafı ortamı kullanın. API anahtarlarını JavaScript tarayıcısında göstermeyin.
Her entegrasyon için ayrı bir anahtar oluşturun.
Sırlar bir kez gösterildiğinden anahtarı hemen kopyalayın.
1
Geliştiricileri Aç
Ayarlar'ı açın ve Geliştiriciler'i seçin veya varsa Geliştiriciler yönlendirmesini kullanın.
Beklenen sonuç: API Anahtarlar, Quick Start, Dokümantasyon ve Kullanım sekmeleri görünür.
2
Bir anahtar oluştur
Anahtar Oluştur'a tıklayın, ona net bir etiket verin ve hemen kopyalayın.
Beklenen sonuç: Anahtar sk_live_ ile başlar ve sunucu tarafı istekleri için kullanılabilir.
3
x-api-key başlığını gönder
Her genel API isteğine x-api-key ekleyin.
Beklenen sonuç: Herkese açık API isteğin kimliğini doğrulayabilir ve isteğin kapsamını sahibine verebilir.
4
Botları listele
İhtiyacınız olan bot kimliğini bulmak için action=list-bots çağrısını yapın.
Beklenen sonuç: Yanıt, bot kimliklerini, adlarını, etkin durumu ve yapılandırma özetini döndürür.
5
chat mesajı gönder
POST eylemi chat ile botId ve mesaj.
Beklenen sonuç: Yanıt, yanıtı, modeli ve usage bilgilerini döndürür.
6
usage'ı kontrol edin
Yüksek hacimli işleri çalıştırmadan önce action=usage çağrısını yapın.
Beklenen sonuç: Otomasyon çalıştırılmadan önceki mevcut planı ve usage durumunu biliyorsunuz.
7
Gerektiğinde tuşları döndürün
Kullanılmayan anahtarları iptal edin ve değiştirilen satıcılar veya hizmetler için yenilerini oluşturun.
Beklenen sonuç: Eski hizmetler eski kimlik bilgilerini kullanmaya devam edemez.
Nasıl test edilir: Yerel bir terminal veya sunucu ortamından list-bots ve chat çalıştırın, ardından chat gönderildiyse görüşmenin Chat History içinde göründüğünü doğrulayın.
Sorun
Düzeltme
401 veya yetkisiz yanıt
x-api-key yazımını kontrol edin, anahtarın tamamını kopyalayın ve iptal edilmediğini doğrulayın.
Bot bulunamadı
list-bots'yi tekrar kullanın ve botun API anahtar sahibine ait olduğunu doğrulayın.
Tarayıcı CORS sorunu
API çağrısını arka ucunuza taşıyın; API anahtarları sunucu tarafında kullanıma yöneliktir.
Bundan sonra ne yapılmalı: Odaklanmış uç nokta referansı için /api-docs kullanın ve bu sayfayı iş akışı kılavuzu olarak saklayın.
Botları listele
curl -X GET "https://akhsrklbijflesmcqxur.supabase.co/functions/v1/public-api?action=list-bots" \
-H "x-api-key: sk_live_your_key_here"
chat mesajı gönder
curl -X POST "https://akhsrklbijflesmcqxur.supabase.co/functions/v1/public-api" \
-H "x-api-key: sk_live_your_key_here" \
-H "Content-Type: application/json" \
-d '{
"action": "chat",
"botId": "YOUR_BOT_ID",
"message": "What can you help me with?"
}'
Canlı destek CRM köprüsü
Canlı destek isteklerini CRM'ye anket yapın veya iletin
Bu ne için: Temsilciler başka bir sistemde çalıştığında ancak sem.chat ziyaretçi görüşmesini aldığında bunu kullanın.
Başlamadan önce
CRM köprüsü için adlandırılmış özel bir API anahtarı oluşturun.
Yoklamanın mı yoksa web kancalarının mı altyapınıza uygun olduğuna karar verin.
CRM'nin gelecekteki yanıtlar/çözümler için konuşma kimliklerini sakladığından emin olun.
1
Bekleyen aktarımları listeleme
GET action=live-support-list durum=istendi veya durum=tümü ile.
Beklenen sonuç: CRM insan müdahalesi gerektiren açık conversations alır.
2
Mesajları getir
GET eylemi=live-support-messages ile conversationId.
Beklenen sonuç: CRM tam konu içeriğine ve ziyaretçi ayrıntılarına sahiptir.
3
Yanıt vermeden önce hak talebinde bulunun
POST eylem=live-support-claim.
Beklenen sonuç: sem.chat görüşmeyi aktif olarak işleniyor olarak işaretler.
4
Temsilci yanıtını gönder
POST action=live-support-reply, conversationId, mesaj ve aracıAdı ile.
Beklenen sonuç: Ziyaretçi insan yanıtını ve konu güncellemelerini alır.
5
Çözün veya geri verin
POST action=live-support-resolve çözümleme veya geri verme ile.
Beklenen sonuç: Konuşma bekleme kuyruğundan çıkar veya yapay zeka kontrolü sürdürür.
6
CRM'deki günlük durumu
En son aktarım durumunu, mesaj kimliğini ve zaman damgalarını saklayın.
Beklenen sonuç: CRM ve sem.chat denetlenebilir kalır.
Nasıl test edilir: Güvenli bir aktarım oluşturun, bunu CRM'ye yansıtın, köprüden yanıtlayın ve ziyaretçi dizisi güncellemelerini onaylayın.
Sorun
Düzeltme
Yinelenen CRM biletleri
CRM köprünüzde idempotency anahtarı olarak conversationId kullanın.
Cevaplar düzensiz geliyor
Mesaj zaman damgalarını saklayın ve birden fazla sistemden gelen eşzamanlı yanıtları önleyin.
Temsilci çalışırken AI yanıt verir
Önce devri talep edin ve ancak acentenin işi bittiğinde geri verin.
Bundan sonra ne yapılmalı: Yoklama çok yavaş veya çok pahalıysa web kancalarını kaydedin.
Web kancaları
Web kancalarını kaydedin ve X-SemChat-Signature doğrulayın
Bu ne için: Sisteminizin aktarımlar, mesajlar ve çözüm güncellemeleri için gerçek zamanlı olaylara ihtiyacı olduğunda bunu kullanın.
Başlamadan önce
Web kancası URL, HTTPS olmalı ve herkese açık internetten erişilebilir olmalıdır.
Webhook sırrını hemen saklayın; bir kez gösterilir.
Olayları işlemeden önce imzaları doğrulayın.
1
Web kancasını kaydedin
URL ve olaylarla birlikte POST eylemi webhook-register.
Beklenen sonuç: Yanıt, web kancası ayrıntılarını ve tek seferlik imzalama sırrını içerir.
2
Sırrı sakla
Sırrı sunucu ortamınıza veya gizli yöneticinize kaydedin.
Bu ne için: Bir özellik için doğru eylemi seçerken bunu kullanın.
Başlamadan önce
Her istek aynı genel API işlevini URL kullanır.
GET eylemleri sorgu parametrelerini kullanır. POST eylemleri JSON gövdesini kullanır.
Tüm isteklere x-api-key gönderin.
Nasıl test edilir: Herhangi bir API anahtar veya uç nokta değişikliğinden sonra duman testi olarak usage ve list-bots çağrısını yapın.
Sorun
Düzeltme
Yöntem uyuşmazlığı
Uç nokta tablosunda gösterilen yöntemi kullanın. Bazı eylemler yalnızca GET veya yalnızca POST'dir.
Gerekli değer eksik
botId, conversationId, webhook kimliğini ve eylem yazımını kontrol edin.
Bundan sonra ne yapılmalı: İlk istekler için Quick Start kullanın, ardından tam referans için /api-docs kullanın.
Yöntem
Eylem
Amaç
GET
list-bots
API anahtar sahibinin kullanabileceği tüm botları listeleyin.
GET
get-bot
Bot kimliğine göre bir bot yapılandırması getirin.
POST
chat
Bir bota ziyaretçi mesajı gönderin ve AI yanıtını geri gönderin.
GET
conversations
Bir bot için en son conversations'yi (100'e kadar kayıt) listeleyin.
GET
usage
İade planı, krediler, bot sayısı, conversations ve API anahtarı usage.
GET
live-support-list
Bir insan aracıyı bekleyen veya onun tarafından işlenen conversations listesi.
GET
live-support-messages
Mesajları ve ziyaretçi bilgilerini içeren bir aktarma ileti dizisini getirin.
POST
live-support-reply
Harici bir sistemden insan-aracı yanıtı gönderin.
POST
live-support-claim
Bekleyen bir devir konuşmasını talep edin.
POST
live-support-resolve
Devir işlemini çözün veya kontrolü yapay zekaya iade edin.
POST
webhook-register
Bir HTTPS web kancası uç noktası kaydedin.
GET
webhook-list
Gizli dizileri döndürmeden webhook kayıtlarını listeleyin.
POST
webhook-delete
Kimliğe göre bir web kancası kaydını silin.
14
Mühendis Kılavuzu: Özellik Ekleme
Rotalar, kontrol paneli navigasyonu, bot oluşturucu ayarları, Supabase tablolar/işlevler/geçişler, API belgeler, genel belgeler, SEO kontrolleri ve yerel doğrulama ekleyin.
Uygulama özelliği iş akışı
Uygulama rotası, sayfa, gezinme öğesi ve doküman girişi ekleme
Bu ne için: Müşteriye yönelik yeni bir kontrol paneli özelliği eklerken bunu kullanın.
Başlamadan önce
Düzenlemeden önce bir şube oluşturun.
Özelliğin uygulama deposuna mı yoksa genel sem.chat ön uç deposuna mı ait olduğunu belirleyin.
Yeni yapı eklemeden önce mevcut rotayı, kenar çubuğunu, i18n'yi ve ayar modellerini inceleyin.
1
Rotayı ekle
Src/App.tsx dosyasını müşteri sayfaları için korumalı bir rotayla veya yalnızca sayfanın herkese açık olması gerektiğinde genel rotayla güncelleyin.
Mevcut sayfa kalıplarını, veri yüklemeyi, boş durumları, yükleme durumlarını ve izinleri kullanın.
Beklenen sonuç: Bu özellik kontrol paneliyle tutarlı bir şekilde çalışır.
3
Kontrol panelinde gezinme ekle
Gerekirse kenar çubuğunu/gezinme kaynağını etiket, simge, rota ve plan kapılarıyla güncelleyin.
Beklenen sonuç: Kullanıcılar yeni sayfayı uygulama kabuğundan keşfedebilirler.
4
Bot oluşturucu sekmesi veya ayarı ekle
Özellik bir bota aitse, onu Bot Builder sekmelerinin içine ekleyin ve mevcut kaydetme akışları boyunca devam ettirin.
Beklenen sonuç: Bot'a özgü yapılandırma, yerel durumda mahsur kalmak yerine botla birlikte kaydedilir.
5
Supabase şema/işlev değişikliği ekle
Sunucu tarafı çalışması için tablolar/ilkeler ve uç işlevler için geçişler oluşturun.
Beklenen sonuç: Veritabanı ve sunucu davranışı tekrarlanarak dağıtılabilir.
6
Herkese açıksa API şeklini güncelleyin
supabase/functions/public-api/index.ts dosyasına eylem işleme ekleyin veya genişletin ve x-api-key davranışını belgeleyin.
Beklenen sonuç: Entegrasyonlar özelliği güvenle kullanabilirsiniz.
7
Uygulama belgelerini ve genel belgeleri güncelleyin
Uygulama içi geliştirici belgelerini ve bu /dokümantasyon sayfasını ekran görüntüleri ve tıklamalı adımlarla güncelleyin.
Beklenen sonuç: Kullanıcılar ve mühendisler bu özelliği her iki yerde de görüyor.
8
Kontrolleri çalıştır
Genel sitede uygulama testleri/derleme, SEO optimize edici, site haritası kontrolleri ve tarayıcı doğrulaması çalıştırın.
Beklenen sonuç: Bu özellik yerel olarak çalışır ve genel site taranabilir durumda kalır.
Nasıl test edilir: Yeni rotayı açın, özelliği uçtan uca kullanın, konsol/ağ hatalarını inceleyin ve kullanıcı arayüzünden veritabanı değişikliklerini doğrulayın.
Sorun
Düzeltme
Rota çalışıyor ancak navigasyon vurgulanmıyor
Kenar çubuğu rota eşleşmesini kontrol edin ve yolları yeniden yönlendirin.
Veriler yerel olarak çalışır ancak dağıtılmaz
Geçişi, RLS ilkelerini ve uç işlev ortamı değişkenlerini onaylayın.
Site haritasında genel dokümanlar eksik
SEO optimize ediciyi çalıştırın ve sitemap.xml'de standart URL olup olmadığını inceleyin.
Bundan sonra ne yapılmalı: Kullanıcı arayüzü değiştiğinde belge ekran görüntülerini yakalayın veya yeniden oluşturun.
Dokümanlar bakımı iş akışı
Ürün değişikliklerinden sonra bu genel dokümantasyon sayfasını güncelleyin
Bu ne için: Ekran görüntüleri, iş akışları, API davranışı veya gezinme değiştiğinde bunu kullanın.
Başlamadan önce
Yalnızca güvenli demo verilerini kullanın.
Hiçbir zaman gerçek müşterileri, e-postaları, ödeme ayrıntılarını, API anahtarlarını veya özel conversations ifşa etmeyin.
Önce İngilizce kılavuzu güncelleyin, ardından SEO kontrollerinden önce her yerelleştirilmiş dokümantasyon sayfasını yenileyin.
1
Değiştirilen rotayı denetle
Uygulama rotasını açın ve görsel ve prosedürsel olarak nelerin değiştiğini belirleyin.
Beklenen sonuç: Hangi kılavuz, ekran görüntüsü ve sorun giderme satırlarının düzenlenmesi gerektiğini biliyorsunuz.
2
Güvenli bir ekran görüntüsü yakalayın veya oluşturun
WebP varlıklarını varlıklar/belgeler altına kaydetmeden önce bir demo çalışma alanı kullanın ve sırları maskeleyin.
Beklenen sonuç: Ekran görüntüsü doğru ve yayınlanması güvenlidir.
3
Kılavuzu güncelleyin
İlgili Bunun ne için olduğunu, Başlamadan önce, Adımlar, Beklenen sonuçlar, Test, Sorun Giderme ve Sonraki bölümlerini düzenleyin.
Beklenen sonuç: Kılavuz, kullanıcılara neyi tıklatacaklarını ve her tıklamadan sonra ne olması gerektiğini anlatıyor.
4
Gerekirse navigasyonu güncelleyin
Bölümü yapışkan TOC'ye, mobil bölüm seçiciye ve ana sayfaysa görsel dizine ekleyin.
Beklenen sonuç: Okuyucular yeni içeriği hızla bulabilirler.
5
SEO araçlarını çalıştırın
Düğüm araçları/seo-optimize-statik-pages.js ve düğüm araçları/seo-optimize-statik-pages.js --check'i çalıştırın.
Beklenen sonuç: Kanonik, meta veriler, site haritası ve robot çıktıları doğru kalır.
6
Temizleme ve fark kontrollerini çalıştırın
Düğüm araçları/statik-translation-cleanup.js --audit ve git diff --check'i çalıştırın.
Beklenen sonuç: Statik çeviriler ve boşluklar temizdir.
7
Tarayıcı doğrulaması
Siteyi yerel olarak sunun ve masaüstü ve mobil cihazlarda test edin/belgeleyin.
Nasıl test edilir: Değiştirilen özellik adını /documentation'da arayın ve doğru kılavuz bloğunun göründüğünü onaylayın.
Sorun
Düzeltme
Ekran görüntüsü işaretçileri mobil cihazlarda kayıyor
İşaretçileri ekran görüntüsü görüntüsünün içinde tutun veya duyarlı işaretçi koordinatlarını kullanın.
Arama yeni kılavuzu kaçırıyor
Veri başlığına faydalı anahtar kelimeler ekleyin ve kullanıcıların aradığı ürün terimlerini tam olarak ekleyin.
Yerelleştirilmiş dokümanlar güncelliğini yitirir
İngilizce kılavuzu düzenledikten sonra her yerelleştirilmiş dokümantasyon sayfasını yenileyin, SEO optimize ediciyi yeniden çalıştırın ve sitemap.xml dosyasının her dokümantasyon URL’sini içerdiğini doğrulayın.
Bundan sonra ne yapılmalı: Dokümanlar sayfasını, varlıkları, üstbilgi/altbilgi bağlantılarını, .htaccess'i ve site haritası değişikliklerini birlikte kaydedin.
Odaklanmış API referansına mı ihtiyacınız var?
Eski /api-docs sayfası, uç nokta düzeyindeki API ayrıntıları için kullanılabilir durumda kalır.