Genel Bakış
Bu makale, platform üzerinden yapılan çağrılarda karşılaşılabilecek hataları, nedenlerini ve çözüm yöntemlerini detaylı olarak açıklar. Çağrı hataları, agent konfigürasyonundan telefon numarası geçerliliğine kadar birçok farklı nedenden kaynaklanabilir.Çağrı Başlatma Hataları
Çağrı Başlatılamıyor
Çağrı Başlatılamıyor
Belirtiler:
- “Failed to start call” mesajı
- Çağrı durumu hemen
failedoluyor - Kuyrukta bekleyip başlamıyor
- Kredi yetersiz
- API anahtarı geçersiz
- Agent konfigürasyonu hatalı
- Telefon numarası geçersiz
- Dashboard’da kredi bakiyenizi kontrol edin
- Yetersizse kredi satın alın
- Minimum 10 kredi gereklidir
- Ayarlar > API Keys
- Platform API anahtarı geçerli mi kontrol edin
- Test Bağlantısı yapın
- Agent’ın tüm zorunlu alanları dolu mu?
- Test araması yapın
- Agent aktif mi kontrol edin
- E.164 formatında mı? (+905551234567)
- Geçerli bir numara mı?
- DNC listesinde değil mi?
"Insufficient Credits" Hatası
"Insufficient Credits" Hatası
Belirtiler:
- Çağrı başlamadan
failedoluyor - Error message: “Insufficient credits”
- Kampanya duraklatılıyor
- Hesabınızda yeterli kredi yok
- Çağrı maliyeti mevcut krediden fazla
- Kredi Satın Alın:
- Sağ üst köşede Kredi Bakiyesi > Kredi Satın Al
- İhtiyacınız kadar kredi seçin
- Stripe ile ödeme yapın
- Kampanyayı Yeniden Başlatın:
- Kampanyalar sayfasına gidin
- Duraklatılmış kampanyayı bulun
- Başlat butonuna tıklayın
- Auto-recharge özelliğini aktif edin
- Düşük kredi uyarıları kurun
- Düzenli kredi kontrolü yapın
"Invalid Phone Number" Hatası
"Invalid Phone Number" Hatası
Belirtiler:Çözüm:
- Çağrı hemen başarısız oluyor
- Hata: “Invalid phone number format”
- Numara kırmızı işaretleniyor
- Telefon numarası E.164 formatında değil
- Özel karakterler veya boşluklar var
- Ülke kodu eksik
- Manuel Düzeltme:
- Müşteri detayına gidin
- Telefon numarasını düzenleyin
- E.164 formatında kaydedin: +[ülke kodu][numara]
- Toplu Düzeltme:
- Müşteri listesini CSV olarak indirin
- Excel’de formatı düzeltin
- Toplu import yapın
Çağrı Kuyruğa Takılı Kalıyor
Çağrı Kuyruğa Takılı Kalıyor
Belirtiler:
- Çağrı
queueddurumunda saatlerce kalıyor - Hiç
ringing’e geçmiyor - Kampanya ilerlemesi durmuş
- Eş zamanlı çağrı limiti dolmuş
- Orchestrator servisi çalışmıyor
- Call slot sorunu
- Dashboard > Aktif Çağrılar
- Kaç çağrı aktif?
- Eş zamanlı limit kaç? (Ayarlar > Organization)
- Ayarlar > Organization > Concurrency Slots
- Limiti artırın (örn: 5 → 10)
- Kaydet
- Kampanyayı durdurun
- 2 dakika bekleyin
- Tekrar başlatın
Ücretsiz planda maksimum 3 eş zamanlı çağrı yapılabilir.
Çağrı Sırasında Hatalar
Çağrı Erken Sonlanıyor
Çağrı Erken Sonlanıyor
Belirtiler:
- Çağrı 5-10 saniye sonra kendiliğinden kapanıyor
endeddurumuna geçiyor ama konuşma olmadı- Agent konuşmaya başlamadan bitiyor
- Agent ilk mesajını üretemiyor
- Timeout çok kısa ayarlanmış
- Müşteri hemen kapatıyor
- Agent ayarlarına gidin
- İlk Mesaj Modu kontrol edin:
- “Agent ilk konuşur” seçili mi?
- Karşılama mesajı var mı?
- Sistem Talimatı:
- Çok uzun değil mi? (max 2000 karakter)
- Açık ve net mi?
- Agent > Gelişmiş Ayarlar
- Response timeout’u artırın (30s → 60s)
- Çağrı detayına gidin
- Transkript var mı kontrol edin
- Konuşma hiç başladı mı?
"No Answer" - Cevapsız Çağrılar
"No Answer" - Cevapsız Çağrılar
Belirtiler:
- Çağrı
ringingdurumunda 30 saniye kalıyor - Sonra
failed-no-answeroluyor - Müşteri cevaplamıyor
- Müşteri telefona bakmıyor
- Numara yanlış
- Müşteri meşgul
- Tek bir çağrı için: Normal, müşteri cevaplamamış olabilir
- %50+ çağrı için: Sorun var
- Telefon numaraları yanlış olabilir
- Arama saati uygun değil
- DNC listesinde olabilir
- 09:00-12:00 ve 14:00-17:00 en verimli saatler
- Öğle arası (12:00-14:00) düşük cevaplama
- Akşam 19:00’dan sonra düşük cevaplama
- Rastgele 10 numara seçin
- Manuel arayıp doğrulayın
- Geçersizleri silin
- Kampanya ayarlarında retry sayısını artırın
- Farklı saatlerde tekrar arama yapılsın
- 2-3 deneme yeterlidir
Müşteri Agent'ı Anlamıyor
Müşteri Agent'ı Anlamıyor
Belirtiler:
- Transkript’te anlama sorunları
- Müşteri “Ne dedin?” diyor
- Çağrı uzuyor ve başarısız oluyor
- Agent sesi net değil
- Konuşma hızı çok yüksek/düşük
- Teknik terimler kullanılıyor
- Agent > Ses Ayarları (gelecek sürümlerde)
- Konuşma hızını ayarlayın
- Farklı ses modelleri deneyin
- “Yavaş ve açık konuş” ekleyin
- “Kısa cümleler kur” talimatı verin
- Teknik terimler yerine basit Türkçe kullan
Agent Yönlendirme Yapamıyor
Agent Yönlendirme Yapamıyor
Belirtiler:
- Yönlendirme mesajı okunuyor ama bağlantı gerçekleşmiyor
forwardingdurumundanfailedoluyor- “Transfer failed” hatası
- Yönlendirme numarası yanlış
- SIP URI hatalı
- Hedef numara cevap vermiyor
- Agent > Yönlendirme ve Eskalasyon
- Hedef tipi doğru mu? (Telefon / SIP)
- Numara/URI formatı doğru mu?
- E.164 format: +905551234567
- Geçerli bir numara olmalı
- Cevaplıyor olmalı
- Format: sip:[email protected]
- SIP trunk ayarları yapılmış olmalı
- Provider credentials doğru olmalı
- Manuel olarak hedef numarayı arayın
- Cevap veriyor mu?
- Erişilebilir mi?
Ses Kalitesi Kötü
Ses Kalitesi Kötü
Belirtiler:
- Müşteri agent’ı duymuyor
- Ses kesilmeler var
- Echo (yankı) problemi
- Network bağlantısı zayıf (müşteri tarafı)
- AI servis provider sorunu
- SIP trunk kalite sorunu
- Servis sağlayıcısı kontrol paneli > Call Quality Metrics
- Kalite raporlarını inceleyin
- Provider değiştirmeyi düşünün (Twilio, Vonage)
- SIP provider’ınızın kalite SLA’sını kontrol edin
- Alternatif provider deneyin
- Dedicated line kullanımı değerlendirin
Ses kalitesi genellikle müşteri tarafındaki internet bağlantısından kaynaklanır. Platform tarafında yapılabilecek sınırlı şey vardır.
Transkript ve Kayıt Sorunları
Transkript Görünmüyor
Transkript Görünmüyor
Belirtiler:
- Çağrı tamamlandı ama transkript yok
- “Transkript mevcut değil” mesajı
- Konuşma kayıtları boş
- Webhook events alınmadı
- Transkript henüz işlenmedi
- Konuşma gerçekleşmedi (erken sonlanma)
- Transkript işlenmesi 1-2 dakika sürebilir
- Sayfayı yenileyin
- Çağrı gerçekten tamamlandı mı?
- Süre en az 10 saniye mi?
- Konuşma gerçekleşti mi?
- API webhook’ları alınıyor mu?
- Backend logs kontrol edin
- Webhook signature doğru mu?
Kayıt Dosyası İndirilemiyor
Kayıt Dosyası İndirilemiyor
Belirtiler:
- “Kayıt mevcut değil”
- İndirme butonu pasif
- 404 Not Found hatası
- Kayıt henüz işlenmedi
- S3 erişim sorunu
- API recording devre dışı
- Çağrı bittikten 5-10 dakika sonra hazır olur
- Uzun çağrılar daha fazla sürebilir
- Servis sağlayıcısı kontrol paneli > Settings > Recordings
- Recording enabled mi kontrol edin
- Storage provider (S3) ayarları doğru mu?
- AWS Console > S3
- Bucket permissions kontrol edin
- Dosya var mı bakın
Kampanya Çağrı Hataları
Kampanya Çağrıları Başlamıyor
Kampanya Çağrıları Başlamıyor
Belirtiler:
- Kampanya “aktif” ama hiç çağrı yapılmıyor
- Call tasks oluşturuluyor ama çalışmıyor
- Kuyruk dolu ama işlem yok
- Kampanya zamanlaması henüz başlamadı
- Agent seçilmemiş
- Call list boş
- Kampanya detayına gidin
- Başlangıç tarihi/saati geçmiş mi?
- Bitiş tarihi geçmemiş mi?
- Kampanyada agent seçili mi?
- Agent aktif mi?
- Agent test edildi mi?
- Kampanya > Call List
- Müşteri sayısı > 0 mı?
- Telefon numaraları geçerli mi?
Kampanya Çok Yavaş İlerliyor
Kampanya Çok Yavaş İlerliyor
Belirtiler:
- Saatte sadece 10-20 çağrı yapılıyor
- Hedef 100+ çağrı ama çok yavaş
- Kuyrukta bekleyen çok fazla
- Eş zamanlı çağrı limiti düşük
- Call rate limit aktif
- Orchestrator yavaş çalışıyor
- Ayarlar > Organization > Concurrency Slots
- 3 → 10 veya daha fazla yapın
- Plan upgrade gerekebilir
- Kampanya > Advanced Settings (gelecek)
- Calls per hour limitini kaldırın veya artırın
- Backend sistemsel bir sorun varsa destek ekibi ile görüşün
Billing ve Maliyet Hataları
Çağrı Maliyeti Beklenenden Yüksek
Çağrı Maliyeti Beklenenden Yüksek
Belirtiler:
- Kredi hızla tükeniyor
- Çağrı başı maliyet yüksek görünüyor
- Fatura beklenenden fazla
- Çağrılar çok uzun sürüyor
- Başarısız çağrılar da ücretlendiriliyor
- Yönlendirmeler ekstra maliyet oluşturuyor
- Çağrı İstatistikleri > Ortalama Süre
- 3+ dakika uzun sayılır
- Agent talimatlarını kısaltın
- Bağlanmayan çağrılar için minimum ücret var
- %50+ başarısızlık oranı maliyeti artırır
- Telefon numaralarını temizleyin
- Her yönlendirme ekstra dakika olarak sayılır
- Gereksiz yönlendirmeleri azaltın
- Agent capability’sini artırın
- Ortalama çağrı süresini 1-2 dakikaya indirin
- Başarısız çağrı oranını %30 altına çekin
- Yönlendirme oranını %10 altında tutun
İpuçları ve En İyi Uygulamalar
Çağrı Kalitesi İyileştirme
Hata Önleme
- Telefon numarası doğrulama: Toplu import öncesi doğrulayın
- Kredi takibi: Düşük kredi uyarısı kurun
- Agent test: Yeni agent’ları test araması ile deneyin
- Kampanya test: Küçük listeler ile başlayın
Monitoring
- Başarı oranını izleyin: %70 altına düşerse araştırın
- Hata pattern’leri: Hangi hatalar tekrarlıyor?
- Çağrı süresi trendi: Artıyor mu azalıyor mu?
Sık Sorulan Sorular
Başarısız çağrılar ücretlendirilir mi?
Başarısız çağrılar ücretlendirilir mi?
Evet, bağlantı denemesi için minimum ücret kesilir. Ancak tamamlanan çağrılara göre çok düşüktür.
"No answer" oranım çok yüksek, ne yapmalıyım?
"No answer" oranım çok yüksek, ne yapmalıyım?
Arama saatlerinizi optimize edin, telefon numaralarını doğrulayın ve farklı zamanlarda retry yapın.
Agent transkriptleri neden geç yükleniyor?
Agent transkriptleri neden geç yükleniyor?
Transkript işleme 1-2 dakika sürer. Uzun çağrılar daha fazla sürebilir.
Kampanyam neden durdu?
Kampanyam neden durdu?
Kredi yetersizliği, kampanya bitiş tarihi veya manual duraklama olabilir. Kampanya detaylarını kontrol edin.
Yönlendirme her zaman başarısız oluyor
Yönlendirme her zaman başarısız oluyor
Hedef numaranın doğru, erişilebilir ve cevap veriyor olduğundan emin olun.
