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

# 3CX Çağrı Logları

> 3CX santralinden gelen ve giden çağrıların listesi, çağrıların borçlu ve föylerle eşleşmesi, manuel senkronizasyon ve kullanıcı bazında özet rapor.

3CX santrali kullanan bürolarda **Pratik İcra → Raporlar → 3CX Çağrı Logları** ekranı santraldeki çağrıları listeler. Pratik Portal her çağrının numarasını borçluların telefon kayıtlarıyla karşılaştırır; numara bir borçluya aitse çağrının hangi borçlu ve föyle ilgili olduğunu, föyün agent'ının kim olduğunu gösterir.

## Ön koşullar

**1. Büronun 3CX bağlantısı**

Büro yöneticisi **Profil menüsü → Ayarlar → 3CX Ayarları** bölümünde 3CX santralinin **Host**, **Port**, **Client ID** ve **Client Secret** bilgilerini girer. Bkz. [Büro Ayarları](https://docs.pratikportal.com/buro-yonetimi/buro-ayarlari.md)

**2. Kullanıcının dahili numarası**

Her kullanıcı **Profil menüsü → Profilim** ekranında **3CX İç Hat Dahilisi** alanına kendi dahili numarasını yazar. Bu alan yalnızca kendisine İcra lisansı atanmış kullanıcılarda görünür.

**3. Masaüstü uygulaması**

3CX bağlantısı ve arama yalnızca masaüstü uygulamasında çalışır.

İlk iki adım tamamlandıysa Pratik Portal, oturum açtığınızda 3CX'e kendiliğinden bağlanır.

### Üst çubuktaki 3CX göstergesi

Büronuzda 3CX ayarları girilmişse üst çubukta **3CX** göstergesi görünür:

| Gösterge | Anlamı |
| - | - |
| **3CX Bağlı** | Dahili numaranızla santrale bağlısınız. Arama yapabilir, çağrı kartlarını görebilirsiniz. |
| **3CX Bağlı değil** | Bağlantı yok. **Profilim**'de **3CX İç Hat Dahilisi**'nin dolu olduğunu ve büro 3CX ayarlarının doğru olduğunu kontrol edin. |

Bağlı değilken bir numarayı aramaya çalışırsanız "Arama başlatılamadı: …" mesajı çıkar.

### Çağrı kartı

3CX'e bağlıyken bir çağrı geldiğinde veya bir numarayı aradığınızda ekranda bir çağrı kartı açılır. Kartta çağrının durumu (**Çalıyor**, **Aranıyor**, **Bağlandı**) ve numara yazar. Numara borçlulardan birine kayıtlıysa **Borçlu Föyleri** tablosunda borçlunun föyleri **Borçlu**, **Dosya No**, **İcra Dairesi**, **Alacaklılar**, **Agent** ve **Agent Dahili** sütunlarıyla listelenir.

Karttaki düğmeler: **Cevapla** (yalnızca çalarken), **Çağrıyı Sonlandır**, **Kopyala** (numarayı panoya kopyalar) ve **Küçült** / **Genişlet**. Çağrıyı başka bir dahiliye aktarmak için alttaki **Aktarılacak dahili numara** alanına numarayı yazıp **Aktar**'a tıklayın.

## Çağrı listesi

Tablonun başlığında **3CX Çağrı Logları** yazar. En son kaydedilen çağrı en üstte gelir.

| Sütun | Açıklama |
| - | - |
| **Tarih** | Çağrının başladığı tarih ve saat |
| **Yön** | **Gelen**, **Giden** veya **Dahili** (büro içi) |
| **Arayan Numara**, **Arayan Ad** | Çağrıyı başlatan numara ve santralde görünen adı |
| **Aranan Numara**, **Aranan Ad** | Aranan numara ve santralde görünen adı |
| **Konuşma Süresi** | Görüşmenin süresi (ss:dd:sn) |
| **Çalma Süresi** | Telefonun açılana kadar çaldığı süre (ss:dd:sn) |
| **Durum** | **Cevaplandı**, **Cevapsız** veya **Yönlendirildi** |
| **Çağrı Tipi** | **Dijital Operatör**, **Dahili**, **Harici**, **Gelen** veya **Sistem** |
| **Cevaplandı** | **Evet** / **Hayır** |
| **Borçlu** | Numarası bu çağrıyla eşleşen borçlu |
| **İcra Föyü** | Borçlunun föyü (*Föy No-İcra Dairesi-Dosya No*). Tıkladığınızda föy yeni bir sekmede açılır. |
| **Agent** | Föyün **şu anki** agent'ı |
| **Sorumlu Agent** | Çağrının yapıldığı tarihte föyün agent'ı olan kullanıcı |

### Borçlu ve föy eşleşmesi nasıl yapılır?

* **Gelen** çağrıda arayan numara, **Giden** çağrıda aranan numara borçluların telefon kayıtlarında aranır. **Dahili** çağrılar eşleştirilmez.
* Numara birden çok borçluda veya borçlunun birden çok föyünde kayıtlıysa her eşleşme hücrede ayrı bir satır olarak görünür.
* Eşleşme yoksa hücrede **—** yazar. Numarayı borçlunun **İletişim** sekmesine ekledikten sonra eşleşme kendiliğinden görünür.
* **Sorumlu Agent**, agent atama kayıtlarından bulunur. Çağrı tarihinden önce yapılmış bir atama kaydı yoksa boş kalır. Agent atama için bkz. [Agent Bilgisi](https://docs.pratikportal.com/raporlar/agent-bilgisi.md)

> [!TIP]
>
> **Agent** ile **Sorumlu Agent** farklıysa föy, çağrıdan sonra başka bir kullanıcıya devredilmiştir.

### Geri arama

Karşı tarafın numarası aranabilir biçimdeyse satırın başında telefon düğmesi görünür. Üzerine geldiğinizde **Ara (3CX) - *numara*** yazar. Gelen çağrıda arayan numara, giden çağrıda aranan numara aranır.

## Manuel Senkronizasyon

Çağrılar 3CX santralinden Pratik Portal'a aktarılarak listelenir. **Manuel Senkronizasyon** seçtiğiniz tarih aralığındaki çağrıları santralden çeker.

**1. Tarih aralığını seçin**

**Başlangıç Tarihi** ve **Bitiş Tarihi** alanlarında gün ve saati seçin. Varsayılan aralık son 7 gündür. İleri bir tarih seçilemez.

**2. Senkronize edin**

**Manuel Senkronizasyon** düğmesine tıklayın. İşlem bitince şu mesaj görünür ve liste yenilenir:

"3CX'ten toplam *N* kayıt çekildi, *M* yeni kayıt eklendi."

Daha önce aktarılmış çağrılar tekrar eklenmez. Aynı aralığı birden çok kez senkronize etmeniz sorun yaratmaz.

| Mesaj | Anlamı |
| - | - |
| "Lütfen başlangıç ve bitiş tarihi seçin." | Tarihlerden biri boş |
| "Bitiş tarihi başlangıç tarihinden önce olamaz." | Tarihleri kontrol edin |

Tarih alanları ve düğme yalnızca `ThreeCxCallLogSync` yetkisi olan kullanıcılara görünür.

> [!NOTE]
>
> **Yerel Sunucu** kurulumlarında çağrılar her gece 01.00–02.00 arasında son 7 günü kapsayacak şekilde kendiliğinden aktarılır. Bulut kurulumunda kendiliğinden aktarma yoktur; listeyi güncellemek için **Manuel Senkronizasyon**'u kullanın.

> [!WARNING]
>
> Büronuzda 3CX ayarları yoksa senkronizasyon hata vermez, yalnızca "3CX'ten toplam 0 kayıt çekildi, 0 yeni kayıt eklendi." yazar. Sürekli 0 kayıt görüyorsanız 3CX ayarlarını kontrol edin.

## Özet Rapor

**Özet Rapor** düğmesi, kullanıcı (dahili numara) bazında çağrı sürelerini ve sayılarını gösteren bir pencere açar.

**1. Aralığı seçin**

Pencere açıldığında içinde bulunduğunuz ayın başından bugüne kadarki özet gelir. Başka bir aralık için **Başlangıç Tarihi** ve **Bitiş Tarihi**'ni seçin. Seçilen günler tam gün olarak (00.00–23.59) hesaplanır.

**2. Getirin**

**Getir**'e tıklayın. Aralıkta çağrı yoksa "Seçilen aralıkta kayıt bulunamadı." yazar.

| Sütun | Açıklama |
| - | - |
| **Kullanıcı** | Dahili numaranın sahibi olan kullanıcı. Dahili numara hiçbir kullanıcının **Profilim**'inde tanımlı değilse dahili numaranın kendisi yazar. |
| **Çalma (Gelen / Giden / Toplam)** | Telefonun çaldığı toplam süre |
| **Konuşma (Gelen / Giden / Toplam)** | Toplam görüşme süresi |
| **Gelen (Toplam)**, **Giden (Toplam)** | Çağrı sayısı |
| **Gelen (Tekil)**, **Giden (Tekil)** | Farklı numara sayısı. Aynı numarayla yapılan birden çok görüşme bir kez sayılır. |

Süreler ss:dd:sn biçimindedir. Gelen çağrılar aranan dahiliye, giden çağrılar arayan dahiliye yazılır. **Dahili** (büro içi) çağrılar özete dahil edilmez.

Özet tabloda sıralama, filtreleme ve dışa aktarma ana tablodaki gibi çalışır. Bkz. [Tablolar ve Dışa Aktarma](https://docs.pratikportal.com/temel-kavramlar/tablolar.md)

> [!NOTE]
>
> Özet rapor yalnızca Pratik Portal'a aktarılmış çağrılardan hesaplanır. Önce ilgili aralığı senkronize edin.

## Gerekli yetkiler

Yetkileri büro yöneticisi [Roller](https://docs.pratikportal.com/buro-yonetimi/roller-ve-yetkiler.md) ekranından verir.

| İşlem | Yetki adı | Rol ekranındaki açıklaması |
| - | - | - |
| Ekranı açma ve **Özet Rapor** | `ThreeCxCallHistoryView` | 3CX çağrı geçmişi ve çağrı loglarını görüntüleyebilir. |
| **Manuel Senkronizasyon** | `ThreeCxCallLogSync` | 3CX çağrı loglarını sistemle eşitleyebilir. |
| Büro 3CX ayarlarını girme | `UpdateThreeCxConfiguration` | 3CX entegrasyon ayarlarını güncelleyebilir. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.