My Website

` bağlama noktasıdır; sohbet paneli bunun içinde oluşturulur ve boyutlarını doldurur. Div'i dilediğiniz gibi biçimlendirin (sabit bir yükseklik verin, bir flex konteyner içine yerleştirin, bir ızgara hücresine koyun vb.) ve sohbet paneli buna uyum sağlayacaktır. Birden fazla sohbet widget'ı yerleştiriyor olsanız bile sayfada sadece **bir** ` ``` {% endcode %} Satır içi kod parçacığı ise bunu `

` üzerinde taşır, böylece tek bir sayfa farklı yerlere giden birkaç sohbeti barındırabilir: {% code overflow="wrap" %} ```html

``` {% endcode %} Bir temsilci için ifade `?agent=AGENT_ID` veya `data-agent="AGENT_ID"` olarak değişir. Bilinmesi gereken birkaç nokta: - Kimliği elle yazmak yerine kopyala düğmesini kullanın. Kimlik, hesabınızdaki bir kampanya veya temsilciyle eşleşmezse sohbet yine de çalışır ancak varsayılan yönlendirmenize geri döner. - Hali hazırda görüşme yapmakta olan biri, daha sonra başka bir yere yönlendiren bir sayfaya gelse bile başladığı kişiyle görüşmeye devam eder. Bu, bir görüşmenin ortasında kişiliğinin değişmesini engeller. - Sayfaya özel bir hedef, hesap varsayılanınızdan ve anahtar kelime tetikleyicilerinden önceliklidir. ### Widget'a Ziyaretçinin Kim Olduğunu Söyleyin (Gelişmiş) Sohbet widget'ını bir üye alanına, müşteri portalına veya insanların zaten oturum açmış olduğu bir uygulamaya yerleştirirseniz, siteniz zaten kim olduklarını biliyor demektir. Ziyaretçiden daha önce verdiği bilgileri tekrar istememek ve yapay zekanızın onlar hakkında zaten bildiklerinizi kullanabilmesi için bu bilgileri widget'a aktarabilirsiniz. Widget betiğinden **önce** küçük bir ayar bloğu ekleyin: {% code overflow="wrap" %} ```html ``` {% endcode %} Sayfanız, oturum açmış olan kişiye göre bu değerleri sunucu tarafında doldurmalıdır. İki şey gerçekleşir: - **"Başlamadan önce..." formu atlanır.** İsim ve e-posta sağlandığında, ziyaretçi doğrudan sohbete geçer ve bu bilgiler, sanki kendisi yazmış gibi kişisine kaydedilir. - **`data` altındaki her şey yapay zekanıza iletilir.** Oraya koyduğunuz her şey (plan, sipariş numarası, yenileme tarihi, kredi bakiyesi, kaç koltuğa sahip oldukları vb.), yapay zekanın o kişi hakkında bildiklerinin bir parçası haline gelir; böylece "planım ne zaman yenileniyor?" gibi soruları, önce kim olduklarını açıklamalarını istemeden yanıtlayabilir. Sizin için anlamlı olan herhangi bir alan adını kullanabilirsiniz; bunlar kişi üzerinde Özel Alanlar altında görünür. Her mesajla birlikte güncel olarak gönderilen 20 değere kadar bilgi iletilebilir, böylece plan sohbet sırasında değişirse yapay zeka yenisini görür. Satır içi yerleştirmeler için aynı bilgileri bunun yerine `

` üzerine koyabilirsiniz; bu, bir sayfada birden fazla sohbet olduğunda kullanışlıdır: {% code overflow="wrap" %} ```html

``` {% endcode %} Siteniz ziyaretçinin kim olduğunu ancak sayfa yüklendikten sonra biliyorsa (örneğin, oturum açma işleminin sayfa yenilenmeden gerçekleştiği tek sayfalık bir uygulama), ayrıntılara sahip olduğunuzda bunu çağırın; widget kendini güncelleyecektir: {% code overflow="wrap" %} ```html ``` {% endcode %} Bilinmesi gereken birkaç nokta: - Aynı bilgisayarda iki farklı kişi oturum açarsa, ikincisi ilkinin sohbetini görmek yerine yeni bir konuşma başlatır. Widget, kişi değişikliğini fark eder ve kendini sıfırlar. - Bu özellik tek başına bağlam içindir, birinin oturumunu açmak için değildir. Konuşmalar her zaman olduğu gibi ayrı tutulur, bu nedenle bir `id` geçirmek kimsenin başkasının sohbetini açmasına izin vermez ve farklı bir cihaz veya tarayıcı kullanan biri orada yeni bir konuşma başlatır. Konuşmayı cihazlar arasında taşımak için, bir sonraki bölümde açıklandığı gibi `id` oturumunu açın. - İsteğe bağlıdır. Normal bir herkese açık sayfadaki widget bunların hiçbirine ihtiyaç duymaz ve tam olarak daha önce olduğu gibi davranır. #### Aynı konuşmaya herhangi bir cihazda devam edin (oturum açmış ziyaretçi kimliği) Müşterilerinizin hesapları varsa, sohbetlerinin onları takip etmesini sağlayabilirsiniz: telefonda oturum açın, dizüstü bilgisayarda devam edin; gelen kutunuzdaki aynı kişiyle aynı konuşma olur ve yapay zeka söylenen her şeyi bilir. Bunun için DM Champ, ziyaretçinin gerçekten sayfanızın iddia ettiği kişi olduğuna dair kanıta ihtiyaç duyar, aksi takdirde herkes tarayıcısına bir müşteri numarası yazıp o müşterinin sohbetini okuyabilir. Kanıt, sunucunuzda hesapladığınız bir imzadır. 1. Widget'ın **Yönet** panelinde, **Kanallar ve Yerleştirme** altında **Oturum açmış ziyaretçiler** kısmını bulun ve **Gizli anahtar oluştur**'a tıklayın. Kimlik gizli anahtarını kopyalayın. Bunu yalnızca sunucunuzda tutun; asla sayfanın kendisine koymayın. ::: master-only

Sohbet widget'ının Yönet panelindeki Oturum açmış ziyaretçiler satırı; maskelenmiş kimlik gizli anahtarını, Göster, Kopyala ve Yeniden Oluştur düğmelerini ve altında id ve hash alanlarını içeren ayarlar kod parçacığını gösterir — Kanallar ve Yerleştirme altındaki Oturum açmış ziyaretçiler satırı. Gizli anahtar, Göster'e tıklayana kadar gizli kalır; alttaki kod parçacığı, id ve imzasının sayfanızda nereye yerleştirileceğini gösterir.

::: 2. Sunucunuz oturum açmış bir müşteri için bir sayfa oluşturduğunda, o müşterinin kimliğini (ID) gizli anahtarı kullanarak küçük harfli onaltılık (hex) bir dize olarak HMAC-SHA256 ile hesaplayın: {% code overflow="wrap" %} ```js // Node.js const hash = require("crypto").createHmac("sha256", IDENTITY_SECRET).update(customerId).digest("hex"); ``` {% endcode %} {% code overflow="wrap" %} ```php // PHP $hash = hash_hmac('sha256', $customerId, IDENTITY_SECRET); ``` {% endcode %} {% code overflow="wrap" %} ```python # Python import hmac, hashlib hash = hmac.new(IDENTITY_SECRET.encode(), customer_id.encode(), hashlib.sha256).hexdigest() ``` {% endcode %} 3. Kimliği ve karmayı (hash), zaten ilettiğiniz ad ve e-postanın yanındaki ayarlar bloğuna yerleştirin: {% code overflow="wrap" %} ```html ``` {% endcode %} Satır içi gömme, `

` üzerindeki `data-visitor-hash` ile aynı değeri alır ve `window.chatWidget.setVisitor({ visitor: { id, hash } })`, sayfayı yeniden yüklemeden kişilerin oturumunu açan uygulamalar için çalışır. İmza doğrulandığında ne olur: - Müşterinin sohbeti tarayıcı altında değil, hesabı altında saklanır, böylece oturum açtıkları her cihazda ve her tarayıcıda aynı konuşma olur ve gelen kutunuzda tek bir kişi olarak görünür. - Önceki mesajları yeni cihazda yüklenir ve yapay zeka kaldığı yerden devam eder. - İmza yanlışsa, widget sessizce daha önce olduğu gibi normal, tarayıcı bazlı bir sohbet gibi davranır ve bir geliştiricinin fark edebilmesi için nedeni tarayıcı konsoluna yazdırır. Ziyaretçileriniz asla bir hata görmez. - Kimlik, gönderdiğiniz şekilde tam olarak karşılaştırılır, bu nedenle `id` olarak ilettiğiniz değerin aynısını imzalayın ve her yerde aynı kişi için aynı kimliği kullanın. Bilmeniz gereken iki şey: - Yönet panelindeki **Yeniden oluştur**, size yeni bir gizli anahtar verir. Eski anahtarla oturum açmaya devam eden sayfalar, sunucunuz yeni gizli anahtarı kullanana kadar normal tarayıcı bazlı sohbetlere geri döner. Mevcut konuşmalar korunur; bunlar gizli anahtara değil, müşterinin kimliğine bağlıdır. - Birinin anonim bir ziyaretçi olarak oturum açmadan önce yaptığı konuşma, ayrı bir sohbet olarak kalır. Hesap tabanlı konuşma, oturum açmışken gönderdikleri ilk mesajla başlar. ### Widget Ayarlarını Kendi Kodunuzdan Değiştirin (API) Widget'ın **Yönet** panelindeki her şey [REST API](../api/reference.md) üzerinden de değiştirilebilir; bu, birçok web sitesini yönetiyorsanız veya bir müşteri için ek dosya düğmesinin otomatik olarak kapatılmasını istiyorsanız oldukça kullanışlıdır. API anahtarınızla birlikte `https://api.dmchamp.com/v1/chat-widget-configs/CONFIG_ID` adresine bir `PATCH` gönderin ve yalnızca değiştirmek istediğiniz alanları belirtin; örneğin `{"show_upload_button": false}` ek dosya düğmesini gizler, `{"show_emoji_button": false}` emoji seçiciyi gizler ve `{"launcher_icon": "chat-dots"}` başlatıcı simgesini değiştirir. `CONFIG_ID`, yerleştirme kodunuzdakiyle aynı tanımlayıcıdır. Kabul edilen alanların tam listesi (ad, karşılama mesajı, renkler, başlatıcı simgesi, izin verilen alan adları, ziyaretçi bilgi formu, gizlilik bildirimi, tema, köşe ve yazı tipi stili) [API Başvurusu](../api/reference.md) altında **Sohbet Widget'ı** bölümünde yer almaktadır. Web siteleri, değişikliği sayfa bir sonraki yüklendiğinde algılar. ### Kurulumdan Sonra Sizi Neler Bekliyor Komut dosyasını web sitenize ekledikten sonra, sohbet widget'ı web sitenizin köşesinde (varsayılan olarak sağ alt) otomatik olarak bir sohbet düğmesi oluşturacaktır. Widget, kullanıcılar sayfalarınızda gezinirken sabit bir konumda kalarak her zaman erişilebilir olmasını sağlar. ::: master-only

Ziyaretçi tıklamadan önce canlı bir web sitesinin sağ alt köşesindeki yüzen sohbet balonu — Ziyaretçilerin sohbeti açmadan önce sitenizde gördükleri şey budur — sadece Görünüm ayarlarınıza göre konumlandırılmış yüzen düğme.

::: Ziyaretçiler bu düğmeye tıkladığında, karşılama mesajınızı göstererek konuşmayı başlatabilecekleri tam bir sohbet penceresine genişler. Ziyaretçi bilgilerini topla özelliği açıksa, yazmaya başlamadan önce adlarını ve e-postalarını (ve isteğe bağlı olarak telefonlarını) isteyen küçük bir form görünür. ::: master-only

Arka planda açılış mesajını ve önünde 'Başlamadan önce' müşteri adayı yakalama formunu (Ad, E-posta, Telefon) gösteren açılmış sohbet paneli — Açılmış sohbet paneli. Burada Ziyaretçi bilgilerini topla özelliği açık olduğundan, "Başlamadan önce..." formu sohbetin üzerinde görünür — ziyaretçiler bunu bir kez doldurur, ardından normal şekilde sohbet ederler.

::: Sohbet arayüzü farklı ekran boyutlarına otomatik olarak uyum sağlar, bu nedenle hem masaüstü hem de mobil cihazlarda sorunsuz çalışır. ### Uygulamanızı Test Etme Widget'ı sitenize ekledikten sonra çalıştığını test edin: 1. Web sitenizi bir tarayıcıda açın. 2. Widget'ı açmak için sohbet düğmesine tıklayın. 3. Bir test mesajı gönderin ve yanıt aldığınızı doğrulayın. 4. Her yerde çalıştığından emin olmak için farklı bir cihaz veya tarayıcıda tekrarlayın. ::: master-only

Bir ziyaretçi test mesajı gönderdikten sonra sohbet paneli; giden mesaj balonu açılış mesajının altında görünür — Bir mesaj gönderildikten sonra, mesaj dizisinde giden bir balon olarak görünür — yapay zekanız veya ekibiniz aynı pencerede yanıt verir.

::: Sohbet widget'ı sitenizde görünmüyorsa şunları kontrol edin: 1. `CONFIG_ID` kısmını gerçek yapılandırma tanımlayıcınızla değiştirdiğinizden emin olun. 2. Komut dosyası etiketinin kapanış `` etiketinden önce yerleştirildiğinden emin olun. 3. Kodda yazım hatası olup olmadığını kontrol edin. ### Kurumsal Güvenlik Duvarının Arkasında Widget halka açık olarak yükleniyor ancak ofis ağındaki personel için yüklenmiyorsa, ağ neredeyse kesinlikle yüklendiği alan adını engelliyordur. BT ekibinizden 443 numaralı bağlantı noktasında (port) normal HTTPS üzerinden şunlara izin vermelerini isteyin: - **Yerleştirme kodunuzdaki alan adı** — Yönetim panelinden kopyaladığınız `