> ## Documentation Index
> Fetch the complete documentation index at: https://docs.supportly.com.tr/llms.txt
> Use this file to discover all available pages before exploring further.

# Hızlı Başlangıç

> Supportly AI widget'ını üç adımda kurun: site ekleyin, betik etiketini yerleştirin, doğrulayın; ardından ilk sohbeti deneyin.

Bu rehber, widget'ı sitenizde çalışır hale getirmenin en kısa yolunu gösterir. Panelden site oluşturarak başlayın.

**1. Sitenizi ekleyin**

Panelde site ekleme akışını başlatın ve site adını (`site_name`) girin. Site oluşturulduğunda size özel bir public key atanır ve panelde görünür; anahtar `sp_pub_` ile başlar.

Panel kurulumu iki adımda izler: `install_script` (betiği ekleyin) ve `verify_widget` (kurulumu doğrulayın).

**2. Widget betiğini sitenize ekleyin**

Aşağıdaki kodu sitenizin ortak şablonuna ekleyin; `data-supportly-id` değerini kendi public key'inizle değiştirin.

```html theme={null}
<script
  src="https://widget.supportly.com.tr/supportly-chat-widget.js"
  data-supportly-id="sp_pub_xxx"
  async
></script>
```

Widget `/checkout`, `/odeme`, `/payment` ve `/cart/checkout` sayfalarında kendini başlatmaz; ödeme adımlarında sohbet penceresi görünmez.

Sitenizde izinli origin listesi (`allowed_origins`) tanımlıysa widget yalnızca bu domainlerde açılır; listeye sitenizin kendi domainini de eklemeyi unutmayın.

**3. Kurulumu doğrulayın**

Panelde doğrulamayı çalıştırın. Sunucu sitenizi ziyaret eder; betik içinde anahtarınızı bulursa kurulum `completed` durumuna geçer.

Doğrulama başarısızsa: `WIDGET_NOT_FOUND` anahtarın sayfada bulunamadığını, `SITE_UNREACHABLE` siteye erişilemediğini gösterir. Ayrıntılar için [Widget Kurulumu](https://docs.supportly.com.tr/widget/kurulum) sayfasına bakın.

**4. İlk sohbeti deneyin**

Sitenizi açın; sağ altta widget düğmesi görünür. Pencereyi açın ve bir soru yazın; asistan yanıt verir.

Mesajınızda "insan" veya "temsilci" gibi bir ifade geçerse asistan canlı desteğe devir önerir (`suggest_handoff: true`).

> [!NOTE]
>
> Günlük mesaj kotası planınıza göre değişir (Free ve Basic 20, Growth 500, Pro sınırsız). Kullanım %80'e ulaştığında widget uyarı gösterir. Limit tabloları için [API Temelleri](https://docs.supportly.com.tr/api/baslangic) sayfasına bakın.

## Sonraki adımlar

> [card] [Widget Özelleştirme](https://docs.supportly.com.tr/widget/ozellestirme)
>
> Renk, konum, karşılama ve logo ayarlarıyla widget'ı markanıza uydurun.

> [card] [API Temelleri](https://docs.supportly.com.tr/api/baslangic)
>
> Yanıt biçimi, anahtar türleri ve hız limitleri.

> [card] [Widget Davranışı](https://docs.supportly.com.tr/widget/kurulum)
>
> Yapılandırma yükleme, proaktif mesaj ve origin doğrulama ayrıntıları.

> [card] [ikas Entegrasyonu](https://docs.supportly.com.tr/entegrasyonlar/ikas)
>
> Mağazanızı bağlayın; asistan ürün sorularında katalogdan yararlanır.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.