AZAMOL AI ASİSTAN
Asistanınızı sitenize ekleyin
Beş adım, ortalama on-on beş dakika. Sitenizin teması, eklentileri veya barındırma sağlayıcınız ne olursa olsun aynı adımlar geçerlidir.
Başlamadan önce elinizde ne olmalı
- Genel anahtarınız — az_pk_ ile başlayan kısa bir metin. Asistan Panelinizin Embed Kodu sekmesinde hazır bulunur.
- Sitenizin alan adı — asistanı hangi adreste çalıştıracaksanız (örn. ornek.com).
- Sitenizin HTML’ine erişim — tema düzenleyici, özel kod alanı veya bir eklenti.
Anahtarınız gizli değildir
Genel anahtar sayfanızın kaynak kodunda görünür ve bu normaldir. Tek başına hiçbir işe yaramaz: asistan yalnızca sizin doğruladığınız alan adlarında açılır. Başkası anahtarınızı kopyalayıp kendi sitesine koyarsa asistan o sitede hiç çizilmez.
Kurulum
Alan adınızı doğrulayın
Asistan Panelinizde "Alan Adları" sekmesinden asistanı çalıştıracağınız alan adını ekleyin. İki doğrulama yönteminden birini seçebilirsiniz: alan adınıza özel bir DNS TXT kaydı (kayıt adı `_azamol.<alan-adınız>` biçimindedir) veya sunucunuza yükleyeceğiniz bir doğrulama dosyası (`https://<alan-adınız>/.well-known/azamol-dogrulama.txt`). Her iki yöntemde de değer olarak kullanılacak kodu panel üretir; kopyala düğmesiyle alabilirsiniz.
Alan adınız doğrulanana kadar asistan hiçbir sayfada görünmez — bu, anahtarınızın başka sitelerde kullanılmasını engelleyen korumanın ta kendisidir. Birden fazla adres kullanıyorsanız (örneğin ornek.com ve www.ornek.com) hepsini ayrı ayrı ekleyip doğrulayın.
Persona sürümünüzü yayınlayın
Asistanınızın nasıl konuşacağını "Persona" sekmesinden belirleyin ve bir sürümü yayınlayın. Yayınlanmış bir persona sürümü olmadan asistan devreye alınamaz.
Asistanınızı yayınlayın
Alan adınız doğrulanıp bir persona sürümü yayınlandıktan sonra "Ayarlar" sekmesindeki Yayınla düğmesine basın. Bu adım asistanınızı taslaktan canlıya alır; öncesinde embed kodu sitenize eklenmiş olsa bile asistan görünmez.
Embed kodunu sitenize yapıştırın
Aşağıdaki satırı, sayfanızın </body> etiketinden hemen önceye ekleyin. Kendi anahtarınızı Asistan Panelinizin "Embed Kodu" sekmesinden kopyalayabilirsiniz.
<script src="https://azamol.ai/embed/v1.js" data-azamol-key="az_pk_XXXX" async></script>Kodun her sayfada bulunması gerekir; bu yüzden temanızın alt bilgi (footer) bölümüne koymak en pratiğidir. Platformunuza göre nereye yapıştıracağınızı aşağıda bulabilirsiniz.
Sayfayı yenileyin ve kontrol edin
Sitenizi açın. Sağ alt köşede yuvarlak bir düğme belirmeli. Tıklayınca asistan penceresi açılır — asistan ancak o an yüklenir, yani sayfanızı ziyaret eden ama asistanı açmayan kimseye hiçbir yük bindirmez. Bir sorun olursa aşağıdaki sorun giderme bölümüne bakın.
Siteniz HTTPS olmalı
Asistan yalnızca https:// ile yayın yapan sitelerde çalışır. Sitenize hâlâ http:// üzerinden erişiliyorsa önce SSL sertifikanızı devreye alın — bugün neredeyse tüm barındırma sağlayıcıları bunu ücretsiz sunuyor.
Sesli mesaj kullanacaksanız: mikrofon izni
Ziyaretçilerin asistana sesli mesaj gönderebilmesi için sitenizin Permissions-Policy başlığı mikrofon erişimini engellemiyor olmalı. Sunucunuz zaten kısıtlayıcı bir başlık gönderiyorsa (bazı güvenlik eklentileri ve CDN'ler bunu varsayılan olarak ekler) aşağıdaki izni tanımlayın:
Permissions-Policy: microphone=(self "https://azamol.ai")Bu izin verilmezse yalnız sesli mesaj özelliği çalışmaz — yazılı sohbet ve görsel gönderimi bundan etkilenmez; ziyaretçi mikrofon simgesine bastığında anlaşılır bir uyarı görür.
Ziyaretçi asistana ne gönderebilir?
Asistan yazılı mesajın yanında görsel ve sesli mesaj da alır. Ziyaretçinin ayrıca bir uygulama kurmasına gerek yoktur — hepsi sohbet penceresinin içinden çalışır.
- Görsel: JPG, PNG, WebP veya GIF; dosya başına en fazla 5 MB. Ziyaretçi ürün fotoğrafını, bir ekran görüntüsünü ya da elindeki belgenin fotoğrafını gönderip sorusunu sorabilir.
- Sesli mesaj: mikrofon düğmesiyle kaydedilir, en fazla 60 saniye. Yazmak istemeyen ya da mobilde hızlı ilerlemek isteyen ziyaretçiler için.
- Bir mesajda tek ek bulunur — görsel ve ses aynı anda gönderilmez.
Ek içeren bir mesaj da kotanızdan yalnızca 1 mesaj düşer; fotoğraf ya da ses gönderildi diye ek ücret yazılmaz.
Platforma göre nereye yapıştırılır
WordPress
- Yönetim panelinde Görünüm → Tema Dosya Düzenleyici.
- footer.php dosyasını açın.
- Kodu </body> satırının hemen üstüne yapıştırın.
- Kaydedin.
Tema güncellemesinde kaybolmaması için WPCode gibi bir kod ekleme eklentisi ya da alt tema (child theme) kullanmanız daha güvenlidir.
Wix
- Ayarlar → Özel Kod bölümüne gidin.
- Kod Ekle deyin, kodu yapıştırın.
- Yerleşim olarak Body — sonu seçin.
- Tüm sayfalara uygulanacak şekilde kaydedin.
Shopify
- Online Mağaza → Temalar → Kodu düzenle.
- theme.liquid dosyasını açın.
- Kodu </body> satırının üstüne yapıştırın.
- Kaydedin.
Webflow
- Proje ayarlarında Project Settings → Custom Code bölümüne gidin.
- Kodu "Footer Code" (Before </body> tag) alanına yapıştırın.
- Save Changes deyip sitenizi yeniden yayınlayın (Publish) — kod ancak yayınladıktan sonra canlıya yansır.
Bu alan yalnızca ücretli yayın planlarında bulunur; Designer önizlemesinde çalışmayabilir.
Squarespace
- Ayarlar → Gelişmiş (Advanced) → Kod Enjeksiyonu (Code Injection) bölümüne gidin.
- Kodu "Footer" alanına yapıştırın — bu alan sitenizin tüm sayfalarında çalışır.
- Kaydedin.
Kod Enjeksiyonu özelliği bazı giriş seviyesi Squarespace paketlerinde kapalı olabilir; görünmüyorsa paketinizi kontrol edin.
Kendi HTML siteniz
- Her sayfanın HTML dosyasını açın.
- Kodu </body> etiketinin hemen üstüne ekleyin.
- Dosyaları sunucunuza yükleyin.
Ortak bir alt bilgi şablonunuz varsa yalnız oraya eklemeniz yeterli.
Asistan görünmüyorsa
Sırayla şunlara bakın. Vakaların büyük çoğunluğu ilk iki satırdan biridir.
| Belirti | Olası sebep | Çözüm |
|---|---|---|
| Düğme hiç çıkmıyor | Kod sayfaya eklenmemiş ya da anahtar satırı eksik | Sayfanın kaynak kodunda embed/v1.js satırını arayın. Yoksa kod eklenmemiştir; varsa data-azamol-key yazımını kontrol edin. |
| Düğmeye basıyorum, pencere açılmıyor | Alan adı henüz doğrulanmamış ya da asistan henüz yayınlanmamış | Asistan Panelinizde Alan Adları sekmesinden doğrulamayı, Ayarlar sekmesinden de yayın durumunu kontrol edin. www’lu ve www’suz sürümler ayrı sayılır. |
| Pencere açılıyor ama boş kalıyor | Adres izin listesinde yok | Tarayıcıda F12 → Konsol’a bakın; çerçeveleme engellendiyse orada yazar. |
| Yalnız bazı sayfalarda çıkıyor | Kod tüm sayfalara eklenmemiş | Kodu ortak alt bilgi şablonuna taşıyın. |
| Yerelde çalışıyor, canlıda çalışmıyor | Canlı adres ayrıca doğrulanmamış | Alan Adları sekmesinden test ve canlı adreslerin ikisini de ekleyip doğrulayın. |
| Standart dışı port kullanıyorsunuz | ornek.com:8443 gibi adresler ayrı kaynak sayılır | Portlu adresi ayrı bir alan adı olarak ekleyip doğrulayın. |
| Sitenizde güvenlik politikası (CSP) var | Tarayıcı çerçeveyi engelliyor | Politikanıza frame-src https://azamol.ai, script-src https://azamol.ai ve connect-src https://azamol.ai ekleyin. |
| Reklam engelleyici kullanıyorsunuz | Betik engellenmiş olabilir | Gizli sekmede, engelleyici kapalıyken deneyin. |
Bu adımlar sonuç vermezse tarayıcıda F12 → Konsol sekmesini açıp [azamol-embed] ile başlayan satırların ekran görüntüsünü bize gönderin.
Asistan hangi bağlantıları paylaşır?
Kurulumda sitenizi taradığımız için asistan, yanıtına dayanak olan sayfanın bağlantısını da verebilir — ziyaretçi “bu nerede yazıyor” diye ikinci kez sormak zorunda kalmaz.
- Yalnız sizin alan adınızda ve taramada gerçekten görülmüş sayfalar paylaşılır.
- Asistan bir adres uydurur ya da tahmin ederse, o bağlantı ziyaretçiye ulaşmadan sunucuda çıkarılır. Bu, modelden beklenen bir nezaket değil; uygulanan bir kuraldır.
- Bir yanıtta en fazla 2 ayrı sayfaya bağlantı verilir; cevap bir bağlantı listesine dönüşmez.
Bağlantılar yeni sekmede açılır — ziyaretçi sohbetten kopmaz.
Gizlilik metninize eklemeniz gerekenler
Asistan, ziyaretçilerinizin yazdığı mesajları yanıt üretmek için işler. KVKK açısından veri sorumlusu sizsiniz, Azamol ise sizin adınıza çalışan veri işleyendir. Bu nedenle rıza metnini ve aydınlatma yükümlülüğünü kendi gizlilik politikanızda karşılamanız gerekir.
- Sitenizde bir yapay zekâ asistanı bulunduğunu ve mesajların işlendiğini belirtin.
- Ziyaretçinin asistana kimlik numarası, sağlık bilgisi gibi özel nitelikli veri yazmaması gerektiğini hatırlatın.
- Görüşme içeriğinin saklanmadığını yazın — mesajlar yalnızca yanıtı üretmek için işlenir ve ardından atılır; Azamol görüşme metinlerini tutmaz, personeli okuyamaz.
- Mesajların yanıt üretimi için yurt dışında yerleşik bir bulut altyapısında işlendiğini ve bu aktarıma ilişkin aydınlatmayı ekleyin.
Sık sorulanlar
Sitemi yavaşlatır mı?▼
Hayır. Yüklenen dosya sıkıştırılmış hâlde yaklaşık 7 KB ve async olarak çalışır — sayfanızın yüklenmesini beklemez, geciktirmez. Asistan penceresi yalnız ziyaretçi düğmeye bastığında yüklenir.
Tasarımımı bozar mı?▼
Hayır. Asistan sayfanızdan yalıtılmış bir çerçeve içinde çalışır; sizin CSS’iniz onu, o da sizin sayfanızı etkilemez.
Aynı anahtarı birden fazla sitede kullanabilir miyim?▼
Birden fazla alan adı ekleyebilirsiniz; üst sınırı Asistan Panelinizde görürsünüz. Her adresin ayrıca doğrulanması gerekir.
Kaldırmak istersem?▼
Eklediğiniz tek satırı silmeniz yeterli. Başka bir iz bırakmaz.
Takıldığınız bir yerde bize yazın, size yardımcı oluruz. Bize ulaşın
