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

# API Bağlantı Sorunları — Tanı ve Çözüm Rehberi

> Platform API bağlantı sorunlarını tanılayın ve çözün. Bağlantı hatası, zaman aşımı ve ağ sorunları için adım adım sorun giderme rehberi.

## Genel Bakış

Bu makale, platform ile AI servisleri ve diğer harici servisler arasındaki bağlantı sorunlarını ele alır. API bağlantı problemleri, çağrı yapılamama, agent çalışmama ve veri senkronizasyon hatalarına neden olabilir.

## API Anahtarı Sorunları

<AccordionGroup>
  <Accordion title="&#x22;Geçersiz API Anahtarı&#x22; Hatası">
    **Belirtiler:**

    * "API key is invalid" mesajı
    * Agent oluşturulamıyor
    * Çağrı başlatılamıyor
    * Dashboard'da ⚠️ **Bağlantı Sorunu** göstergesi

    **Olası Nedenler:**

    * API anahtarı yanlış girilmiş
    * API anahtarı silinmiş veya iptal edilmiş
    * API anahtarı süresi dolmuş
    * Yanlış environment (test/production) anahtarı

    **Çözüm:**

    **Adım 1: API Anahtarını Kontrol Edin**

    1. Sol menüden **Ayarlar** > **API Keys** sayfasına gidin
    2. Platform API anahtarınızı görüntüleyin
    3. Anahtarın tam olarak doğru olduğundan emin olun

    **Adım 2: Yeni API Anahtarı Alın**

    1. API servis sağlayıcısı kontrol paneline gidin
    2. **API Keys** bölümüne gidin
    3. Yeni bir API anahtarı oluşturun
    4. Anahtarı kopyalayın

    **Adım 3: API Anahtarını Güncelleyin**

    1. Platform Ayarlar > API Keys
    2. Eski anahtarı silin
    3. **Yeni API Key Ekle** butonuna tıklayın
    4. API anahtarını yapıştırın
    5. **Kaydet** ve **Test Bağlantısı** yapın

    **Doğrulama:**

    * Dashboard'da AI Entegrasyon Durumu ✅ **Bağlı** olmalı
    * Test agent oluşturabilmelisiniz

    <Warning>
      API anahtarınızı kimseyle paylaşmayın ve güvenli bir yerde saklayın.
    </Warning>
  </Accordion>

  <Accordion title="API Anahtarı Görünmüyor">
    **Belirtiler:**

    * API Keys sayfası boş
    * "Henüz API anahtarı eklenmedi" mesajı
    * Agent oluştur butonu pasif

    **Neden:**

    * İlk kurulum tamamlanmamış
    * API anahtarı hiç eklenmemiş

    **Çözüm:**

    1. **İlk Kurulum Wizard'ı Tamamlayın**:
       * Ayarlar > Setup sayfasına gidin
       * Adım adım kurulum talimatlarını izleyin
    2. **Manuel API Key Ekleme**:
       * Ayarlar > API Keys > **Yeni API Key Ekle**
       * API anahtarınızı yapıştırın
       * Kaydedin
  </Accordion>

  <Accordion title="&#x22;API Quota Exceeded&#x22; Hatası">
    **Belirtiler:**

    * "API request limit exceeded" mesajı
    * Çağrılar başlamıyor
    * 429 Too Many Requests hatası

    **Neden:**

    * API servis planı limitine ulaşıldı
    * Çok fazla concurrent request

    **Çözüm:**

    1. **API Plan Kontrolü**:
       * Servis sağlayıcısı kontrol panelinde plan limitlerinizi kontrol edin
       * Kullanım istatistiklerinizi görün
    2. **Plan Yükseltme**:
       * Daha yüksek plana geçin
       * Daha fazla API call hakkı satın alın
    3. **Rate Limiting Ayarı**:
       * Platform ayarlarından eş zamanlı çağrı limitini düşürün
       * Kampanyaları daha yavaş çalıştırın
  </Accordion>
</AccordionGroup>

## AI Servis Entegrasyon Sorunları

<AccordionGroup>
  <Accordion title="Agent Oluşturulamıyor">
    **Belirtiler:**

    * "Agent oluşturulamadı" hatası
    * API bağlantı hatası
    * Timeout error

    **Olası Nedenler:**

    * AI servisleri çalışmıyor
    * API anahtarı geçersiz
    * Network bağlantı sorunu

    **Çözüm:**

    **Adım 1: Servis Durumu**

    1. Servis sağlayıcısı durum sayfasını kontrol edin
    2. Servisler çalışıyor mu bakın
    3. Maintenance window olabilir

    **Adım 2: API Anahtarı Test**

    1. Ayarlar > API Keys > **Test Bağlantısı**
    2. Başarılı olursa API key çalışıyor
    3. Başarısız olursa anahtarı yenileyin

    **Adım 3: Network Kontrolü**

    1. İnternet bağlantınızı kontrol edin
    2. Firewall/proxy ayarlarını kontrol edin
    3. VPN kullanıyorsanız kapatıp deneyin

    **Adım 4: Farklı Tarayıcı**

    1. Incognito/private mode deneyin
    2. Farklı cihazdan deneyin

    <Tip>
      AI servis kesintileri nadirdir ama olabilir. Servis durum sayfasını takip edin.
    </Tip>
  </Accordion>

  <Accordion title="Çağrı Başlatılamıyor - API Error">
    **Belirtiler:**

    * "Failed to start call" mesajı
    * API error
    * Call status: failed immediately

    **Olası Nedenler:**

    * Agent konfigürasyonu hatalı
    * Telefon numarası geçersiz
    * Provider credentials eksik

    **Çözüm:**

    **Agent Konfigürasyonu:**

    1. Agent ayarlarına gidin
    2. Tüm zorunlu alanların dolu olduğundan emin olun:
       * Agent adı
       * İlk mesaj modu
       * Sistem talimatı
    3. Test araması yapın

    **Telefon Numarası:**

    1. `E.164` formatında olmalı: +905551234567
    2. Geçerli bir numara olduğundan emin olun
    3. DNC listesinde olmamalı

    **Provider Credentials:**

    1. Servis sağlayıcısı kontrol panelinde telefon numarası bağlantınızı kontrol edin
    2. SIP trunk ayarlarını doğrulayın
    3. Telefon servisi credentials güncel mi bakın
  </Accordion>

  <Accordion title="Webhook Hataları">
    **Belirtiler:**

    * Call events alınamıyor
    * Transcript görünmüyor
    * Call status güncellenmiyor

    **Neden:**

    * Webhook signature doğrulaması başarısız
    * Webhook URL'i yanlış
    * Webhook secret yanlış

    **Çözüm:**

    **Çözüm:**

    **Adım 1: Bağlantıyı Kontrol Edin**

    1. İnternet bağlantınızın stabil olduğundan emin olun
    2. Sayfayı yenileyin ve çağrı durumunu tekrar kontrol edin

    **Adım 2: Çağrı Detaylarını İnceleyin**

    1. Çağrı listesinden ilgili çağrıya tıklayın
    2. Çağrı durumu ve transkript bilgilerini kontrol edin
    3. Birkaç dakika bekleyip tekrar kontrol edin — veriler gecikmeli yüklenebilir

    **Adım 3: Sorun Devam Ediyorsa**

    1. Destek ekibine bildirin
    2. Etkilenen çağrı ID'sini ve tarih/saat bilgisini paylaşın
  </Accordion>
</AccordionGroup>

## Kimlik Doğrulama Sorunları

<AccordionGroup>
  <Accordion title="&#x22;Authentication Failed&#x22; Hatası">
    **Belirtiler:**

    * Giriş yapılamıyor
    * Oturum otomatik kapanıyor
    * 401 Unauthorized hatası

    **Olası Nedenler:**

    * Oturum süresi dolmuş
    * Tarayıcı çerezleri engellenmiş
    * Kimlik doğrulama servisi geçici olarak kullanılamıyor

    **Çözüm:**

    **Adım 1: Tekrar Giriş Yapın**

    1. Çıkış yapın ve tekrar giriş yapın
    2. "Beni hatırla" seçeneğini işaretleyin

    **Adım 2: Tarayıcı Ayarlarını Kontrol Edin**

    1. Tarayıcı çerezlerinin aktif olduğundan emin olun
    2. Tarayıcı cache ve çerezlerini temizleyin
    3. Gizli/özel modda deneyin

    **Adım 3: Farklı Tarayıcı Deneyin**

    1. Chrome, Firefox veya Safari ile deneyin
    2. Tarayıcınızın güncel olduğundan emin olun

    **Sorun devam ediyorsa** destek ekibine bildirin.
  </Accordion>

  <Accordion title="&#x22;Oturum Geçersiz&#x22; Hatası">
    **Belirtiler:**

    * API istekleri 401 hatası dönüyor
    * Sürekli giriş ekranına yönlendirme
    * "Oturum doğrulaması başarısız" mesajı

    **Olası Nedenler:**

    * Oturum süresi dolmuş
    * Bilgisayar saat ayarı yanlış
    * Tarayıcı çerezleri bozulmuş

    **Çözüm:**

    **Adım 1: Saat Ayarını Kontrol Edin**

    1. Bilgisayarınızın saat ayarını kontrol edin
    2. Otomatik saat ayarını aktif edin
    3. Saat diliminin doğru olduğundan emin olun

    **Adım 2: Tarayıcı Cache Temizleyin**

    1. Tarayıcı ayarları > Gizlilik > Tarama verilerini temizle
    2. Çerezleri ve cache'i temizleyin
    3. Tarayıcıyı yeniden başlatın

    **Adım 3: Tekrar Giriş Yapın**

    1. Çıkış yapıp tekrar giriş yapın
    2. Sorun devam ediyorsa destek ekibine bildirin
  </Accordion>
</AccordionGroup>

## Ödeme Sorunları

<AccordionGroup>
  <Accordion title="Ödeme İşlemi Başarısız">
    **Belirtiler:**

    * "Ödeme başarısız" mesajı
    * Ödeme sayfası açılmıyor
    * Kredi eklenmiyor

    **Olası Nedenler:**

    * Kart bilgileri hatalı veya süresi dolmuş
    * Kart limiti yetersiz
    * Banka tarafından işlem reddedilmiş
    * Ödeme servisi geçici olarak kullanılamıyor

    **Çözüm:**

    **Adım 1: Kart Bilgilerinizi Kontrol Edin**

    1. Kart numarası, son kullanma tarihi ve CVC'nin doğru olduğundan emin olun
    2. Kartın süresinin dolmamış olduğunu kontrol edin
    3. Kart limitinizin yeterli olduğundan emin olun

    **Adım 2: Farklı Ödeme Yöntemi Deneyin**

    1. Farklı bir kredi veya banka kartı deneyin
    2. Bankanıza başvurarak online işlem izninin açık olduğunu doğrulayın

    **Adım 3: Sorun Devam Ediyorsa**

    1. Destek ekibine bildirin
    2. Hata mesajının ekran görüntüsünü paylaşın
  </Accordion>

  <Accordion title="Kredi Satın Alınamıyor">
    **Belirtiler:**

    * Ödeme sayfası açılmıyor
    * Popup engelleniyor
    * İşlem tamamlanamıyor

    **Çözüm:**

    **Adım 1: Popup Engelleyiciyi Kontrol Edin**

    1. Tarayıcı adres çubuğundaki popup engelleme ikonuna tıklayın
    2. "Bu site için her zaman izin ver" seçeneğini aktif edin

    **Adım 2: Farklı Tarayıcı Deneyin**

    1. Chrome, Firefox veya Safari ile deneyin
    2. Gizli/özel modda (Incognito) deneyin

    **Adım 3: Tarayıcı Cache Temizleyin**

    1. Cache ve çerezleri temizleyin
    2. Tarayıcıyı yeniden başlatın
    3. Sorun devam ediyorsa destek ekibine bildirin
  </Accordion>
</AccordionGroup>

## Dosya Yükleme Sorunları

<AccordionGroup>
  <Accordion title="Bilgi Bankası Dosyası Yüklenemiyor">
    **Belirtiler:**

    * "Dosya yüklenemedi" mesajı
    * Yükleme sırasında hata
    * Zaman aşımı hatası

    **Olası Nedenler:**

    * Dosya boyutu çok büyük
    * Desteklenmeyen dosya formatı
    * İnternet bağlantısı yavaş veya kesik
    * Dosya depolama servisi geçici olarak kullanılamıyor

    **Çözüm:**

    **Adım 1: Dosya Boyutu ve Formatını Kontrol Edin**

    1. Maksimum dosya boyutu: **10 MB**
    2. Desteklenen formatlar: **DOCX**, **TXT**, **CSV**
    3. Dosya boyutu büyükse küçültün veya birden fazla dosyaya bölün

    **Adım 2: Dosya Formatını Doğrulayın**

    1. Dosya uzantısının doğru olduğundan emin olun
    2. Desteklenmeyen formatları (PDF, DOC, XLS vb.) desteklenen formata dönüştürün
    3. Dosyanın bozuk olmadığından emin olun — başka bir uygulamada açıp kontrol edin

    **Adım 3: İnternet Bağlantısını Kontrol Edin**

    1. İnternet bağlantınızın stabil olduğundan emin olun
    2. Büyük dosyalar için kablolu bağlantı tercih edin
    3. Tekrar yüklemeyi deneyin

    **Sorun devam ediyorsa** destek ekibine bildirin.

    <Tip>
      Bilgi bankası dosyalarını yüklemeden önce gereksiz boşlukları ve biçimlendirmeleri temizlemek dosya boyutunu küçültmeye yardımcı olur.
    </Tip>
  </Accordion>
</AccordionGroup>

## Network ve Firewall Sorunları

<AccordionGroup>
  <Accordion title="Timeout Hataları">
    **Belirtiler:**

    * "Request timeout"
    * API calls 30+ saniye sürüyor
    * Aralıklı bağlantı kopmaları

    **Olası Nedenler:**

    * Yavaş internet bağlantısı
    * Firewall API isteklerini engelliyor
    * Proxy ayarları

    **Çözüm:**

    **İnternet Hızı:**

    1. Speedtest yapın (speedtest.net)
    2. Minimum 10 Mbps gerekli
    3. WiFi yerine kablo deneyin

    **Firewall Ayarları:**

    1. Firewall'u geçici olarak devre dışı bırakın
    2. Platform domain'lerini whitelist'e ekleyin:
       * `*.aiagenttr.com`
       * Platform API servis domain'leri

    **Proxy/VPN:**

    1. Proxy kullanmıyorsanız kontrol edin
    2. VPN kapatıp deneyin
    3. Corporate network'teyseniz IT ile görüşün
  </Accordion>

  <Accordion title="CORS Hataları">
    **Belirtiler:**

    * "CORS policy blocked"
    * Browser console'da CORS error
    * API calls başarısız

    **Neden:**

    * Yanlış domain'den istek yapılması
    * Platform CORS ayarları uyumsuzluğu

    **Çözüm:**

    1. **Doğru adresi kullandığınızdan emin olun**: Platform'a `*.aiagenttr.com` üzerinden erişin
    2. **Tarayıcı uzantılarını kontrol edin**: CORS sorunlarına neden olabilecek uzantıları devre dışı bırakın
    3. **VPN kullanıyorsanız kapatıp deneyin**
    4. **Sorun devam ediyorsa** destek ekibine bildirin — teknik ekibimiz inceleyecektir
  </Accordion>
</AccordionGroup>

## İpuçları ve En İyi Uygulamalar

### API Anahtarı Güvenliği

<Tip>
  * **Asla paylaşmayın**: API anahtarınızı kimseyle paylaşmayın
  * **Güvenli saklayın**: API anahtarınızı güvenli bir yerde saklayın
  * **Düzenli yenileyin**: 3-6 ayda bir anahtarınızı yenileyin
  * **Şüpheli durumda iptal edin**: Anahtarınızın ele geçirildiğini düşünüyorsanız hemen iptal edip yenisini oluşturun
</Tip>

### Sorun Takibi

* **Platform durum sayfasını takip edin**: Olası servis kesintileri hakkında bilgi alın
* **Hata pattern'lerini not edin**: Tekrarlayan hatalar varsa destek ekibine bildirin
* **Tarayıcı konsol loglarını kaydedin**: Destek ekibine iletmek için F12 > Console çıktısını saklayın

### Hata Durumunda

* Hata mesajını kaydedin: Tam metni kopyalayın
* Request/Response logları: Network tab'dan inceleyin
* Timestamp not edin: Ne zaman oldu?
* Destek ekibine bildirin: Detaylı bilgi verin

## Sık Sorulan Sorular

<AccordionGroup>
  <Accordion title="API anahtarımı nasıl test edebilirim?">
    Ayarlar > API Keys sayfasında **Test Bağlantısı** butonunu kullanın. Başarılı olursa anahtar çalışıyor demektir.
  </Accordion>

  <Accordion title="API servis kesintisini nasıl anlarım?">
    Servis sağlayıcısının status page adresinden gerçek zamanlı servis durumunu kontrol edebilirsiniz.
  </Accordion>

  <Accordion title="Çağrı durumu veya transkript güncellenmiyor, ne yapmalıyım?">
    1. Sayfayı yenileyip birkaç dakika bekleyin — veriler gecikmeli güncellenebilir
    2. İnternet bağlantınızı kontrol edin
    3. Sorun devam ediyorsa destek ekibine çağrı ID'si ile birlikte bildirin
  </Accordion>

  <Accordion title="&#x22;Rate limit exceeded&#x22; hatası alıyorum">
    API kullanım limitinize ulaştınız. Daha yüksek plana geçin veya çağrı hızınızı azaltın.
  </Accordion>

  <Accordion title="Ödeme sırasında kartım reddedildi, ne yapmalıyım?">
    Kart bilgilerinizin doğru olduğundan ve kartınızın online işlemlere açık olduğundan emin olun. Farklı bir kart deneyebilir veya bankanıza başvurabilirsiniz.
  </Accordion>
</AccordionGroup>

## İlgili Makaleler

<CardGroup cols={2}>
  <Card title="Genel Sorunlar" icon="triangle-exclamation" href="/docs/troubleshooting/general-issues">
    Yaygın platform kullanım sorunları
  </Card>

  <Card title="Çağrı Hataları" icon="phone-slash" href="/docs/troubleshooting/call-errors">
    Çağrı başlatma ve yönetim hataları
  </Card>

  <Card title="Hata Kodları Referansı" icon="code" href="/docs/troubleshooting/error-codes-reference">
    Tüm hata kodları ve anlamları
  </Card>

  <Card title="API Anahtarı Kurulumu" icon="key" href="/docs/getting-started/api-key-setup">
    Platform API anahtarı yapılandırması
  </Card>
</CardGroup>