İlk kez kuruyorsanız
Hesap ve işletme ayarlarından başlayın. Bilgi kaynaklarını tamamlayıp kullanacağınız web alan adını hazırlayın.
Kurulum masası
Chatbot Kurulum ve Entegrasyon Dokümantasyonu
Widget kurulumu, özellikler ve API rehberlerini inceleyin. Web sitenizi bağlamak, kanal yetkilerini anlamak ve entegrasyon kapsamını planlamak için başlayın.
- Hızlı başlangıç
- Widget ayarları
- Erişim kapsamı
Web sitenize ekleyin
WIDGET KURULUMU
Sitenizin bir parçası.
Panelinizden işletmenize özel kodu alın.
Sitenize ekleyip kendi sayfanızda deneyin.
<!-- İşletmenize özel kurulum -->
<script
src="…/widget.js"
data-yz-tenant-id="…"
async>
</script> Web siteniz
İlk widget kurulumundan özel bağlantı kapsamına, doğru rehberden başlayın.
Amacınıza göre bir başlangıç
Önce yapmak istediğiniz işi seçin.
Sitenize sohbet eklemek, widget görünümünü değiştirmek ve özel bir veri bağlantısı kurmak farklı adımlardır. Bu dokümantasyon alanında kurulum, özellik ve erişim rehberlerini bulabilirsiniz. Yalnızca web widgetı için API geliştirmeye başlamanız gerekmez; panelinizdeki işletmeye özel kod ve doğru alan adı yapılandırmasıyla ilerleyebilirsiniz.
Görünümü düzenliyorsanız
Tema, renk ve açma düğmesi rehberlerini inceleyin. Değişikliği kendi sitenizde masaüstü ve mobilde deneyin.
Özel bağlantı istiyorsanız
Okunacak veriyi, yapılacak işlemi ve yetki modelini tanımlayın. Desteklenen kapsamı doğrulayarak geliştirmeye başlayın.
Rehber kütüphanesi
İhtiyacınız olan yerden devam edin.
İlk kurulumdan sonra kullanılan özellikleri ve görünüm ayarlarını ayrı ayrı inceleyebilirsiniz. Bağlantılar sizi ilgili belgenin ayrıntılarına götürür; belge içindeki kapsam ve gereksinimleri kendi hesabınızla birlikte değerlendirin.
Hızlı başlangıç
Hesap, işletme bilgisi, temel kurulum ve ilk görüşme için izlenecek adımları inceleyin.
HTML kurulumu
İşletmeye özel widget kodunu web sayfanıza eklemek için standart kurulum yolunu kullanın.
WordPress kurulumu
Sitenizde eklenti veya uygun kod ekleme yöntemiyle widgetı kullanmaya başlayın.
Shopify kurulumu
Mağaza temasındaki widget kurulumunu ve kullanılan uygulama bloğunu inceleyin.
Widget görünümü
Markanızın renklerini, karşılama metnini ve kullanılabilir görünüm seçeneklerini ayarlayın.
Sesli sohbet
Tarayıcı, mikrofon izni ve işletmedeki etkin ses özelliğiyle ilgili gereksinimleri öğrenin.
Geliştirmeden önce
Widget erişimi ile yönetim erişimini ayrı düşünün.
Widget kodunda görülen işletme kimliği, arayüzün hangi işletmeye bağlanacağını belirtir. Bu kimlik bir yönetim anahtarı değildir. Panel işlemleri oturum yetkisiyle, web widgetı ise alan adına bağlı erişim koşullarıyla çalışır. Özel bir entegrasyon geliştirirken hangi işlemi kimin adına yaptığınızı belirleyin; yönetim erişim bilgilerini herkese açık web koduna taşımayın.
Herkese açık kurulum kodu
Web sitenize yalnızca kurulum için verilen widget kodunu ekleyin. Sağlayıcı gizli anahtarları ve yönetim tokenları burada yer almaz.
İşleme uygun yetki
Veri okumak ile müşteri veya randevu kaydını değiştirmek farklı ihtiyaçlardır. Her birinin desteklenen kapsamını ayrıca doğrulayın.
Hangi rehber?
Teknik ayrıntıya ihtiyacınız kadar girin.
Başlangıç yolunu daraltmak hem kurulum süresini hem de yanlış entegrasyon varsayımlarını azaltır. Önce gerçek kullanım amacını belirleyin.
Sadece web sitemde sohbet açacağım
Hızlı başlangıç ve sitenizin platformuna uygun widget kurulum rehberiyle ilerleyin. İşletme kimliği, script adresi ve izinli alan adını panelden kontrol edin. Özel API çağrısı yazmak bu temel kurulumun gereği değildir.
Asistanın verdiği yanıtları düzenleyeceğim
İşletme bilgileri, hizmet kayıtları ve bilgi kaynağı rehberlerine bakın. Görünüm ayarları yanıt içeriğini tek başına değiştirmez. Önce eksik veya yanlış bilginin kaynağını düzeltin, ardından ilgili soruyu yeniden deneyin.
Kendi yazılımımla veri alışverişi yapacağım
Hangi verinin hangi yönde taşınacağını ve hangi işlemin yapılacağını yazın. Mevcut bağlantılarla karşılanıp karşılanmadığını inceleyin. Özel kapsam için yetkilendirme, veri alanları ve hata durumları netleşmeden genel bir API örneğini üretim yetkisi olarak değerlendirmeyin.
Uygulama sırası
Rehberi küçük bir kabul denemesiyle tamamlayın.
Kodun sayfada bulunması, müşterinin görüşmeyi tamamlayabildiğini tek başına göstermez. Kurulumu, müşterinin başlayacağı noktadan görerek doğrulayın.
Bilgiler, yetkiler ve kanallar
işletmenize göre belirlenir.
işletmenize göre belirlenir.
- 01
İlgili kurulum yolunu açın
HTML, WordPress veya Shopify gibi gerçek sitenize uygun rehberi seçin. İzin ve işletme hazırlıklarını tamamlayın.
- 02
Paneldeki kodu kullanın
Örnek kimlikleri kendi işletme bilgilerinizle değiştirin. API ve widget adresinde panelinizin verdiği değeri esas alın.
- 03
Bir görüşme deneyin
Widgetı açın, bir soru sorun ve yanıtı kontrol edin. Sesli özellik kullanıyorsanız mikrofon iznini ayrıca deneyin.
Merak edilenler
Dokümantasyonu kullanırken
Kurulumdan günlük kullanıma, karar vermeden önce bilmeniz gerekenler.
Sorunuzu bize iletinAPI bilgisi olmadan widget kurabilir miyim?
Evet. Kod eklemeye izin veren bir web sitesinde paneldeki embed koduyla başlayabilirsiniz. İşletme kurulumu ve alan adı izni tamamlanmalıdır. Özel tema veya güvenlik politikası olan sitelerde geliştirici desteği gerekebilir.
Tenant kimliği gizli bir API anahtarı mı?
Hayır. İşletme kimliği widgetın hangi işletmeye bağlanacağını belirtir. Yönetim erişimi ayrı oturum ve yetki kontrollerine sahiptir. Yönetim tokenlarını veya üçüncü taraf gizli anahtarlarını widget koduna eklemeyin.
Örnek kodu doğrudan kullanabilir miyim?
Örneklerdeki işletme kimliği gibi yer tutucular değiştirilmelidir. Kurulum panelinizde verilen widget ve API adresleri esas alınır. Kodu ekledikten sonra izinli alan adını, aynı sayfada tek kurulum olduğunu ve ilk mesajın yanıtlandığını kontrol edin.
Özel entegrasyon için hangi bilgileri hazırlamalıyım?
Kullandığınız sistemi, okunacak veya yazılacak alanları, veri yönünü ve işlemi başlatacak kullanıcıyı belirleyin. Başarılı ve başarısız durumda beklediğiniz sonucu da paylaşın. Böylece kapsam değerlendirmesi somut bir senaryo üzerinden yapılabilir.
Bir özellik bütün kanallarda aynı şekilde çalışır mı?
İşletmede etkin özellik yanında kanalın kurulumu ve izinleri de gereklidir. Web, sesli sohbet, mesajlaşma ve telefon farklı bağlantı koşullarına sahiptir. Kullanacağınız her kanalda kendi örnek görüşmenizi ayrı deneyin.
İşletmenizin bir sonraki adımı
İlk çalışan görüşmeye ulaşın.
İşletme bilgilerinizi hazırlayın, uygun rehberle kurun ve kendi sitenizde deneyin.