Sorun Giderme

Bu kılavuz, Hanc.AI platformuyla ilgili 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ü
Giriş yapı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 kurulumu sorunu	Telefon Sorunları
"Bu numara kullanılamaz"	Numara türü engellendi	Telefon Numaram Reddedildi
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	Kredi tükendi	Kredi Sorunları
Özellik çalışmıyor	Plan kısıtlaması	Faturalandırma Sorunları

---

Hesap Sorunları

Giriş Yapılamıyor

Belirtiler:

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

Çözümler:

1. E-posta/parolayı kontrol edin

   • Doğru e-posta adresinden emin olun
   • Caps lock'u kontrol edin
   • Parolayı kopyala-yapıştır ile deneyin

2. Parolayı sıfırlayın

   • "Parolamı Unuttum" düğmesine tıklayın
   • E-postayı kontrol edin (spam dahil)
   • Sıfırlama bağlantısına 1 saat içinde 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

Hâlâ 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
• "Bu numara kullanılamaz, başka bir numara deneyin" mesajı
• Doğrulama kodu alınamıyor

Çözümler:

1. "Bu numara kullanılamaz"

   • Kayıt önce telefonla başlar ve bazı numara türleri engellidir (aşağıdaki Telefon Numaram Reddedildi bölümüne bakın)
   • Premium tarifeli, paylaşımlı maliyetli ve yapısal olarak geçersiz numaralar asla kabul edilmez — standart bir mobil veya sabit hat numarası kullanın

2. Doğrulama kodu alınamıyor

   • Doğru ülke kodundan emin olun
   • Numarayı baştaki sıfır olmadan girin
   • Kod SMS ile gelir; SMS alamayan bir sabit hat için bunun yerine otomatik bir sesli çağrı ile teslim edilir — telefonu açın ve kodu dinleyin
   • Doğrulama kodları arayüz dilinizde söylenir/yazılır
   • Yeni bir kod istemeden önce 60 saniye bekleyin
   • Farklı bir telefon numarası deneyin

3. Telefon zaten kayıtlı

   • Mevcut hesabı kurtarmak için "Parolamı Unuttum" / giriş yapmayı deneyin
   • Farklı bir numara kullanın

4. Sayfa hataları

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

---

Ajan Sorunları

Ajan Yanıt Vermiyor

Belirtiler:

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

Tanı adımları:

1. Check agent status is ACTIVE (not INACTIVE or DELETED)
2. Verify first message (greeting) is set
3. Check prompt is not empty
4. Check knowledge base is connected (if applicable)
5. Check you have available credits

Çözümler:

1. Ajan durumunu kontrol edin

   • Sesli Ajanlar bölümüne 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. Prompt'u ve bilgi tabanını kontrol edin

   • Prompt'un 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ş" düğmesine tıklayın
   • Mikrofona izin verin
   • Karşılamayı bekleyin

Ajan Yanlış Bilgi Veriyor

Belirtiler:

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

Neden: Genellikle bir bilgi tabanı veya prompt sorunu.

Çözümler:

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

   • Doğru bilgi mevcut mu?
   • Açıkça 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çili mi?

3. Prompt kısıtlamalarını güçlendirin Prompt'a ekleyin:

   CRITICAL: Only use information from the knowledge base.
   If information is not in the knowledge base, say "I don't have that information."
   NEVER make up prices, hours, or other specific details.

4. Sıcaklığı düşürün

   • Sıcaklığı 0.3-0.5'e düşürün
   • Daha belirleyici yanıtlar

Ajan Bilgi Tabanını Kullanmıyor

Belirtiler:

• Var olan bilgiler için "Bilmiyorum" diyor
• Spesifik yerine genel yanıtlar

Çözümler:

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

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

2. KB içerik biçimini kontrol edin

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

3. SSS biçimi ekleyin

   Q: What are your business hours?
   A: We are open Monday-Friday 9am-6pm, Saturday 10am-2pm.

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

   • Bilgi Tabanı bölümüne gidin
   • Dosyanın listede göründüğünü 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. Prompt'a ekleyin:

   - Keep responses to 1-2 sentences
   - Ask one question at a time
   - Wait for the customer to respond
   - Be concise and direct

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

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

---

Bilgi Tabanı Sorunları

Dosya Yükleme Başarısız

Belirtiler:

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

Çözümler:

1. Dosya biçimini kontrol edin

   • Desteklenen: .pdf, .docx, .doc, .xlsx, .xls, .txt, .md, .csv, .rtf, .json
   • Desteklenmeyen: resim, ses, video dosyaları

2. Dosya boyutunu kontrol edin

   • Dosya başına en fazla 10 MB
   • Bilgi tabanı başına en fazla 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çeriyor (taranmış resim değil)

4. Farklı biçim deneyin

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

Bilgi Bulunamadı

Belirtiler:

• Ajan "Bilmiyorum" diyor
• Bilgi KB'de var ama kullanılmıyor

Çözümler:

1. Yapıyı iyileştirin

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

2. Tam ifadeler kullanın

   • Müşterilerin sorma biçimiyle eşleştirin
   • Soruların varyasyonlarını ekleyin

3. Daha fazla bağlam ekleyin

   • Yalnızca fiyatları listelemeyin
   • Hizmet adlarını ve açıklamalarını ekleyin

Örnek iyileştirme:

❌ Kötü:

25, 35, 55

✅ İyi:

## Haircut Prices
- Men's haircut: €25
- Women's haircut: €35
- Children's haircut (under 12): €20

---

Telefon Sorunları

Çağrılar Bağlanmıyor

Belirtiler:

• Çağrılar sesli mesaja veya hataya gidiyor
• Çalıyor ama 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ı
   • Değilse, kurulumunuzu kontrol edin

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

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

3. Telefon numarası durumunu kontrol edin

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

4. Tarayıcıyla test edin

   • Kontrol panelinde "Ajanla konuş" özelliğini kullanın
   • Bu çalışıyorsa, sorun telefon tarafındadır

Yanlış Ajan Yanıtlıyor

Belirtiler:

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

Çözümler:

1. Numara atamasını kontrol edin

   • Telefon Numaraları → Numaraya tıklayın
   • Doğru gelen ajanın seçili olduğunu doğrulayın

2. Web kancası çakışmalarını kontrol edin

   • Web kancasının Hanc.AI'yi işaret ettiğini doğrulayın
   • Başka hizmetlerin araya girmediğinden emin olun

Telefon Numaram Reddedildi

Belirtiler:

• Kaydolurken, numara eklerken veya doğrularken "Bu numara kullanılamaz, başka bir numara deneyin"
• Sahip olduğunuz bir numara doğrulanmıyor

Neden: Hanc.AI, ücret dolandırıcılığı kötüye kullanımını önlemek için bir telefon numarası kapısı uygular. Bazı numara türleri doğrudan engellenir ve bazı sabit hatlar otomatik bir operatör aramasında başarısız olur.

Engellenen numara türleri:

• Premium tarifeli numaralar — arayana premium ücret alan özel tarifeli numaralar
• Paylaşımlı maliyetli numaralar — bölünmüş ücretli numaralar (ör. 0180 tarzı)
• Yapısal olarak geçersiz numaralar — seçilen ülke için yanlış uzunluk veya biçim
• Bazı sabit hatlar — operatör aramasında başarısız olan sabit hatlar

Çözümler:

1. Farklı bir numara deneyin

   • Bu, neredeyse her durumda çözümdür
   • Standart bir mobil veya sabit hat numarası kabul edilir

2. Biçimi kontrol edin

   • Doğru ülke kodu seçili
   • Ülke kodundan sonra baştaki sıfır yok

3. Sabit hat doğrulaması

   • Sabit hatlar SMS alamaz, bu nedenle doğrulama kodu otomatik bir sesli çağrı ile teslim edilir — telefonu açın ve kodu dinleyin
   • Doğrulama kodları arayüz dilinizde verilir

4. Hâlâ engelli mi?

   • Yasal olarak sahip olduğunuz bir numara reddediliyor ve hiçbir alternatif işe yaramıyorsa, support@hanc.ai ile iletişime geçin

---

Ses Sorunları

Kötü Çağrı Kalitesi

Belirtiler:

• Robotik ses
• Kesik ses
• Görüşmede 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 düşürür
   • 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ış yazıya dökme

Çözümler:

1. Dil ayarları

   • Doğru dilin seçili olduğunu doğrulayın
   • Arayanın beklenen diliyle eşleştirin

2. Netlik için prompt Prompt'a ekleyin:

   If you don't understand, politely ask the caller to repeat.

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

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

---

Faturalandırma Sorunları

Özellik Kullanılamıyor

Belirtiler:

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

Çözümler:

1. Mevcut planı kontrol edin

   • Ayarlar → Faturalandırma
   • Plan sınırlarını ve özelliklerini gözden geçirin

2. Ajan oluşturulamıyor

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

3. Kullanımı kontrol edin

   • Sınırlara yakın mı veya sınırlarda mı?
   • Bir sonraki faturalandırma döngüsünü bekleyin veya yükseltin

4. Planı yükseltin

   • Gerekirse, Faturalandırma sayfasından yükseltin

Ödeme Başarısız

Belirtiler:

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

Çözümler:

1. Kart bilgilerini kontrol edin

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

2. Bankayla iletişime geçin

   • Uluslararası ödemeler engellendi mi?
   • Şüpheli etkinlik işareti mi?

3. Ödeme yöntemini güncelleyin

   • Ayarlar → Faturalandırma → Ödemeyi Güncelle
   • Farklı bir kart deneyin

4. Destekle iletişime geçin

   • 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 ama çağrı bağlanmıyor

Çözümler:

1. Alan adı beyaz listesini kontrol edin

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

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, tarayıcılarını güncellemelerini isteyin.

3. Widget yerleştirme kodunu kontrol edin

   • Yerleştirme betiğinin HTML'nizde doğru yerleştirildiğini doğrulayın
   • JavaScript hataları için tarayıcı konsolunu kontrol edin
   • Herhangi bir reklam engelleyici veya betik engelleyicinin araya girmediğinden emin olun

4. Gizli modda test edin

   • Web sitenizi gizli/özel bir pencerede açın
   • Bu, uzantı çakışmalarını dışlar

Geri Arama Widget'ı Sorunları

Ziyaretçi bir numara gönderdi ama geri arama gelmedi

1. Ajanın geri aramalar için etkinleştirildiğini kontrol edin — Ajanı açın → Widget'lar sekmesi → "Geri arama widget'ını etkinleştir" seçeneğinin 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. Biri olmadan geri arama gönderimleri başarısız olur.
3. Uygunluk uyarısını kontrol edin — (ücretli plan / giden numara / doğrulanmış e-posta) bunlardan biri eksikse, Widget'lar sekmesi bir banner gösterir.
4. Ajanın çağrı kaydına bakın — Başarısız geri aramalar, günlükte net bir hata nedeniyle görünür (ör. "hedef numaraya ulaşılamıyor", "kullanılabilir giden numara yok").
5. Ziyaretçinin numarasının hatalı biçimlendirilmediğini doğrulayın — Widget, seçilen ülkenin biçimine göre doğrular, ancak bir ülke uyumsuzluğu, operatörün daha sonra reddedeceği bir numaranın geçmesine izin verebilir.

"Kuyruk dolu" mesajı

Her ajan paralel olarak en fazla 10 geri arama işler. Kuyruk kapasitedeyken, yeni gönderimler bekler. Bir dakika bekleyin ve yenileyin — devam eden çağrılar bittikçe kapasite geri döner. Bununla düzenli olarak karşılaşıyorsanız, trafiği birden fazla ajana bölmeyi düşünün.

Ziyaretçinin ülkesi seçicide yok

Kapsam özenle seçilmiştir. Listelenmeyen 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örünüyor

Widget, dili üç kaynaktan öncelik sırasına göre okur: yerleştirmedeki locale="…" HTML özelliği, kontrol panelindeki ajanın Widget dili, ardından yedek olarak İngilizce. Almanca bir sayfada İngilizce görüyorsanız, ajan ayarı hâlâ en olabilir — bunu ajanın Widget'lar sekmesinde değiştirin ve kaydedin.

Geri arama sırasında yeniden yükleme, kuyruk durumu yerine yeni bir form gösteriyor

Bu olağandışıdır — widget normalde yeniden yüklemede devam eden bir geri aramaya yeniden bağlanır. Yerleştirme snippet'inin 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ı temizlemediğinden emin olun.

---

Kredi Sorunları

Çağrı "Kredi Yok" ile Kesiliyor

Belirtiler:

• Çağrı, görüşme ortasında aniden bitiyor
• Bağlantı kesilme nedeni NO_CREDITS gösteriyor
• Ajan, etkin bir çağrı sırasında yanıt vermeyi durduruyor

Neden: Bir ç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 → Faturalandırma bölümüne gidin
   • Kalan kredileri gözden geçirin

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 analizleri düzenli olarak gözden geçirin
   • 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 etkin mi?
   • Ajan atanmış mı?

2. Hesap durumunu kontrol edin

   • Hesap etkin ve kredisi var mı?

3. Yeniden bağlanmayı deneyin

   • Numaranın bağlantısını kesip yeniden bağlayın
   • Sorunlar devam ederse destekle iletişime geçin

Web Kancası Olayları Almıyor

Çözümler:

1. URL'yi doğrulayın

   • URL herkese açık şekilde erişilebilir
   • HTTPS (HTTP değil)
   • Kimlik doğrulama gerekmiyor

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

Şu bilgileri toplayın:

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

Destekle İletişim

E-posta: support@hanc.ai

Şunları ekleyin:

• Sorunun net açıklaması
• Ne zaman başladığı
• Neler denediğiniz
• 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ı
• Planlı bakım pencereleri
• Geçmiş çalışma süresi

---

İlgili Konular

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