> ## Documentation Index
> Fetch the complete documentation index at: https://aiagenttr.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Müşteri Arama ve Filtreleme — CRM Arama Rehberi

> CRM sisteminde müşterilerinizi ad, telefon, e-posta veya segmente göre arayın ve filtreleyin. Gelişmiş arama ve filtreleme seçenekleri rehberi.

## Genel Bakış

Müşteri arama ve filtreleme özellikleri ile binlerce müşteri arasından ihtiyacınız olanları hızlıca bulabilir ve segmentlere ayırabilirsiniz.

## Hızlı Arama

### Global Arama

**Konum:** Müşteriler sayfası üst kısım - Arama çubuğu

**Kullanım:**

1. Arama kutusuna yazın
2. Enter'a basın veya yazmaya devam edin
3. Sonuçlar otomatik olarak filtrelenir

**Aranılan Alanlar:**

* İsim (firstName)
* Soyisim (lastName)
* Telefon numarası
* E-posta adresi
* Şirket adı
* Ünvan

**Örnekler:**

* `Ahmet` → İsmi veya soyismi Ahmet olanlar
* `+905551234567` → Bu telefon numarasına sahip
* `@gmail.com` → Gmail kullananlar
* `ABC Ltd` → Bu şirkettekiler

### Arama Özellikleri

**Kısmi Eşleşme:**

* `ahm` → Ahmet, Mahmut
* `555` → 555 ile başlayan telefonlar

**Büyük-Küçük Harf Duyarsız:**

* `ahmet` = `AHMET` = `Ahmet`

**Gerçek Zamanlı:**

* Yazarken sonuçlar güncellenir

<Frame>
  <img src="https://mintcdn.com/aiagenttr/DXCGeoE5pY0ImAYy/images/customers-list.png?fit=max&auto=format&n=DXCGeoE5pY0ImAYy&q=85&s=d768c29b372ffcc3bb4f21012ec13c09" alt="Müşteri arama — global arama çubuğu ve filtreleme seçenekleri" width="1528" height="943" data-path="images/customers-list.png" />
</Frame>

## Temel Filtreleme

### Segment Filtresi

**Konum:** Arama çubuğunun yanında - Segment dropdown

**Kullanım:**

1. Segment dropdown'ını açın
2. İstediğiniz segmenti seçin
3. Sonuçlar otomatik olarak filtrelenir

**Mevcut Segmentler:**

* **VIP**: Öncelikli müşteriler
* **Normal**: Standart müşteriler
* **Risk**: Risk altındaki müşteriler
* **Potansiyel**: Potansiyel müşteriler

<Tip>
  Segment filtresini arama ile birlikte kullanarak daha spesifik sonuçlar elde edebilirsiniz. Örneğin: VIP segmentinden "İstanbul" araması.
</Tip>

### Son İletişim Filtresi

**Konum:** Filtreleme alanının sağ tarafı

**Kullanım:**

* **Son 7 gün içinde iletişim** checkbox'ını işaretleyin
* Sadece son 7 gün içinde aranmış müşteriler gösterilir

**Kullanım Senaryoları:**

* Yakın zamanda iletişim kurulan müşterileri görme
* Takip gerektiren müşterileri bulma
* Aktif müşteri listesi oluşturma

## Sıralama

### Sıralama Seçenekleri

**Konum:** Filtreleme alanında - Sıralama dropdown

**Mevcut Seçenekler:**

<Tabs>
  <Tab title="Güncelleme Tarihi">
    **Sıralama:** En son güncellenenden en eskiye

    **Ne zaman kullanılır:**

    * Son eklenen müşterileri görme
    * Yakın zamanda düzenlenen kayıtları bulma
  </Tab>

  <Tab title="İletişim Miktarı">
    **Sıralama:** En çok iletiş kurulan en aza

    **Ne zaman kullanılır:**

    * En aktif müşterileri bulma
    * Çok aranan müşterileri görme
    * İlişki yoğunluğuna göre önceliklendirme
  </Tab>
</Tabs>

**Örnekler:**

* Güncelleme Tarihi: En yeni kayıtlar üstte
* İletişim Miktarı: En çok aranan müşteriler üstte

<Frame>
  <img src="https://mintcdn.com/aiagenttr/DXCGeoE5pY0ImAYy/images/customers-list.png?fit=max&auto=format&n=DXCGeoE5pY0ImAYy&q=85&s=d768c29b372ffcc3bb4f21012ec13c09" alt="Müşteri sıralama — ad, tarih ve segment bazlı sıralama" width="1528" height="943" data-path="images/customers-list.png" />
</Frame>

## Toplu Müşteri İşlemleri

### Toplu Müşteri Yükleme

**Konum:** Müşteriler sayfası sağ üst - **Toplu Müşteri Yükle** butonu

**Desteklenen Formatlar:**

* Excel (.xlsx, .xls)
* CSV (.csv)

**Maksimum Dosya Boyutu:** 10MB

<Steps>
  <Step title="Şablon İndirin">
    1. **Toplu Müşteri Yükle** butonuna tıklayın
    2. **Şablon İndir** linkine tıklayın
    3. Excel veya CSV şablonunu indirin
  </Step>

  <Step title="Dosyayı Doldurun">
    Şablon dosyasını açın ve müşteri bilgilerini girin:

    * İsim (zorunlu)
    * Soyisim (zorunlu)
    * Telefon (zorunlu, `E.164` formatında)
    * E-posta (opsiyonel)
    * Şirket adı (opsiyonel)
    * Segment (opsiyonel: vip, normal, risk, potential)
    * Diğer alanlar...
  </Step>

  <Step title="Dosyayı Yükleyin">
    1. Doldurduğunuz dosyayı sürükleyip bırakın veya seçin
    2. **Mevcut kayıtları güncelle** seçeneğini işaretleyin (gerekirse)
    3. **Yükle** butonuna tıklayın
  </Step>

  <Step title="Sonucu Kontrol Edin">
    * Yükleme işlemi tamamlandığında başarı mesajı görüntülenir
    * Hata varsa detayları inceleyebilirsiniz
  </Step>
</Steps>

<Info>
  **Güncelleme Modu:** "Mevcut kayıtları güncelle" seçeneği aktifse, aynı telefon numarasına sahip müşteri bilgileri güncellenir. Deaktifse, sadece yeni müşteriler eklenir.
</Info>

<Warning>
  **Telefon Numarası Formatı:** Telefon numaraları mutlaka `E.164` formatında olmalıdır (örn: +905551234567). Yanlış formattaki numaralar hata verecektir.
</Warning>

### Toplu Export (Yakında)

<Info>
  **Gelecek Özellik:** Filtrelenmiş müşteri listesini Excel veya CSV formatında dışa aktarma özelliği yakında eklenecektir.
</Info>

## Sayfalama

### Sayfa Başına Kayıt

**Konum:** Müşteri listesinin alt kısmı

**Varsayılan:** 20 müşteri/sayfa

**Değiştirme:**

* Sayfa navigasyonu ile farklı sayfalara geçebilirsiniz
* ◀️ Önceki ve Sonraki ▶️ butonları
* Sayfa numaraları (1, 2, 3...)

**Toplam Sonuç:**

```
1-20 / 1,250 müşteri
```

**Performans:**

* 20 kayıt/sayfa optimal performans sağlar
* Daha hızlı yükleme süreleri
* Daha iyi kullanıcı deneyimi

## Filtre Kombinasyonları

### Örnek Kullanım Senaryoları

<AccordionGroup>
  <Accordion title="VIP müşterilerden İstanbul'da olanları bulma">
    1. **Segment filtresi:** VIP seçin
    2. **Arama:** "İstanbul" yazın
    3. Sonuç: VIP segmentindeki İstanbul'daki müşteriler
  </Accordion>

  <Accordion title="Son 7 gün içinde aranan Gmail kullanıcılarını listeleme">
    1. **Arama:** "@gmail.com" yazın
    2. **Son 7 gün filtresi:** İşaretleyin
    3. Sonuç: Son 7 gün içinde aranan Gmail kullanıcıları
  </Accordion>

  <Accordion title="En çok aranan VIP müşterileri görme">
    1. **Segment:** VIP seçin
    2. **Sıralama:** İletişim Miktarı seçin
    3. Sonuç: VIP müşteriler, en çok arananlar üstte
  </Accordion>

  <Accordion title="Yeni eklenen potansiyel müşterileri inceleme">
    1. **Segment:** Potansiyel seçin
    2. **Sıralama:** Güncelleme Tarihi seçin
    3. Sonuç: En yeni potansiyel müşteriler üstte
  </Accordion>
</AccordionGroup>

## Performans İpuçları

<Tip>
  **Hızlı Arama İçin:**

  * ✅ Spesifik arama terimleri kullanın
  * ✅ Segment filtresi ile sonuçları daraltın
  * ✅ Sayfa başına 20 kayıtta kalın
  * ❌ Çok genel aramalar yapmayın (tek harf gibi)
</Tip>

## Yakında Gelecek Özellikler

Platform sürekli geliştirilmektedir. Yakında eklenecek özellikler:

<CardGroup cols={2}>
  <Card title="Gelişmiş Filtreler" icon="filter">
    * Tarih aralığı filtreleri
    * Özel alan filtreleri
    * Çoklu filtre kombinasyonları
  </Card>

  <Card title="Kayıtlı Filtreler" icon="bookmark">
    * Sık kullanılan filtreleri kaydetme
    * Takım ile filtre paylaşma
    * Hızlı erişim
  </Card>

  <Card title="Toplu İşlemler" icon="users">
    * Toplu tag ekleme/çıkarma
    * Toplu segment değiştirme
    * Toplu kampanyaya ekleme
  </Card>

  <Card title="Export Seçenekleri" icon="download">
    * Filtrelenmiş listeyi Excel export
    * CSV export
    * Zamanlanmış export
  </Card>
</CardGroup>

## Sık Sorulan Sorular

<AccordionGroup>
  <Accordion title="Arama sonuçları gerçek zamanlı mı?">
    Evet, yazarken sonuçlar otomatik olarak güncellenir. Debounce süresi çok kısadır.
  </Accordion>

  <Accordion title="Kaç müşteri arasında arama yapabilirim?">
    Teknik bir limit yoktur. Binlerce müşteri arasında hızlıca arama yapabilirsiniz.
  </Accordion>

  <Accordion title="Toplu yükleme sırasında hata alırsam ne yapmalıyım?">
    Hata mesajını okuyun ve telefon numarası formatını kontrol edin. `E.164` formatı zorunludur (+905551234567).
  </Accordion>

  <Accordion title="Filtreleri temizlemek için ne yapmalıyım?">
    Arama kutusunu boşaltın, segment filtresini "Tüm Segmentler" olarak seçin ve checkbox'ları temizleyin.
  </Accordion>

  <Accordion title="Birden fazla segment seçebilir miyim?">
    Şu anda tek segment seçimi desteklenmektedir. Gelecek güncellemelerde çoklu seçim eklenecektir.
  </Accordion>
</AccordionGroup>

## İlgili Makaleler

<CardGroup cols={2}>
  <Card title="Müşteri Ekleme" icon="user-plus" href="/docs/customer-management/add-customer">
    Yeni müşteri ekleme ve bilgi girişi
  </Card>

  <Card title="Müşteri Etkileşimleri" icon="message-circle" href="/docs/customer-management/customer-interactions">
    Müşteri ile yapılan etkileşimleri görüntüleme
  </Card>

  <Card title="Toplu Müşteri İçe Aktarma" icon="upload" href="/docs/customer-management/bulk-customer-import">
    Excel/CSV ile toplu müşteri yükleme
  </Card>
</CardGroup>