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ı
"Geçersiz API Anahtarı" Hatası
"Geçersiz API Anahtarı" Hatası
Belirtiler:
- “API key is invalid” mesajı
- Agent oluşturulamıyor
- Çağrı başlatılamıyor
- Dashboard’da ⚠️ Bağlantı Sorunu göstergesi
- API anahtarı yanlış girilmiş
- API anahtarı silinmiş veya iptal edilmiş
- API anahtarı süresi dolmuş
- Yanlış environment (test/production) anahtarı
- Sol menüden Ayarlar > API Keys sayfasına gidin
- Platform API anahtarınızı görüntüleyin
- Anahtarın tam olarak doğru olduğundan emin olun
- API servis sağlayıcısı kontrol paneline gidin
- API Keys bölümüne gidin
- Yeni bir API anahtarı oluşturun
- Anahtarı kopyalayın
- Platform Ayarlar > API Keys
- Eski anahtarı silin
- Yeni API Key Ekle butonuna tıklayın
- API anahtarını yapıştırın
- Kaydet ve Test Bağlantısı yapın
- Dashboard’da AI Entegrasyon Durumu ✅ Bağlı olmalı
- Test agent oluşturabilmelisiniz
API Anahtarı Görünmüyor
API Anahtarı Görünmüyor
Belirtiler:
- API Keys sayfası boş
- “Henüz API anahtarı eklenmedi” mesajı
- Agent oluştur butonu pasif
- İlk kurulum tamamlanmamış
- API anahtarı hiç eklenmemiş
- İlk Kurulum Wizard’ı Tamamlayın:
- Ayarlar > Setup sayfasına gidin
- Adım adım kurulum talimatlarını izleyin
- Manuel API Key Ekleme:
- Ayarlar > API Keys > Yeni API Key Ekle
- API anahtarınızı yapıştırın
- Kaydedin
"API Quota Exceeded" Hatası
"API Quota Exceeded" Hatası
Belirtiler:
- “API request limit exceeded” mesajı
- Çağrılar başlamıyor
- 429 Too Many Requests hatası
- API servis planı limitine ulaşıldı
- Çok fazla concurrent request
- API Plan Kontrolü:
- Servis sağlayıcısı kontrol panelinde plan limitlerinizi kontrol edin
- Kullanım istatistiklerinizi görün
- Plan Yükseltme:
- Daha yüksek plana geçin
- Daha fazla API call hakkı satın alın
- Rate Limiting Ayarı:
- Platform ayarlarından eş zamanlı çağrı limitini düşürün
- Kampanyaları daha yavaş çalıştırın
AI Servis Entegrasyon Sorunları
Agent Oluşturulamıyor
Agent Oluşturulamıyor
Belirtiler:
- “Agent oluşturulamadı” hatası
- API bağlantı hatası
- Timeout error
- AI servisleri çalışmıyor
- API anahtarı geçersiz
- Network bağlantı sorunu
- Servis sağlayıcısı durum sayfasını kontrol edin
- Servisler çalışıyor mu bakın
- Maintenance window olabilir
- Ayarlar > API Keys > Test Bağlantısı
- Başarılı olursa API key çalışıyor
- Başarısız olursa anahtarı yenileyin
- İnternet bağlantınızı kontrol edin
- Firewall/proxy ayarlarını kontrol edin
- VPN kullanıyorsanız kapatıp deneyin
- Incognito/private mode deneyin
- Farklı cihazdan deneyin
Çağrı Başlatılamıyor - API Error
Çağrı Başlatılamıyor - API Error
Belirtiler:
- “Failed to start call” mesajı
- API error
- Call status: failed immediately
- Agent konfigürasyonu hatalı
- Telefon numarası geçersiz
- Provider credentials eksik
- Agent ayarlarına gidin
- Tüm zorunlu alanların dolu olduğundan emin olun:
- Agent adı
- İlk mesaj modu
- Sistem talimatı
- Test araması yapın
E.164formatında olmalı: +905551234567- Geçerli bir numara olduğundan emin olun
- DNC listesinde olmamalı
- Servis sağlayıcısı kontrol panelinde telefon numarası bağlantınızı kontrol edin
- SIP trunk ayarlarını doğrulayın
- Telefon servisi credentials güncel mi bakın
Webhook Hataları
Webhook Hataları
Belirtiler:
- Call events alınamıyor
- Transcript görünmüyor
- Call status güncellenmiyor
- Webhook signature doğrulaması başarısız
- Webhook URL’i yanlış
- Webhook secret yanlış
- İnternet bağlantınızın stabil olduğundan emin olun
- Sayfayı yenileyin ve çağrı durumunu tekrar kontrol edin
- Çağrı listesinden ilgili çağrıya tıklayın
- Çağrı durumu ve transkript bilgilerini kontrol edin
- Birkaç dakika bekleyip tekrar kontrol edin — veriler gecikmeli yüklenebilir
- Destek ekibine bildirin
- Etkilenen çağrı ID’sini ve tarih/saat bilgisini paylaşın
Kimlik Doğrulama Sorunları
"Authentication Failed" Hatası
"Authentication Failed" Hatası
Belirtiler:
- Giriş yapılamıyor
- Oturum otomatik kapanıyor
- 401 Unauthorized hatası
- Oturum süresi dolmuş
- Tarayıcı çerezleri engellenmiş
- Kimlik doğrulama servisi geçici olarak kullanılamıyor
- Çıkış yapın ve tekrar giriş yapın
- “Beni hatırla” seçeneğini işaretleyin
- Tarayıcı çerezlerinin aktif olduğundan emin olun
- Tarayıcı cache ve çerezlerini temizleyin
- Gizli/özel modda deneyin
- Chrome, Firefox veya Safari ile deneyin
- Tarayıcınızın güncel olduğundan emin olun
"Oturum Geçersiz" Hatası
"Oturum Geçersiz" Hatası
Belirtiler:
- API istekleri 401 hatası dönüyor
- Sürekli giriş ekranına yönlendirme
- “Oturum doğrulaması başarısız” mesajı
- Oturum süresi dolmuş
- Bilgisayar saat ayarı yanlış
- Tarayıcı çerezleri bozulmuş
- Bilgisayarınızın saat ayarını kontrol edin
- Otomatik saat ayarını aktif edin
- Saat diliminin doğru olduğundan emin olun
- Tarayıcı ayarları > Gizlilik > Tarama verilerini temizle
- Çerezleri ve cache’i temizleyin
- Tarayıcıyı yeniden başlatın
- Çıkış yapıp tekrar giriş yapın
- Sorun devam ediyorsa destek ekibine bildirin
Ödeme Sorunları
Ödeme İşlemi Başarısız
Ödeme İşlemi Başarısız
Belirtiler:
- “Ödeme başarısız” mesajı
- Ödeme sayfası açılmıyor
- Kredi eklenmiyor
- Kart bilgileri hatalı veya süresi dolmuş
- Kart limiti yetersiz
- Banka tarafından işlem reddedilmiş
- Ödeme servisi geçici olarak kullanılamıyor
- Kart numarası, son kullanma tarihi ve CVC’nin doğru olduğundan emin olun
- Kartın süresinin dolmamış olduğunu kontrol edin
- Kart limitinizin yeterli olduğundan emin olun
- Farklı bir kredi veya banka kartı deneyin
- Bankanıza başvurarak online işlem izninin açık olduğunu doğrulayın
- Destek ekibine bildirin
- Hata mesajının ekran görüntüsünü paylaşın
Kredi Satın Alınamıyor
Kredi Satın Alınamıyor
Belirtiler:
- Ödeme sayfası açılmıyor
- Popup engelleniyor
- İşlem tamamlanamıyor
- Tarayıcı adres çubuğundaki popup engelleme ikonuna tıklayın
- “Bu site için her zaman izin ver” seçeneğini aktif edin
- Chrome, Firefox veya Safari ile deneyin
- Gizli/özel modda (Incognito) deneyin
- Cache ve çerezleri temizleyin
- Tarayıcıyı yeniden başlatın
- Sorun devam ediyorsa destek ekibine bildirin
Dosya Yükleme Sorunları
Bilgi Bankası Dosyası Yüklenemiyor
Bilgi Bankası Dosyası Yüklenemiyor
Belirtiler:
- “Dosya yüklenemedi” mesajı
- Yükleme sırasında hata
- Zaman aşımı hatası
- 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
- Maksimum dosya boyutu: 10 MB
- Desteklenen formatlar: DOCX, TXT, CSV
- Dosya boyutu büyükse küçültün veya birden fazla dosyaya bölün
- Dosya uzantısının doğru olduğundan emin olun
- Desteklenmeyen formatları (PDF, DOC, XLS vb.) desteklenen formata dönüştürün
- Dosyanın bozuk olmadığından emin olun — başka bir uygulamada açıp kontrol edin
- İnternet bağlantınızın stabil olduğundan emin olun
- Büyük dosyalar için kablolu bağlantı tercih edin
- Tekrar yüklemeyi deneyin
Network ve Firewall Sorunları
Timeout Hataları
Timeout Hataları
Belirtiler:
- “Request timeout”
- API calls 30+ saniye sürüyor
- Aralıklı bağlantı kopmaları
- Yavaş internet bağlantısı
- Firewall API isteklerini engelliyor
- Proxy ayarları
- Speedtest yapın (speedtest.net)
- Minimum 10 Mbps gerekli
- WiFi yerine kablo deneyin
- Firewall’u geçici olarak devre dışı bırakın
- Platform domain’lerini whitelist’e ekleyin:
*.aiagenttr.com- Platform API servis domain’leri
- Proxy kullanmıyorsanız kontrol edin
- VPN kapatıp deneyin
- Corporate network’teyseniz IT ile görüşün
CORS Hataları
CORS Hataları
Belirtiler:
- “CORS policy blocked”
- Browser console’da CORS error
- API calls başarısız
- Yanlış domain’den istek yapılması
- Platform CORS ayarları uyumsuzluğu
- Doğru adresi kullandığınızdan emin olun: Platform’a
*.aiagenttr.comüzerinden erişin - Tarayıcı uzantılarını kontrol edin: CORS sorunlarına neden olabilecek uzantıları devre dışı bırakın
- VPN kullanıyorsanız kapatıp deneyin
- Sorun devam ediyorsa destek ekibine bildirin — teknik ekibimiz inceleyecektir
İpuçları ve En İyi Uygulamalar
API Anahtarı Güvenliği
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
API anahtarımı nasıl test edebilirim?
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.
API servis kesintisini nasıl anlarım?
API servis kesintisini nasıl anlarım?
Servis sağlayıcısının status page adresinden gerçek zamanlı servis durumunu kontrol edebilirsiniz.
Çağrı durumu veya transkript güncellenmiyor, ne yapmalıyım?
Çağrı durumu veya transkript güncellenmiyor, ne yapmalıyım?
- Sayfayı yenileyip birkaç dakika bekleyin — veriler gecikmeli güncellenebilir
- İnternet bağlantınızı kontrol edin
- Sorun devam ediyorsa destek ekibine çağrı ID’si ile birlikte bildirin
"Rate limit exceeded" hatası alıyorum
"Rate limit exceeded" 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.
Ödeme sırasında kartım reddedildi, ne yapmalıyım?
Ö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.