Skip to main content

​
Genel Bakış

Bu dokümante tüm platform hata kodlarını, anlamlarını ve çözüm yöntemlerini içerir. Hata kodlarını hızlıca arayıp ne anlama geldiğini ve nasıl çözeceğinizi öğrenebilirsiniz.

​
HTTP Durum Kodları

​
2xx - Başarılı

KodAnlamAçıklama
200OKİstek başarılı
201CreatedKayıt oluşturuldu
204No Contentİstek başarılı, içerik yok

​
4xx - İstemci Hataları

Anlam: İstek formatı hatalı veya eksik bilgi var.Yaygın Nedenler:
  • Zorunlu alan eksik
  • Veri format hatası
  • Geçersiz değer
Örnek Hatalar:
"Agent name is required"
"Invalid phone number format"
"Campaign start date must be in future"
Çözüm:
  1. Hata mesajını okuyun
  2. Belirtilen alanı düzeltin
  3. Tekrar deneyin
Anlam: Kimlik doğrulama başarısız.Yaygın Nedenler:
  • Oturum süresi dolmuş
  • Token geçersiz
  • Giriş yapılmamış
Çözüm:
  1. Çıkış yapın
  2. Tekrar giriş yapın
  3. Tarayıcı cache temizleyin
Anlam: İşlem için yetkiniz yok.Yaygın Nedenler:
  • RBAC - User rolüyle admin işlemi yapılıyor
  • Organizasyona ait olmayan kaynaklara erişim
  • Devre dışı bırakılmış özellik
Çözüm:
  1. Kullanıcı rolünüzü kontrol edin (Admin/User)
  2. Organizasyon admin’inden yetki isteyin
  3. Doğru organizasyonda olduğunuzdan emin olun
Anlam: İstenen kaynak bulunamadı.Yaygın Nedenler:
  • Kayıt silinmiş
  • Yanlış ID kullanılmış
  • URL hatalı
Çözüm:
  1. ID’yi kontrol edin
  2. Kaydın var olduğundan emin olun
  3. Sayfayı yenileyin
Anlam: İşlem bir çakışmaya neden oluyor.Yaygın Nedenler:
  • Aynı isimde kayıt zaten var
  • Duplicate entry
  • Conflicting state
Örnek:
"Agent with name 'Customer Service' already exists"
"Phone number is already assigned"
Çözüm:
  1. Benzersiz bir isim kullanın
  2. Mevcut kaydı güncelleyin
  3. Çakışan kaydı silin
Anlam: İstek anlaşıldı ama işlenemedi.Yaygın Nedenler:
  • Validasyon hatası
  • İş kuralı ihlali
  • Bağımlılık sorunu
Örnek:
"Cannot delete agent: active campaigns exist"
"Minimum credit purchase is 100"
Çözüm:
  1. Hata mesajını dikkatlice okuyun
  2. Bağımlılıkları çözün
  3. Validasyon kurallarına uyun
Anlam: Çok fazla istek gönderildi (rate limiting).Yaygın Nedenler:
  • API quota aşıldı
  • API servis plan limiti
  • Spam koruması
Çözüm:
  1. 1 dakika bekleyin
  2. İstek hızınızı azaltın
  3. Plan upgrade yapın

​
5xx - Sunucu Hataları

Anlam: Sunucu tarafında beklenmeyen hata oluştu.Ne Yapmalı:
  1. Sayfayı yenileyin
  2. 5 dakika bekleyip tekrar deneyin
  3. Problem devam ediyorsa destek ekibine bildirin
Anlam: Gateway hatası, upstream servis cevap vermiyor.Yaygın Nedenler:
  • AI servisi down
  • Backend yeniden başlatılıyor
  • Network sorunu
Çözüm:
  1. 2-3 dakika bekleyin
  2. Servis status sayfalarını kontrol edin
  3. Tekrar deneyin
Anlam: Servis geçici olarak kullanılamıyor.Yaygın Nedenler:
  • Maintenance mode
  • Overload
  • Deployment
Çözüm:
  1. Status sayfasını kontrol edin
  2. 10-15 dakika bekleyin
  3. Alternatif zaman diliminde deneyin
Anlam: İstek zaman aşımına uğradı.Yaygın Nedenler:
  • Yavaş backend işlem
  • Database query timeout
  • External API timeout
Çözüm:
  1. İşlemi küçük parçalara bölün
  2. Daha az veri ile deneyin
  3. İşlemi tekrarlayın

​
Platform-Specific Hata Kodları

​
Çağrı Hataları

Anlam: Çağrı başlatmak için yeterli kredi yok.Çözüm:
  1. Kredi satın alın
  2. Kampanyayı yeniden başlatın
Anlam: Telefon numarası geçersiz.Çözüm:
  1. E.164 format kullanın: +905551234567
  2. Numarayı doğrulayın
Anlam: Belirtilen agent bulunamadı.Çözüm:
  1. Agent ID’yi kontrol edin
  2. Agent silinmemiş mi bakın
  3. Doğru organizasyonda mısınız?
Anlam: Eş zamanlı çağrı limitine ulaşıldı.Çözüm:
  1. Aktif çağrıların bitmesini bekleyin
  2. Concurrency limit’i artırın (Ayarlar)
  3. Plan upgrade yapın
Anlam: Numara Do Not Call listesinde.Çözüm:
  1. DNC listesinden kaldırın
  2. Müşteri izni aldıysanız listeden çıkarın
Anlam: Çağrı kuyruğu dolu.Çözüm:
  1. Kampanyayı duraklatın
  2. Kuyruktaki çağrıların işlenmesini bekleyin
  3. Tekrar başlatın

​
Agent Hataları

Anlam: Agent konfigürasyonu hatalı.Çözüm:
  1. Tüm zorunlu alanları doldurun
  2. Sistem talimatını kontrol edin
  3. İlk mesaj modunu ayarlayın
Anlam: AI servisinde agent oluşturulamadı.Çözüm:
  1. Platform API anahtarını kontrol edin
  2. AI servis durumunu kontrol edin
  3. Tekrar deneyin
Anlam: Maksimum bilgi bankası sayısına ulaşıldı.Çözüm:
  1. Eski/kullanılmayan bilgi bankalarını silin
  2. Plan upgrade yapın

​
API Key Hataları

Anlam: API anahtarı geçersiz.Çözüm:
  1. Yeni API anahtarı alın
  2. Platform’da güncelleyin
  3. Test bağlantısı yapın
Anlam: API anahtarı süresi dolmuş.Çözüm:
  1. Servis sağlayıcısı kontrol panelinden yeni anahtar oluşturun
  2. Platform’da güncelleyin
Anlam: API kullanım kotası aşıldı.Çözüm:
  1. API servis planınızı yükseltin
  2. Kullanımı azaltın
  3. Billing cycle yenilenmesini bekleyin

​
Billing Hataları

Anlam: Ödeme başarısız oldu.Çözüm:
  1. Kart bilgilerini kontrol edin
  2. Kart limitini kontrol edin
  3. Farklı kart deneyin
Anlam: Ödeme yöntemi geçersiz.Çözüm:
  1. Stripe’a kayıtlı kart kullanın
  2. Test modda test kartı kullanın
  3. Kartı yeniden ekleyin
Anlam: Abonelik aktif değil.Çözüm:
  1. Aboneliği yeniden başlatın
  2. Ödeme yapın
  3. Plan seçin

​
File Upload Hataları

Anlam: Dosya boyutu çok büyük.Limit: 10 MBÇözüm:
  1. Dosyayı küçültün
  2. Compress yapın
  3. Birden fazla dosyaya bölün
Anlam: Dosya tipi desteklenmiyor.Desteklenen: PDF, TXT, DOC, DOCXÇözüm:
  1. Desteklenen formata çevirin
  2. Farklı dosya kullanın
Anlam: Dosya yüklenemedi.Çözüm:
  1. İnternet bağlantınızı kontrol edin
  2. Tekrar deneyin
  3. Farklı tarayıcı kullanın

​
Campaign Hataları

Anlam: Kampanyada müşteri yok.Çözüm:
  1. Call list’e müşteri ekleyin
  2. CSV import yapın
  3. Manuel müşteri ekleyin
Anlam: Kampanya zamanlaması geçersiz.Çözüm:
  1. Başlangıç tarihi gelecekte olmalı
  2. Bitiş tarihi başlangıçtan sonra olmalı
  3. Geçerli saat aralığı seçin
Anlam: Kampanyaya agent atanmamış.Çözüm:
  1. Agent seçin
  2. Agent’ın aktif olduğundan emin olun

​
Hata Çözüm Akış Şeması

Hata Aldım
    ↓
HTTP Kodu Nedir?
    ↓
├─ 4xx → Kullanıcı Hatası
│   ├─ 401 → Tekrar giriş yap
│   ├─ 403 → Yetki kontrolü
│   ├─ 404 → Kayıt kontrolü
│   └─ 422 → Validasyon kontrolü
│
├─ 5xx → Sunucu Hatası
│   ├─ 500 → Bekle ve tekrar dene
│   ├─ 502 → Servis status kontrol
│   └─ 503 → Maintenance olabilir
│
└─ Platform Kodu (CALL_001, vb.)
    └─ Bu dokümanda ara

​
Hata Loglarını Okuma

​
Tarayıcı Console

Nasıl Açılır:
  • Chrome/Edge: F12 veya Ctrl+Shift+I
  • Firefox: F12
  • Safari: Cmd+Option+I
Ne Aranır:
  • Kırmızı hatalar (errors)
  • Network tab > Failed requests
  • Status code ve response
Örnek: 
POST /api/v1/calls
Status: 422
Response: {"error": "CALL_002", "message": "Invalid phone number"}

​
Backend Logs (Admin)

Sadece admin kullanıcılar backend logs’a erişebilir:
1

Orchestrator Loglarına Gidin

Orchestrator > Call Logs
2

Reconciler Loglarını Kontrol Edin

Reconciler > Logs
3

Hata Filtresi Uygulayın

Hata filtresi uygulayın
4

Timestamp ve Error Message Görüntüleyin

Timestamp ve error message görün

​
İpuçları

​
Hata Aldığınızda

1

Hata Kodunu Not Edin

Screenshot alın
2

Hata Mesajını Okuyun

Ne diyor?
3

Bu Dokümana Bakın

Kod anlamı nedir?
4

Çözümü Uygulayın

Adım adım ilerleyin
5

Çözülmezse Destek

Detaylı bilgi verin

​
Destek Bildirimi

Hata raporu oluştururken: Gerekli Bilgiler:
  • Hata kodu (CALL_001, vb.)
  • Tam hata mesajı
  • Ne yapmaya çalışıyordunuz?
  • Tekrar edebilir misiniz?
  • Screenshot
  • Tarayıcı console çıktısı
Tarayıcı console hatası örneği
Ekran görüntüsü eklenecek: Tarayıcı console’da hata mesajı görünümü

​
Sık Sorulan Sorular

Sunucu tarafında bir sorun var. 10-15 dakika bekleyip tekrar deneyin. Problem devam ediyorsa destek ekibine bildirin.
Oturumunuz güncel olmayabilir. Çıkış yapıp tekrar giriş yapın.
E.164 formatında olmalı: +[ülke kodu][numara]. Örnek: +905551234567
Bu dokümanda yoksa yeni bir hata olabilir. Destek ekibine bildirin.

​
İlgili Makaleler

Genel Sorunlar

Yaygın platform kullanım sorunları

API Bağlantı Sorunları

API ve servis bağlantı problemleri

Çağrı Hataları

Çağrı başlatma ve yönetim hataları

API Anahtarı Kurulumu

Platform API anahtarı yapılandırması