Teknik Dokümantasyon

Mimari genel bakış

• Tarama — Sitemap ve iç bağlantıları izleyerek alanınızdaki sayfaları getirir
• Render — JavaScript ağırlıklı sayfaları çıkarımdan önce render eder
• Çıkarma — Yapılandırılmış veriler dahil içerik çıkarılır
• Parçalama — İçerik anlamsal parçalara bölünür
• Embed — Parçalar vektör embeddinglere dönüştürülür
• İndeks — Geri getirim için embeddingler saklanır
• Retrieve — Anlamsal benzerlikle ilgili parçalar getirilir
• Generate — Getirilen içerikten yanıt üretilir
• Cite — İlgili içerik bulunursa kaynak sayfaya bağlantı verilir

Tarama

Neleri tarıyoruz

• Sitemap veya iç bağlantılardaki HTML sayfalar
• Yapılandırılmış veriler (JSON‑LD, schema.org)
• Manuel yüklenen belgeler (PDF, HTML, DOCX)

Tarama davranışı

• robots.txt’ye uyar
• User‑Agent tanımlıdır
• Sunucu yükünü azaltmak için hız sınırı uygular
• 429 veya 5xx durumlarında geri çekilir

JavaScript render — SPA ve dinamik içerikler çıkarımdan önce headless tarayıcıyla render edilir.

Yeniden indeksleme

• Sitemap izleme otomatik yeniden indekslemeyi tetikler
• Manuel yeniden indeksleme her zaman mümkündür
• Planınıza göre zamanlanmış yeniden indeksleme

Geri getirim

Anlamsal arama Sorgular embeddinglere dönüştürülür ve anahtar kelime yerine anlamsal benzerlikle eşleştirilir.

Alaka eşikleri Yapılandırılabilir. Yüksek eşik = daha az ama daha güvenli yanıt; düşük eşik = daha geniş kapsam ve daha fazla netleştirme.

Yanıt üretimi

Getirilen içerik modele bağlam olarak iletilir. Yanıtlar yalnızca bu bağlamdan üretilir.

Kaynak alıntıları — İlgili içerik bulunduğunda yanıt kaynak sayfaya bağlantı içerir. Belirsizlik kabul edildiğinde kaynak olmadığı için alıntı olmayabilir.

Sınır davranışı

• Bilmediğini kabul eder
• Netleştirici sorular sorar
• İlgili konular önerir

Embed entegrasyonu

Kurulum Tek script snippet. Asenkron yüklenir.

Uyumluluk

• WordPress
• Webflow
• Shopify
• Squarespace
• Özel yapılar
• SPA (React, Vue, Angular)

Panel üzerinden yapılandırma

• Renkler, logo, konum
• Karşılama mesajı, ton
• Dil ayarları
• Alaka eşikleri

Genel API

Biletler ve aksiyonlar için güvenli, kiracı kapsamlı API erişimi.

Kimlik doğrulama ve erişim

• API anahtarını `X-Api-Key` başlığında gönderin.
• Anahtarları Admin → API keys bölümünden oluşturup iptal edin; entegrasyon başına bir anahtar kullanın.
• Anahtarlar kiracı kapsamlıdır ve scope’larla en az ayrıcalık uygulanır.

Scopes

• `support.read` — biletleri, mesajları ve aksiyonları listeleyin/alın.
• `support.write` — bilet oluşturun/güncelleyin ve mesaj ekleyin.
• `support.actions` — aksiyonları çalıştırın ve durumunu sorgulayın.

Temel uç noktalar

• `/api/v1/public/tickets` — biletleri listeleyin veya oluşturun.
• `/api/v1/public/tickets/{ticket_id}` — bilet detayını alın veya güncelleyin.
• `/api/v1/public/tickets/{ticket_id}/messages` — mesajları listeleyin veya ekleyin.
• `/api/v1/public/tickets/{ticket_id}/actions` — bir bilet için aksiyon çalıştırın.
• `/api/v1/public/actions` — aksiyonları listeleyin veya durumunu alın.

Yanıt formatı

• JSON yanıtlar; zaman damgaları RFC 3339.
• Hatalar `{ error: { type, message, code } }` döndürür.
• Liste uç noktaları `limit` ve `page_token` kabul eder.

Kanal değerleri

• `web`, `email`, `sms`, `whatsapp`, `social`, `voice`, `custom`.
• Harici konuşmaları eşlemek için `channel_id` ve `channel_thread_id` kullanın.
• Mesaj yazımlarını tekilleştirmek için `external_message_id` kullanın.

Zapier kurulumu

Kontrollü bir yüzeyle Zapier üzerinden no-code otomasyon bağlayın.

Giden otomasyon (Threada → Zapier)

• Webhooks by Zapier ile “Catch Hook” tetikleyicili bir Zap oluşturun ve hook URL’sini kopyalayın.
• Admin → Support → Integrations bölümünde webhook URL’si ve isteğe bağlı secret header ile bir Zapier entegrasyonu ekleyin.
• Payload göndermek için Custom HTTP action kullanın; Custom HTTP entegrasyonu seçilmezse Zapier varsayılan olur.

Gelen otomasyon (Zapier → Threada)

• Zapier için scope’lu bir API anahtarı oluşturun (least privilege).
• Bilet ve aksiyonlar için Public API uç noktalarını çağırmak üzere Webhooks by Zapier kullanın.
• Anahtarı Zapier’da güvenli şekilde saklayın ve düzenli olarak döndürün.

Kurumsal hijyen

• Anahtarları ortama göre ayırın (production vs. sandbox).
• Zap devre dışı bırakıldığında veya sahiplik değiştiğinde anahtarları iptal edin.
• Otomasyon yazmak zorunda değilse salt-okunur scope’ları tercih edin.

Güvenlik

Barındırma: GCP, varsayılan US‑Central1. Şifreleme: aktarımda TLS 1.2+, dinlenimde AES‑256. Kimlik doğrulama: Enterprise için OIDC/SAML SSO. Uyumluluk: GDPR uyumlu, yapılandırılabilir saklama, denetim logları. Tehdit modeli prompt injection, XSS, SSRF, veri sızdırmayı kapsar.

Veri işleme

Saklanan

• İndekslenen içerik
• Embeddingler
• Sohbet kayıtları
• Analitik
• Yapılandırma

Saklanmayan

• Ödeme bilgileri (sağlayıcı tarafından işlenir)
• Düz metin kimlik bilgileri

Saklama Kiracıya göre yapılandırılır. Talep üzerine silme mümkündür.

Eğitim İçeriğiniz AI modellerini eğitmek için kullanılmaz.