> ## 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.

# Arama Listeleri — Kampanya Hedef Kitlesi Oluşturma

> Kampanyalar için statik ve akıllı arama listeleri oluşturun, müşterileri ekleyin ve toplu arama görevi tanımlayın. Liste yönetimi ve düzenleme rehberi.

## Genel Bakış

Arama listeleri, kampanyalarınızda aranacak müşterilerin telefon numaralarını ve görev bilgilerini içerir. Bir kampanya oluşturmadan önce mutlaka en az bir arama listesi hazırlamanız gerekir.

<Info>
  Arama listeleri, kampanyaların temel yapı taşıdır. Her kampanya bir arama listesine bağlıdır ve listede tanımlanan müşteriler sırasıyla aranır.
</Info>

Her arama listesi şu bilgileri içerir:

* **Liste adı ve açıklama** — Listenizi tanımlayan bilgiler
* **Müşteriler** — Listeye eklenen müşteri kayıtları
* **Arama görevleri** — Her müşteri için tanımlanan arama görevleri (kategori, öncelik, notlar vb.)
* **Liste tipi** — Statik veya Dinamik

## Arama Listeleri Sayfası

Sol menüden **Kampanya Yönetimi** > **Arama Listeleri** yolunu izleyerek arama listeleri sayfasına ulaşabilirsiniz.

### İstatistik Kartları

Sayfa üst kısmında üç istatistik kartı bulunur:

| Kart                    | Açıklama                                          |
| ----------------------- | ------------------------------------------------- |
| **Toplam Liste**        | Oluşturulmuş tüm arama listelerinin sayısı        |
| **Toplam Kişi**         | Tüm listeler genelindeki toplam müşteri sayısı    |
| **Toplam Arama Görevi** | Tüm listelerdeki arama görevlerinin toplam sayısı |

### Liste Kartları

Her arama listesi bir kart olarak gösterilir. Kart üzerinde şu bilgiler yer alır:

* **Liste adı** ve **açıklaması**
* **Liste tipi** — `Statik` veya `Dinamik` olarak etiketlenir
* **Müşteri sayısı** — Listede kayıtlı müşteri adedi
* **Arama görevi sayısı** — Listede tanımlı görev adedi
* **Oluşturulma tarihi**
* **İşlem butonları** — Görüntüle, Düzenle, Sil

<Note>
  Liste görünümü sayfa başına **9 liste** gösterir. Daha fazla listeniz varsa sayfa altındaki sayfalama kontrollerini kullanarak diğer sayfalara geçebilirsiniz.
</Note>

### Arama ve Filtreleme

Listelerde arama yapmak için arama çubuğunu kullanın:

1. Arama kutusuna liste adını yazın
2. **Enter** tuşuna basarak aramayı başlatın
3. Arama sonuçları otomatik filtrelenir
4. Aramayı temizlemek için sağdaki **X** butonuna tıklayın

<Tip>
  Arama çubuğunu temizlediğinizde (içeriği sildiğinizde) tüm listeler otomatik olarak tekrar gösterilir.
</Tip>

## Yeni Arama Listesi Oluşturma

<Steps>
  <Step title="Oluşturma butonuna tıklayın">
    Sayfa sağ üst köşesindeki **Yeni Liste Oluştur** butonuna tıklayın. Oluşturma penceresi açılacaktır.
  </Step>

  <Step title="Liste bilgilerini doldurun">
    Açılan pencerede aşağıdaki alanları doldurun:

    * **Liste Adı** (zorunlu) — Listenizi tanımlayan bir isim girin. Maksimum **100 karakter**.
    * **Açıklama** (opsiyonel) — Listenin amacını açıklayan bir metin girin. Maksimum **250 karakter**.

    Her iki alanda da karakter sayacı ile anlık olarak kaç karakter kullandığınızı görebilirsiniz.
  </Step>

  <Step title="Listeyi oluşturun">
    **Oluştur** butonuna tıklayın. Başarılı olduğunda "Arama listesi başarıyla oluşturuldu" mesajını göreceksiniz.
  </Step>
</Steps>

<Frame>
  <img src="https://mintcdn.com/aiagenttr/DXCGeoE5pY0ImAYy/images/call-lists.png?fit=max&auto=format&n=DXCGeoE5pY0ImAYy&q=85&s=723a637c4c3c30762968dd8746e18651" alt="Arama listeleri — liste adı, müşteri sayısı ve oluşturma tarihi" width="1528" height="943" data-path="images/call-lists.png" />
</Frame>

## Arama Listesini Düzenleme

Mevcut bir arama listesinin adını ve açıklamasını güncelleyebilirsiniz:

<Steps>
  <Step title="Düzenle butonuna tıklayın">
    Liste kartındaki **kalem ikonlu** düzenleme butonuna tıklayın.
  </Step>

  <Step title="Bilgileri güncelleyin">
    Açılan pencerede **Liste Adı** ve **Açıklama** alanlarını güncelleyin. Mevcut değerler otomatik olarak yüklenir.
  </Step>

  <Step title="Kaydedin">
    **Güncelle** butonuna tıklayın. Değişiklikler anında kaydedilir.
  </Step>
</Steps>

## Arama Listesini Silme

<Warning>
  Bu işlem geri alınamaz. Liste ve içindeki tüm veriler kalıcı olarak silinecektir.
</Warning>

<Steps>
  <Step title="Sil butonuna tıklayın">
    Liste kartındaki **çöp kutusu ikonlu** silme butonuna tıklayın.
  </Step>

  <Step title="Silme işlemini onaylayın">
    Açılan onay penceresinde liste adını doğrulayın ve **Sil** butonuna tıklayarak işlemi onaylayın.
  </Step>
</Steps>

## Liste Detay Sayfası

Bir listeyi detaylı olarak incelemek için liste kartındaki **Listeyi Görüntüle** butonuna tıklayın. Detay sayfasında iki bilgi kartı ve arama görevleri tablosu bulunur.

### Liste Bilgileri Kartı

| Alan         | Açıklama                                       |
| ------------ | ---------------------------------------------- |
| **Açıklama** | Listenin açıklama metni                        |
| **Tip**      | `Statik` veya `Dinamik`                        |
| **Durum**    | `Kullanıma hazır` veya `Kullanıma hazır değil` |

### İstatistikler Kartı

| Alan                    | Açıklama                                 |
| ----------------------- | ---------------------------------------- |
| **Müşteri Sayısı**      | Listede kayıtlı müşteri adedi            |
| **Arama Görevi Sayısı** | Listedeki toplam arama görevi            |
| **Oluşturulma**         | Listenin oluşturulma tarihi ve saati     |
| **Son Güncelleme**      | Listenin son güncellenme tarihi ve saati |

### Arama Görevleri Tablosu

Listede arama görevleri varsa, bunlar bir tablo halinde gösterilir. Tablodaki sütunlar:

| Sütun            | Açıklama                                         |
| ---------------- | ------------------------------------------------ |
| **Ad**           | Müşterinin adı                                   |
| **Soyad**        | Müşterinin soyadı                                |
| **Telefon**      | Müşterinin telefon numarası                      |
| **E-posta**      | Müşterinin e-posta adresi                        |
| **Segment**      | Müşteri segmenti (VIP, Risk, Potansiyel, Normal) |
| **Kategori**     | Arama görevinin kategorisi                       |
| **Alt Kategori** | Arama görevinin alt kategorisi                   |
| **Öncelik**      | Görev önceliği (Kritik, Yüksek, Orta, Düşük)     |
| **İşlemler**     | Görüntüle ve Sil butonları                       |

<Note>
  Arama görevleri tablosu sayfa başına **10 kayıt** gösterir. Sayfalama kontrollerini kullanarak diğer sayfalara geçebilirsiniz.
</Note>

<Frame>
  <img src="https://mintcdn.com/aiagenttr/DXCGeoE5pY0ImAYy/images/call-lists.png?fit=max&auto=format&n=DXCGeoE5pY0ImAYy&q=85&s=723a637c4c3c30762968dd8746e18651" alt="Arama listesi detayı — müşteri bilgileri ve arama durumları" width="1528" height="943" data-path="images/call-lists.png" />
</Frame>

## Arama Görevi Ekleme

Arama listesine görev eklemenin iki yolu vardır: **tekli ekleme** ve **toplu ekleme (Excel)**.

### Tekli Arama Görevi Ekleme

Liste detay sayfasındaki **Yeni Görev Ekle** butonuna tıklayarak yeni bir arama görevi oluşturabilirsiniz. Görev oluşturma sayfası birden fazla bölümden oluşur:

<Steps>
  <Step title="Müşteri bilgilerini girin">
    **Müşteri Bilgileri** bölümünde:

    * Mevcut bir müşteri seçin veya yeni müşteri bilgileri girin
    * Mevcut müşteri seçtiyseniz detayları (ad, soyad, telefon, e-posta) otomatik doldurulur
    * Müşteri kaydına gitmek için **Müşteriye Git** butonunu kullanabilirsiniz
  </Step>

  <Step title="Görev bilgilerini doldurun">
    **Arama Görevi Bilgileri** bölümünde:

    * **Kategori ve Alt Kategori** (zorunlu) — Mevcut kategori seçin veya yeni oluşturun
    * **Öncelik** — Düşük, Normal, Yüksek veya Acil
    * **Özel Notlar** — Arama ile ilgili ek notlar
    * **Özel Talimatlar** — AI Agent'a özel sistem talimatları
  </Step>

  <Step title="Aranma nedeni bilgilerini girin (opsiyonel)">
    **Aranma Nedeni** bölümünde aşağıdaki opsiyonel bilgileri ekleyebilirsiniz:

    * Aranma nedeni ve sorun detayı
    * Aranma konusu script
    * Kayıt tarihi, işlem tarihi
    * İşlem tutarı, iade tutarı
    * Referans no, ticket no
    * İlgili üye işyeri ve lokasyonu
    * Önceki puan, risk skoru, önceki yorum
    * Son işlem tarihi
  </Step>

  <Step title="Ek bilgileri doldurun (opsiyonel)">
    * **Dış Bilgiler** — Harici arama sayısı, son arama tarihi, arama sonucu
    * **Hediyeler** — Hediye kodu, indirim oranı, hediye tutarı
    * **Arama Tercihleri** — Başlangıç/bitiş saati, dil tercihi (Türkçe/İngilizce), maksimum yeniden arama sayısı
  </Step>

  <Step title="Görevi kaydedin">
    **Görev Oluştur** butonuna tıklayın. Başarılı olduğunda liste detay sayfasına yönlendirileceksiniz.
  </Step>
</Steps>

<Info>
  Zorunlu alanlar: **Müşteri**, **Kategori/Alt Kategori** ve **Öncelik**. Tüm zorunlu alanlar doldurulmadan Görev Oluştur butonu aktif olmaz.
</Info>

### Öncelik Seviyeleri

| Seviye            | Değer | Açıklama                           |
| ----------------- | ----- | ---------------------------------- |
| **Acil (Kritik)** | 1     | En yüksek öncelik — hemen aranmalı |
| **Yüksek**        | 2     | Yüksek öncelikli görev             |
| **Normal (Orta)** | 3     | Standart öncelik seviyesi          |
| **Düşük**         | 4     | Düşük öncelikli görev (varsayılan) |

### Toplu Arama Görevi Ekleme (Excel)

Çok sayıda arama görevi eklemek için Excel dosyası ile toplu yükleme yapabilirsiniz.

<Steps>
  <Step title="Toplu Görev Ekle butonuna tıklayın">
    Liste detay sayfasındaki **Toplu Görev Ekle** butonuna tıklayın.
  </Step>

  <Step title="Şablon dosyasını indirin">
    Açılan pencerede **Şablon Dosyasını İndir** butonuna tıklayarak Excel şablonunu bilgisayarınıza indirin. Bu şablon, gerekli sütun başlıklarını içerir.
  </Step>

  <Step title="Şablonu doldurun">
    İndirdiğiniz şablonu açın ve arama görevlerinizi doldurun. Şablon formatı kurallarını aşağıda bulabilirsiniz.
  </Step>

  <Step title="Dosyayı yükleyin">
    **Dosya Yükle** alanına dosyanızı sürükleyin veya tıklayarak seçin. Ardından **Toplu Yükleme Başlat** butonuna tıklayın.
  </Step>
</Steps>

<Frame>
  <img src="https://mintcdn.com/aiagenttr/DXCGeoE5pY0ImAYy/images/call-lists.png?fit=max&auto=format&n=DXCGeoE5pY0ImAYy&q=85&s=723a637c4c3c30762968dd8746e18651" alt="Toplu görev yükleme — CSV dosyası ile arama görevi ekleme" width="1528" height="943" data-path="images/call-lists.png" />
</Frame>

#### Dosya Format Kuralları

<Warning>
  Sadece **Excel (.xlsx)** dosya formatı desteklenir. Maksimum dosya boyutu **10 MB**'dır. CSV veya XLS formatları kabul edilmez.
</Warning>

| Kural                     | Açıklama                                   |
| ------------------------- | ------------------------------------------ |
| **Dosya formatı**         | `.xlsx` (Excel)                            |
| **Maksimum boyut**        | 10 MB                                      |
| **İlk satır**             | Başlık satırı olmalıdır                    |
| **Zorunlu alanlar**       | Ad, Soyad, Telefon                         |
| **Kategori/Alt Kategori** | İsim olarak yazılmalı (ID değil)           |
| **Öncelik**               | 1 (Acil) ile 4 (Düşük) arası sayısal değer |

<Tip>
  Dosyanızı yüklemeden önce mutlaka şablon dosyasını indirip kullanın. Şablon, doğru sütun başlıklarını ve format bilgilerini içerir.
</Tip>

<Info>
  Toplu yükleme işlemi arka planda çalışır. Dosya yüklendikten sonra "İşleminiz başladı!" mesajını göreceksiniz. Büyük dosyalar için işlem birkaç dakika sürebilir.
</Info>

## Arama Görevlerini Yönetme

### Görev Detaylarını Görüntüleme

Arama görevleri tablosundaki **göz ikonu** butonuna tıklayarak görevin tüm detaylarını bir pencerede görüntüleyebilirsiniz. Detay penceresinde müşteri bilgileri, kategori, öncelik, notlar ve diğer tüm alanlar yer alır.

### Görev Silme

<Steps>
  <Step title="Sil butonuna tıklayın">
    Tablodaki ilgili görevin **çöp kutusu ikonu** butonuna tıklayın.
  </Step>

  <Step title="Onaylayın">
    Açılan onay penceresinde müşteri adını doğrulayın ve **Sil** butonuna tıklayın.
  </Step>
</Steps>

<Warning>
  Arama görevi silme işlemi geri alınamaz.
</Warning>

## Kampanyalarla Bağlantı

Arama listeleri, kampanya oluşturma sürecinin temel bileşenidir:

<Steps>
  <Step title="Arama listesini hazırlayın">
    Önce bu sayfada anlatıldığı şekilde bir arama listesi oluşturun ve arama görevlerini ekleyin.
  </Step>

  <Step title="Kampanya oluşturun">
    **Kampanya Yönetimi** > **Kampanyalar** > **Yeni Kampanya Oluştur** yolunu izleyin.
  </Step>

  <Step title="Arama listesini seçin">
    Kampanya oluşturma formunda **Çağrı Listesi Seç** alanından hazırladığınız listeyi seçin.
  </Step>

  <Step title="Kampanyayı tamamlayın">
    AI Agent, telefon numarası ve diğer ayarları yaparak kampanyanızı oluşturun.
  </Step>
</Steps>

<Info>
  Bir arama listesini birden fazla kampanyada kullanabilirsiniz. Ancak aynı anda aktif olan birden fazla kampanyanın aynı listeyi kullandığından emin olmanız durumunda mükerrer aramalar olabileceğini göz önünde bulundurun.
</Info>

## En İyi Uygulamalar

<CardGroup cols={2}>
  <Card title="Listeleri Anlamlı Adlandırın" icon="tag">
    Tarih, amaç veya hedef kitle bilgisini liste adına ekleyin. Örnek: "Mart 2026 — Memnuniyet Anketi"
  </Card>

  <Card title="Küçük Başlayın" icon="flask">
    Toplu yükleme yapmadan önce birkaç görevle test edin. Kategori ve alt kategori eşleşmelerinin doğru olduğundan emin olun.
  </Card>

  <Card title="Şablonu Kullanın" icon="file-excel">
    Toplu yükleme için mutlaka platformun sağladığı şablon dosyasını kullanın. Manuel oluşturulan dosyalarda format hataları olabilir.
  </Card>

  <Card title="Düzenli Temizlik Yapın" icon="broom">
    Tamamlanmış kampanyaların listelerini düzenli olarak gözden geçirin. Artık kullanılmayan listeleri silebilirsiniz.
  </Card>
</CardGroup>

## Sık Sorulan Sorular

<AccordionGroup>
  <Accordion title="Bir listeye kaç arama görevi ekleyebilirim?">
    Tekli ekleme için sınır yoktur. Toplu yükleme için Excel dosyası maksimum 10 MB olabilir. Çok büyük listeler için dosyayı parçalara bölüp yükleyebilirsiniz.
  </Accordion>

  <Accordion title="Toplu yükleme sırasında bir hata olursa ne olur?">
    Toplu yükleme işlemi arka planda çalışır. Hatalı satırlar atlanır ve başarılı satırlar işlenir. İşlem tamamlandığında sonuç bildirimi alırsınız.
  </Accordion>

  <Accordion title="Aynı müşteriyi birden fazla listeye ekleyebilir miyim?">
    Evet, aynı müşteri farklı arama listelerinde yer alabilir. Ancak DNC (Aranmayacak Numaralar) listesindeki numaralar otomatik olarak filtrelenir.
  </Accordion>

  <Accordion title="Arama listesini sildikten sonra kurtarabilir miyim?">
    Hayır, silme işlemi kalıcıdır. Liste ve içindeki tüm arama görevleri geri alınamaz şekilde silinir.
  </Accordion>

  <Accordion title="Statik ve Dinamik liste arasındaki fark nedir?">
    **Statik listeler** manuel olarak eklenen müşterilerden oluşur. **Dinamik listeler** ise filtre koşullarına göre otomatik güncellenir. Şu anda listeler varsayılan olarak Statik tipte oluşturulur.
  </Accordion>
</AccordionGroup>

## İlgili Makaleler

<CardGroup cols={2}>
  <Card title="Kampanya Oluşturma" icon="bullhorn" href="/docs/campaigns/create-campaign">
    Arama listelerinizi kullanarak kampanya oluşturmayı öğrenin
  </Card>

  <Card title="Kampanya Takibi" icon="chart-line" href="/docs/campaigns/campaign-execution-tracking">
    Aktif kampanyalarınızı takip edin
  </Card>

  <Card title="DNC Yönetimi" icon="phone-slash" href="/docs/campaigns/dnc-management">
    Aranmayacak numaraları yönetin
  </Card>

  <Card title="Kampanya Analitiği" icon="chart-bar" href="/docs/analytics/campaign-analytics">
    Kampanya performansınızı analiz edin
  </Card>
</CardGroup>