Sorun Giderme

Bu kılavuz, Hanc.AI platformundaki yaygın sorunları çözmenize yardımcı olur. Sorununuzu aşağıda bulun ve çözüm adımlarını izleyin.

Hızlı Tanı

Belirti	Olası Neden	Çözüm Bölümü
Oturum açılamıyor	Hesap/parola sorunu	Hesap Sorunları
Ajan yanıt vermiyor	Yapılandırma sorunu	Ajan Sorunları
Yanlış yanıtlar	Bilgi tabanı sorunu	Bilgi Tabanı Sorunları
Çağrılar bağlanmıyor	Telefon kurulum sorunu	Telefon Sorunları
Kötü ses kalitesi	Ağ/ayar sorunu	Ses Sorunları
Widget yüklenmiyor	Alan adı/tarayıcı sorunu	Widget Sorunları
Çağrı "Kredi Yok" ile kesiliyor	Krediler tükendi	Kredi Sorunları
Özellik çalışmıyor	Plan sınırlaması	Faturalama Sorunları

---

Hesap Sorunları

Oturum Açılamıyor

Belirtiler:

• Giriş sayfası hata gösteriyor
• Parola kabul edilmiyor
• Hesap kilitli gibi görünüyor

Çözümler:

1. E-posta/parolayı kontrol edin

   • Doğru e-posta adresini sağlayın
   • Caps lock'u kontrol edin
   • Parolayı kopyala-yapıştır deneyin

2. Parolayı sıfırlayın

   • "Parolamı Unuttum"a tıklayın
   • E-postayı kontrol edin (spam dahil)
   • 1 saat içinde sıfırlama bağlantısına tıklayın
   • Yeni parola oluşturun

3. Tarayıcı verilerini temizleyin

   • hanc.ai için çerezleri temizleyin
   • Önbelleği temizleyin
   • Gizli/özel modu deneyin

4. Farklı tarayıcı deneyin

   • Chrome, Firefox, Safari veya Edge
   • Tarayıcı uzantılarını devre dışı bırakın

Hala takıldınız mı? support@hanc.ai ile iletişime geçin

Hesap Oluşturulamıyor

Belirtiler:

• Kayıt başarısız oluyor
• "E-posta zaten mevcut" hatası
• Doğrulama kodu alınmadı

Çözümler:

1. E-posta zaten kayıtlı

   • Mevcut hesabı kurtarmak için "Parolamı Unuttum"u deneyin
   • Farklı e-posta kullanın

2. Telefon doğrulaması başarısız

   • Doğru ülke kodunu sağlayın
   • Numarayı baştaki sıfır olmadan girin
   • Yeni kod istemeden önce 60 saniye bekleyin
   • Farklı telefon numarası deneyin

3. Sayfa hataları

   • Yenileyin ve tekrar deneyin
   • Tarayıcı önbelleğini temizleyin
   • Farklı tarayıcı deneyin

---

Ajan Sorunları

Ajan Yanıt Vermiyor

Belirtiler:

• Test çağrısı bağlanıyor ancak ajan sessiz
• Ajan karşılama konuşmuyor
• Sonsuz yükleme

Tanı adımları:

1. Ajan durumunun ACTIVE olduğunu kontrol edin (INACTIVE veya DELETED değil)
2. İlk mesajın (karşılama) ayarlandığını doğrulayın
3. Komut dosyasının boş olmadığını kontrol edin
4. Bilgi tabanının bağlı olduğunu kontrol edin (varsa)
5. Mevcut krediniz olduğunu kontrol edin

Çözümler:

1. Ajan durumunu kontrol edin

   • AI Sesli Ajanlar'a gidin
   • Ajan durumunun ACTIVE olduğundan emin olun
   • Durum INACTIVE ise, ajan ayarlarından etkinleştirin

2. İlk mesajı doğrulayın

   • Ajan ayarları → İlk Mesaj
   • Metnin mevcut olduğundan emin olun
   • Değişikliklerden sonra kaydedin

3. Komut dosyası ve bilgi tabanını kontrol edin

   • Komut dosyasının boş olmadığından emin olun
   • Bir bilgi tabanı kullanıyorsanız, bağlı olduğunu ve içerik içerdiğini doğrulayın

4. Tarayıcıda test edin

   • "Ajanla konuş"a tıklayın
   • Mikrofona izin verin
   • Karşılamayı bekleyin

Ajan Yanlış Bilgi Veriyor

Belirtiler:

• Yanlış fiyatlar belirtiliyor
• Yanlış çalışma saatleri söyleniyor
• Uydurma bilgiler

Neden: Genellikle bir bilgi tabanı veya komut dosyası sorunu.

Çözümler:

1. Bilgi tabanı içeriğini kontrol edin

   • Doğru bilgi mevcut mu?
   • Net biçimlendirilmiş mi?
   • Çelişkili bilgi var mı?

2. KB'nin bağlı olduğunu doğrulayın

   • Ajan ayarları → Bilgi Tabanı
   • Doğru KB seçilmiş mi?

3. Komut dosyası kısıtlamalarını güçlendirin Komut dosyasına ekleyin:

   KRİTİK: Yalnızca bilgi tabanındaki bilgileri kullanın.
   Bilgi tabanında bilgi yoksa, "Bu bilgiye sahip değilim" deyin.
   ASLA fiyatları, saatleri veya diğer belirli detayları uydurmayın.

4. Temperature'ı düşürün

   • Temperature'ı 0,3-0,5'e düşürün
   • Daha deterministik yanıtlar

Ajan Bilgi Tabanını Kullanmıyor

Belirtiler:

• Var olan bilgi için "bilmiyorum" diyor
• Spesifik yerine genel yanıtlar

Çözümler:

1. KB'nin bağlı olduğunu onaylayın

   • Ajan ayarları → Bilgi Tabanı bölümü
   • KB'nizin seçili olduğunu göstermeli

2. KB içerik formatını kontrol edin

   • Net başlıklar
   • Basit yapı
   • SSS için soru/cevap çiftleri

3. SSS formatı ekleyin

   S: Çalışma saatleriniz nedir?
   C: Pazartesi-Cuma 9:00-18:00, Cumartesi 10:00-14:00 saatleri arasında açığız.

4. Dosyanın düzgün yüklendiğini doğrulayın

   • Bilgi Tabanı'na gidin
   • Dosyanın listede görüntülendiğini kontrol edin
   • Dosya boyutunun sıfır olmadığını kontrol edin

Ajan Konuşmayı Durdurmuyor

Belirtiler:

• Çok uzun yanıtlar
• Kullanıcıyı beklemiyor
• Bunaltıcı bilgi

Çözümler:

1. Komut dosyasına ekleyin:

   - Yanıtları 1-2 cümleye sınırlayın
   - Her seferinde bir soru sorun
   - Müşterinin yanıt vermesini bekleyin
   - Özlü ve doğrudan olun

2. Maks. token'ı düşürün

   • Ayarlarda mevcutsa
   • Yanıt uzunluğunu sınırlar

---

Bilgi Tabanı Sorunları

Dosya Yükleme Başarısız Oluyor

Belirtiler:

• Yükleme sırasında hata
• Dosya reddedildi
• İşleme takıldı

Çözümler:

1. Dosya formatını kontrol edin

   • Desteklenen: .pdf, .docx, .doc, .xlsx, .xls, .txt, .md, .csv, .rtf, .json
   • Desteklenmeyen: görüntüler, ses, video dosyaları

2. Dosya boyutunu kontrol edin

   • Dosya başına maksimum 10 MB
   • Bilgi tabanı başına maksimum 10 dosya
   • Büyük belgeleri bölmeyi deneyin

3. Dosya içeriğini kontrol edin

   • Parola korumalı değil
   • Bozuk değil
   • Gerçek metin içerir (taranmış görüntüler değil)

4. Farklı format deneyin

   • PDF'yi .txt veya .docx'e dönüştürün
   • Metni yeni belgeye kopyalayın

Bilgi Bulunamıyor

Belirtiler:

• Ajan "bilmiyorum" diyor
• Bilgi KB'de mevcut ancak kullanılmıyor

Çözümler:

1. Yapıyı iyileştirin

   • Konular için net başlıklar
   • Yaygın sorular için SSS formatı
   • Uzun paragraflardan kaçının

2. Tam ifadeleri kullanın

   • Müşterilerin sorduğu şekilde eşleştirin
   • Soruların varyasyonlarını ekleyin

3. Daha fazla bağlam ekleyin

   • Sadece fiyat listelemeyin
   • Hizmet adlarını ve açıklamalarını ekleyin

Örnek iyileştirme:

❌ Kötü:

25, 35, 55

✅ İyi:

## Saç Kesim Fiyatları
- Erkek saç kesimi: €25
- Kadın saç kesimi: €35
- Çocuk saç kesimi (12 yaş altı): €20

---

Telefon Sorunları

Çağrılar Bağlanmıyor

Belirtiler:

• Çağrılar sesli mesaja veya hataya gidiyor
• Çalıyor ancak yanıt yok
• Çağrı hemen düşüyor

Çözümler:

1. Telefon numarası bağlantısını kontrol edin

   • Entegrasyon → Telefon Numaraları
   • Durum "Bağlandı" olmalıdır
   • Değilse, kurulumunuzu kontrol edin

2. Numara atamasını doğrulayın

   • Telefon Numaraları bölümü
   • Numaraya ajan atanmış mı?
   • Ajan aktif mi?

3. Telefon numarası durumunu kontrol edin

   • Numara aktif mi?
   • Hesabın kredi bakiyesi var mı?

4. Tarayıcıyla test edin

   • Kontrol panelindeki "Ajanla konuş"u kullanın
   • Bu çalışıyorsa, sorun telefon tarafında

Yanlış Ajan Yanıtlıyor

Belirtiler:

• Ajan A bekleniyordu, Ajan B geldi
• Yanlış karşılama

Çözümler:

1. Numara atamasını kontrol edin

   • Telefon Numaraları → Numaraya tıklayın
   • Doğru gelen ajanın seçildiğini doğrulayın

2. Webhook çakışmalarını kontrol edin

   • Webhook'un Hanc.AI'ye işaret ettiğini doğrulayın
   • Müdahale eden başka hizmet yok

---

Ses Sorunları

Kötü Çağrı Kalitesi

Belirtiler:

• Robot ses
• Kesik kesik ses
• Konuşmada gecikmeler

Çözümler:

1. İnternet bağlantısını kontrol edin

   • Minimum 5 Mbps önerilir
   • Kablolu bağlantı WiFi'den daha iyidir

2. Ağ koşullarını kontrol edin

   • Yüksek gecikme veya paket kaybı çağrı kalitesini bozar
   • Mümkünse farklı bir ağ deneyin
   • Bant genişliği yoğun uygulamaları kapatın

3. Tarayıcı uyumluluğunu kontrol edin

   • Modern bir tarayıcı kullanın (Chrome, Firefox, Safari, Edge)
   • WebRTC ve Web Audio API'nin desteklendiğinden emin olun
   • Tarayıcıyı en son sürüme güncelleyin

4. Farklı ses deneyin

   • Bazı sesler farklı bağlantılarda daha iyi performans gösterir
   • Ajan ayarlarında alternatifleri test edin

5. Tarayıcı test çağrıları için

   • Diğer sekmeleri/uygulamaları kapatın
   • Mümkünse kablolu kulaklık kullanın
   • Mikrofonun sessize alınmadığını kontrol edin

Ajan Arayanı Anlayamıyor

Belirtiler:

• Ajan tekrarlamayı istiyor
• Kelimeleri yanlış anlıyor
• Yanlış transkripsiyon

Çözümler:

1. Dil ayarları

   • Doğru dilin seçildiğini doğrulayın
   • Arayanın beklenen diliyle eşleştirin

2. Netlik için komut dosyası Komut dosyasına ekleyin:

   Anlamadığınızda, arayandan kibarca tekrarlamasını isteyin.

3. Konuşma tanımayı bağımsız olarak test edin

   • Test çağrısı özelliğini kullanın
   • Net konuşun ve sorunları not edin
   • Aksan veya ses kalitesi olabilir

---

Faturalama Sorunları

Özellik Kullanılamıyor

Belirtiler:

• Düğme grileşmiş
• "Yükseltme gerekli" mesajı
• Daha fazla ajan oluşturulamıyor

Çözümler:

1. Mevcut planı kontrol edin

   • Ayarlar → Faturalama
   • Plan sınırlarını ve özelliklerini inceleyin

2. Ajan oluşturulamıyor

   • Free plan 1 ajanla sınırlıdır
   • Sınırsız ajanlar için Starter veya daha üstüne yükseltin

3. Kullanımı kontrol edin

   • Sınırlara yakın veya sınırda mı?
   • Bir sonraki faturalama döngüsünü bekleyin veya yükseltin

4. Planı yükseltin

   • Gerekirse, Faturalama sayfasından yükseltin

Ödeme Başarısız Oldu

Belirtiler:

• "Ödeme başarısız" hatası
• Hizmet kesintisi
• Abonelik güncellenemiyor

Çözümler:

1. Kart detaylarını kontrol edin

   • Kart süresi dolmamış mı?
   • Yeterli bakiye?
   • Doğru fatura adresi?

2. Bankaya başvurun

   • Uluslararası ödemeler engelli mi?
   • Şüpheli aktivite işareti?

3. Ödeme yöntemini güncelleyin

   • Ayarlar → Faturalama → Ödemeyi Güncelle
   • Farklı kart deneyin

4. Desteğe başvurun

   • Sorunlar devam ederse
   • support@hanc.ai

---

Widget Sorunları

Widget Yüklenmiyor

Belirtiler:

• Widget düğmesi web sitesinde görünmüyor
• Widget hata veya boş alan gösteriyor
• Widget yükleniyor ancak çağrı bağlanmıyor

Çözümler:

1. Alan adı beyaz listesini kontrol edin

   • Ajanınızın widget ayarlarına gidin
   • Web sitenizin alan adının izin verilen alan adları listesine eklendiğinden emin olun
   • Tüm varyasyonları (www ile/olmadan) ekleyin

2. Tarayıcı gereksinimlerini kontrol edin Hanc.AI widget'ı aşağıdaki tarayıcı yeteneklerini gerektirir:

   • WebGL 2.0 — widget arayüzünü oluşturmak için
   • Web Audio API — ses işleme için
   • WebRTC — gerçek zamanlı sesli iletişim için

   Çoğu modern tarayıcı (Chrome, Firefox, Safari, Edge) bunları destekler. Kullanıcılar sorun bildirirse, onlardan tarayıcılarını güncellemelerini isteyin.

3. Widget gömme kodunu kontrol edin

   • Gömme komut dosyasının HTML'nizde doğru yerleştirildiğini doğrulayın
   • JavaScript hataları için tarayıcı konsolunu kontrol edin
   • Reklam engelleyicilerin veya komut dosyası engelleyicilerinin müdahale etmediğinden emin olun

4. Gizli modda test edin

   • Web sitenizi gizli/özel bir pencerede açın
   • Bu, uzantı çakışmalarını ortadan kaldırır

Callback Widget Sorunları

Ziyaretçi numara gönderdi ancak geri arama gelmedi

1. Ajanın geri aramalar için etkinleştirildiğini kontrol edin — Ajanı açın → Widget'lar sekmesi → "Callback widget'ı etkinleştir"in açık olduğundan emin olun ve Kaydedin.
2. Giden telefon numarasının atandığını kontrol edin — Ajanın numara listesinde doğrulanmış bir giden numaraya ihtiyacı vardır. Birisi olmadan, geri arama gönderimleri başarısız olur.
3. Uygunluk uyarısını kontrol edin — Widget'lar sekmesi, (ücretli plan / giden numara / doğrulanmış e-posta) eksikse bir afiş gösterir.
4. Ajanın çağrı kaydına bakın — Başarısız geri aramalar kayıtta net bir hata nedeniyle görünür (örn. "hedef numara ulaşılamıyor", "giden numara mevcut değil").
5. Ziyaretçinin numarasının bozuk olmadığını doğrulayın — Widget seçilen ülkenin formatına karşı doğrular, ancak bir ülke uyumsuzluğu operatörün daha sonra reddettiği bir numaranın geçmesine izin verebilir.

"Kuyruk dolu" mesajı

Her ajan paralel olarak 10 geri aramaya kadar işler. Kuyruk doluyken, yeni gönderimler bekler. Bir dakika bekleyin ve yenileyin — devam eden çağrılar bittikçe kapasite geri döner. Bunu düzenli olarak vuruyorsanız, trafiği birden fazla ajana bölmeyi düşünün.

Ziyaretçinin ülkesi seçicide yok

Kapsam seçilmiştir. Listelenmemiş bir ülkeye ihtiyacınız varsa, support@hanc.ai adresine e-posta gönderin — kapsam talebe göre eklenir.

Widget arayüzü ajanın yapılandırılmış dili yerine İngilizce gösteriyor

Widget dili öncelik sırasına göre üç kaynaktan okur: gömmedeki locale="…" HTML özniteliği, kontrol panelindeki ajanın Widget dili ve ardından geri dönüş olarak İngilizce. Almanca bir sayfada İngilizce görüyorsanız, ajan ayarı hala en olabilir — ajanın Widget'lar sekmesi altında değiştirin ve kaydedin.

Geri arama ortasında yeniden yükleme yapıldığında kuyruğa alınmış durum yerine yeni form gösterir

Bu olağandışıdır — widget normalde yeniden yüklemede devam eden bir geri aramaya yeniden bağlanır. Gömme parçacığının her iki sayfa yüklemesinde aynı olduğundan (aynı agent-id, aynı tarayıcıdan gönderilen aynı numara) ve hiçbir gizlilik uzantısının yeniden yüklemede sayfayı silmediğinden emin olun.

---

Kredi Sorunları

Çağrı "Kredi Yok" ile Kesiliyor

Belirtiler:

• Çağrı konuşma ortasında aniden sona eriyor
• Bağlantı kesilme nedeni NO_CREDITS gösteriyor
• Ajan aktif çağrı sırasında yanıt vermeyi durduruyor

Neden: Çağrı devam ederken hesabınızın kredisi tükendi. Platform, kullanımı karşılayacak kalan kredi olmadığında çağrıları keser.

Çözümler:

1. Kredi bakiyenizi kontrol edin

   • Ayarlar → Faturalama'ya gidin
   • Kalan kredileri inceleyin

2. Daha fazla kredi ekleyin

   • Daha fazla aylık kredi için planınızı yükseltin
   • Aboneliğinizden gelen krediler anında kullanılabilir

3. Kullanımı proaktif olarak izleyin

   • Kredi tüketimini takip etmek için analitiği düzenli olarak inceleyin
   • Mevcutsa kullanım uyarıları ayarlayın

4. Kredi devrini anlayın

   • Kullanılmayan krediler bir sonraki aya devreder
   • Abonelik ücretinizin %100'ü krediye dönüşür

---

Tarayıcı Sorunları

Sayfa Yüklenmiyor

Çözümler:

1. Sayfayı yenileyin (Ctrl/Cmd + R)
2. Önbelleği temizleyin (Ctrl/Cmd + Shift + Delete)
3. Gizli modu deneyin
4. Farklı tarayıcı deneyin
5. İnternet bağlantısını kontrol edin

Düğmeler Çalışmıyor

Çözümler:

1. hanc.ai için reklam engelleyicileri devre dışı bırakın
2. JavaScript'i etkinleştirin
3. Çerezleri temizleyin
4. Tarayıcıyı en son sürüme güncelleyin

---

Entegrasyon Sorunları

Telefon Numaraları Bağlanmıyor

Çözümler:

1. Telefon numarası kurulumunu doğrulayın

   • Numara aktif mi?
   • Ajan atanmış mı?

2. Hesap durumunu kontrol edin

   • Hesap aktif ve kredisi var mı?

3. Yeniden bağlanmayı deneyin

   • Numarayı bağlantıdan kesip yeniden bağlayın
   • Sorunlar devam ederse desteğe başvurun

Webhook Olayları Almıyor

Çözümler:

1. URL'yi doğrulayın

   • URL genel olarak erişilebilir
   • HTTPS (HTTP değil)
   • Kimlik doğrulama gerekli değil

2. Sunucu yanıtını kontrol edin

   • 200 durumu döndürmeli
   • 30 saniye içinde

3. webhook.site ile test edin

   • Olayların gönderildiğini doğrulamak için test URL'sini kullanın
   • Oradan hata ayıklayın

---

Yardım Alma

Destekle İletişime Geçmeden Önce

Bu bilgileri toplayın:

• Hesap e-postası
• Ajan adı/kimliği (varsa)
• Hata ekran görüntüsü
• Sorunu yeniden oluşturma adımları
• Kullanılan tarayıcı ve cihaz

Destekle İletişime Geçin

E-posta: support@hanc.ai

Şunları ekleyin:

• Sorunun net açıklaması
• Ne zaman başladı
• Ne denediniz
• Yardımcı olursa ekran görüntüleri

Yanıt süresi:

• Standart: 24 saat içinde
• Pro/Business: 4 saat içinde

---

Durum Sayfası

Kesintiler için platform durumunu kontrol edin:

• Sistem durumu duyuruları
• Planlanmış bakım pencereleri
• Geçmiş çalışma süresi

---

İlgili Konular

• Platform Genel Bakış — Arayüz kılavuzu
• AI Sesli Ajanlar — Ajan yapılandırması
• Bilgi Tabanı — KB en iyi uygulamaları
• Entegrasyonlar — Entegrasyon kurulumu