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ı
"API Key Geçersiz veya Boş" uyarısı
"API Key Geçersiz veya Boş" uyarısı
Belirtiler:
- Agent oluştururken, arama başlatırken ya da Santral’da numara/trunk eklerken API Key Geçersiz veya Boş penceresi çıkar
- Kontrol Paneli’nde AI sağlayıcı anahtarı doğrulanmadı uyarısı görünür
- Uyarıdaki Ayarlara Git düğmesine (ya da Kontrol Paneli’ndeki uyarı satırına) basın; Platform API Anahtarı ekranı açılır
- Bağlantı Durumu’na bakın; kayıtlı anahtar varsa Bağlantıyı Test Et’e basın
- Test başarısızsa doğru anahtarı API Anahtarı alanına girip Kaydet’e basın
- Bağlantı Durumu Bağlı olmalı
- Kontrol Paneli’ndeki uyarı kalkmalı
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
- Platform API Anahtarı ekranında Bağlantıyı Test Et’e basın (ekrana Kontrol Paneli’ndeki uyarıdan ulaşılır)
- Başarılı olursa anahtar çalışıyor
- Başarısız olursa doğru anahtarı yeniden girin
- İ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
- Karşılama mesajı ve sistem talimatının dolu olduğundan emin olun
- Test araması yapın
E.164formatında olmalı: +905551234567- Geçerli bir numara olduğundan emin olun
- İletişim Yasağı Listesi’nde 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?
Platform API Anahtarı ekranında Bağlantıyı Test Et’e basın. Ekrana Kontrol Paneli’ndeki AI sağlayıcı anahtarı doğrulanmadı uyarısından ya da API Key Geçersiz veya Boş penceresindeki Ayarlara Git’ten ulaşılır.
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
Kısa sürede çok fazla istek gönderildi. Birkaç dakika bekleyip tekrar deneyin; sorun sürerse destek ekibimize bildirin.
Ö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.
İlgili Makaleler
Genel Sorunlar
Yaygın platform kullanım sorunları
Çağrı Hataları
Çağrı başlatma ve yönetim hataları
Hata Kodları Referansı
Tüm hata kodları ve anlamları
Platform API Anahtarı
Platform API anahtarı yapılandırması