← BLOG / ENTEGRASYON VE TEKNİK KILAVUZ

Web Sitesine Tek Satır Kodla Yapay Zeka Asistanı Entegrasyonu (WordPress, Shopify, Next.js)

WordPress, Shopify, Next.js, Webflow ve özel yazılım sitelere 2 dakikada siteye entegre yapay zeka asistanı kurulumu, HTML data parametreleri ve CSP güvenlik ayarları.

ORZED AI RESEARCH 10 DK OKUMA 18 Kas 2026
Web Sitesine Tek Satır Kodla Yapay Zeka Asistanı Entegrasyonu (WordPress, Shopify, Next.js)
120 sn

URL taramasından canlı yayına geçişe kadar geçen toplam süre

0 Çakışma

Tailwind, Bootstrap ve tema CSS dosyalarından %100 yalıtılmış arayüz

<15 ms

Coğrafi önbellekleme ile dünya genelinde anlık betik teslimi

Yönetici Özeti ve Temel Çıkarımlar
  • NPM paketi kurmak, webpack/vite derlemesi değiştirmek veya arka uç (backend) vekil sunucusu yazmak gerekmez.
  • Tek bir defer script etiketi tüm popüler içerik yönetim sistemleri (CMS) ve modern SPA çerçeveleriyle doğrudan uyumludur.
  • Alan adı beyaz listesi (Allowed Domains) sayesinde widget anahtarınız kaynak kodda görünse bile başka bir sitede çalıştırılamaz.

Adım Adım: Altyapınıza Göre Doğru Entegrasyon Kodu

ChatNOV Stüdyo’da sitenizi taratıp görünümünüzü seçtikten sonra size özel bir proje anahtarı (ör. w_markaniz) üretilir. Standart HTML, WordPress veya Shopify sitelerde tek yapmanız gereken bu satırı kapanış etiketinden hemen önce eklemektir. React ve Next.js gibi tek sayfa uygulamalarda (SPA) ise sayfa geçişlerinde sohbet oturumu kopmadan korunur.

NEXT.JS APP ROUTER (app/layout.tsx) ENTEGRASYONU
import Script from 'next/script';

export default function RootLayout({ children }) {
  return (
    <html lang="tr">
      <body>
        {children}
        <Script
          src="https://cdn.chatnov.com/v1/widget.js"
          data-widget-id="w_markaniz"
          data-skin="particle-orb"
          strategy="afterInteractive"
        />
      </body>
    </html>
  );
}

Neden Iframe Yerine İzole Shadow DOM Kullanıyoruz?

Eski nesil sohbet araçları sayfaya iki ayrı ağır iframe (biri buton, biri sohbet penceresi için) gömer. Her iframe tarayıcıda ayrı bir belge bağlamı (document context) açarak bellek tüketimini artırır, mobil klavye açıldığında ekran taşmalarına yol açar ve sayfa kaydırma akıcılığını bozar.

ChatNOV ise modern tarayıcıların yerleşik Web Components / Shadow DOM standardını kullanır. Böylece asistan tek bir hafif katmanda 60 FPS hızında çalışırken, sitenizdeki global button, input veya z-index kuralları asistanı etkileyemez.

Gelişmiş JavaScript API ve Olay Yönetimi

Sitenizdeki özel bir "Uzmana Sor" veya "Canlı Asistan" butonuna tıklandığında sohbet penceresini doğrudan açtırmak isterseniz küresel örnek üzerinden tek satırla tetikleyebilirsiniz:

ÖZEL BUTONDAN SOHBET VEYA SESLİ MOD AÇMA
// Metin modunda aç
window.chatnovInstance?.open(false);

// Doğrudan sesli dinleme modunda aç
window.chatnovInstance?.open(true);

// 2 aşamalı teklif / lead kartını aç
window.chatnovInstance?.spawnLeadCaptureSheet();

Content Security Policy (CSP) ve Güvenlik Başlığı Ayarları

Bankacılık, SaaS veya yüksek güvenlikli kurumsal sitelerde sıkı Content-Security-Policy (CSP) başlıkları bulunabilir. ChatNOV’un sorunsuz çalışması için script-src yönergesine https://cdn.chatnov.com ve connect-src yönergesine https://chatnov.com adreslerini eklemeniz yeterlidir. Ayrıca Stüdyo içindeki "İzin Verilen Alan Adları" (Allowed Domains) listesine yalnızca kendi domainlerinizi yazarak anahtarınızın başka sitelerde kullanılmasını sunucu düzeyinde kilitlersiniz.

Mimari Karşılaştırma Tablosu

Web Altyapısı / CMS Eklenecek Konum Kurulum Süresi
WordPress / WooCommerce ✓ Görünüm > Tema Dosya Düzenleyici (footer.php) veya WPCode Footer alanı 1 dakika
Shopify / İkas / Ticimax ✓ Online Mağaza > Temalar > theme.liquid içinde kapanışı öncesi 1 dakika
Next.js (App & Pages Router) ✓ app/layout.tsx içinde next/script (strategy="afterInteractive") 2 dakika
Webflow / Wix / Framer ✓ Site Settings > Custom Code > Footer Code kutusu 1 dakika
Laravel / Django / Özel HTML ✓ Ana layout şablonunda etiketinin hemen üstü 1 dakika

Konu Hakkında Sıkça Sorulan Sorular

Google Tag Manager (GTM) üzerinden ChatNOV kurulabilir mi?

Evet. GTM içinde "Özel HTML" (Custom HTML) etiketi oluşturup script kodunu yapıştırarak tüm sayfalarda (All Pages) tetikleyebilirsiniz.

Tek sayfa uygulamalarda (React/Vue) sayfa değişince sohbet sıfırlanır mı?

Sıfırlanmaz. Oturum durumu sessionStorage ve localStorage üzerinde korunduğu için kullanıcı sekmeler ve alt sayfalar arasında gezinirken konuşma kaldığı yerden devam eder.

Kurumsal Yapay Zeka Asistanı Rehberi: Web Sitenize Entegre AI Botu Nasıl Seçilir ve Kurulur?

Siteye entegre yapay zeka asistanı seçerken dikkat edilmesi gereken 7 teknik kriter: RAG kaynak doğrulaması, Core Web Vitals etkisi, veri izolasyonu, kişi başı kota kalkanı ve toplam sahip olma maliyeti.

Oku ↗

E-Ticaret İçin Yapay Zeka Satış Asistanı: Sepet Terkini Azaltma ve 7/24 Ürün Danışmanlığı

Shopify, WooCommerce, İkas ve özel e-ticaret sitelerinde beden, uyumluluk, kargo ve iade sorularını saniyeler içinde kaynak göstererek yanıtlayan hızlı AI satış danışmanı.

Oku ↗

Klinikler ve Sağlık Turizmi İçin Çok Dilli Yapay Zeka Asistanı: 7/24 Uluslararası Hasta Karşılama

Diş, saç ekimi, estetik ve uzman kliniklerde İngilizce, Arapça (RTL), Almanca, Rusça ve Fransızca soruları 7/24 güvenli sınırlar içinde yanıtlayıp hasta iletişim bilgisini yakalayan AI asistan.

Oku ↗

B2B Şirketler, Üreticiler ve İhracatçılar İçin 7/24 Yapay Zeka Teklif ve Lead Yakalama Sistemi

Sanayi, üretim, ihracat, yazılım ve danışmanlık firmalarında teknik PDF kataloglarından soruları yanıtlayıp anonim ziyaretçileri nitelikli satış fırsatına dönüştüren B2B AI asistan.

Oku ↗

Özel bir entegrasyon gereksiniminiz mi var?

ERP, CRM, özel veri hatları ve kurumsal yapay zeka mimarileri için doğrudan ORZED mühendislik ekibiyle çalışın.

ORZED ile İletişime Geç