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

# SMS, E-posta ve Numara Sorgulama

> SMS şablonları, föyden borçluya SMS ve e-posta gönderme, 3CX ile arama, gönderilen SMS'ler ve TCKN'den telefon numarası sorgulama.

Pratik İcra'da borçlulara ulaşmak için şu araçlar vardır:

| Araç | Nereden? | Ne gerekir? |
| - | - | - |
| **SMS gönderme** | Föy detayı → **İletişim Bilgileri** | Hermes SMS ayarları, masaüstü uygulaması |
| **E-posta gönderme** | Föy detayı → **İletişim Bilgileri** | SMTP ayarları ve masaüstü uygulaması; yoksa bilgisayarınızdaki mail uygulaması açılır |
| **3CX ile arama** | Föy detayı → **İletişim Bilgileri** | 3CX ayarları ve dahili numaranız, masaüstü uygulaması |
| **TCKN'den numara sorgulama** | **Pratik İcra → TCKN'den Numara Sorgulama** | Hermes ayarları, masaüstü uygulaması. **Ücretlidir.** |

SMTP, 3CX ve Hermes bilgileri **Ayarlar** ekranında girilir. Bkz. [Büro Ayarları](https://docs.pratikportal.com/buro-yonetimi/buro-ayarlari.md)

> [!NOTE]
>
> SMS gönderimi ve TCKN'den numara sorgulama UYAP'ı veya barokartı kullanmaz; büronuzun **Hermes** hesabı üzerinden çalışır ve ücretleri Hermes hesabınızdan düşer. Bkz. [Ücretli İşlemler](https://docs.pratikportal.com/temel-kavramlar/ucretli-islemler.md)

## SMS şablonları

**Pratik İcra → Sms Şablonları** ekranında, borçlulara gönderilecek hazır SMS metinlerini tanımlarsınız. Tabloda **Şablon Adı**, **Açıklama** ve **İçerik** sütunları yer alır.

**1. Yeni şablon ekleyin**

**Yeni SMS Şablon'u Ekle** düğmesine tıklayın. **Sms Şablonu Ekle** penceresi açılır.

**2. Alanları doldurun**

**Şablon Adı**, **Açıklama** ve **Şablon İçeriği** alanlarının üçü de zorunludur.

**3. Parametre ekleyin (isteğe bağlı)**

Mesajda her gönderimde değişecek bir yer varsa (ör. tutar veya dosya numarası) imleci o yere getirip **+ Parametre Ekle**'ye tıklayın. İçeriğe `{{param1}}` gibi bir yer tutucu eklenir. Yer tutucunun adını değiştirebilirsiniz, ör. `{{tutar}}`.

Pencerenin altındaki **Kullanılabilir Parametreler** listesi şablondaki parametreleri gösterir.

**4. Kaydedin**

**Kaydet**'e tıklayın. "Yeni SMS Şablonu başarıyla oluşturuldu." mesajı görünür.

Örnek şablon içeriği:

```text theme={null}
Sayın {{adsoyad}}, {{dosyano}} sayılı icra dosyanızdaki {{tutar}} TL borcunuz için büromuzla iletişime geçiniz.
```

> [!NOTE]
>
> Parametreler gönderim sırasında **elle** doldurulur. Pratik Portal parametrelere föyden veya borçlu kaydından otomatik bilgi yazmaz. İçi boş bir parametre (`{{}}`) kullanılamaz; "Şablon içeriğinde boş parametre kullanılamaz." uyarısı çıkar.

Şablonu satırdaki kalem düğmesiyle düzenleyebilir, çöp kutusu düğmesiyle silebilirsiniz. Silmeden önce "SMS şablonunu silmek istediğinize emin misiniz?" sorusu çıkar.

## Föyden iletişim: SMS, e-posta ve arama

İcra föyü detayındaki **İletişim Bilgileri** sekmesinde, föydeki bütün borçluların telefonları (**Telefonlar** tablosu) ve e-posta adresleri (**E-postalar** tablosu) listelenir. **Borçlu** sütunu numaranın veya adresin kime ait olduğunu gösterir.

**Yeni Telefon** ve **Yeni Eposta** düğmeleri, föy detayında seçili olan borçluya kayıt ekler. Borçlu seçmeden tıklarsanız "Lütfen önce bir borçlu seçiniz." uyarısı çıkar. Eklediğiniz bilgi borçlunun karşı yan kaydına yazılır. Alanlar için bkz. [Müvekkiller → Adresler, telefonlar ve e-postalar](https://docs.pratikportal.com/icra/muvekkiller.md#adresler-telefonlar-ve-e-postalar)

### SMS gönderme

**1. SMS penceresini açın**

**Telefonlar** tablosunda numaranın satırındaki **SMS Gönder** düğmesine tıklayın. **SMS Gönder - *numara*** penceresi açılır.

**2. Şablon seçin**

**Şablon** listesinden bir şablon seçin. Şablonda parametre varsa her biri için bir alan açılır; hepsini doldurun.

**3. Önizleyin**

**SMS Önizleme** alanında, parametreler yerine yazılmış hâliyle gönderilecek metni kontrol edin.

**4. Gönderin**

**Gönder**'e tıklayın. Başarılı olursa "SMS başarıyla gönderildi." mesajı görünür.

**Şablonsuz gönderim:** Rolünüzde `SmsSablonsuzGonder` yetkisi varsa pencerenin altında **Şablonsuz Gönder** düğmesi görünür. Bu düğmeyle **Sms İçeriği** alanına serbest metin yazabilirsiniz; **Şablonla Gönder** ile şablon seçimine dönersiniz. Yetki yoksa yalnızca şablonla gönderebilirsiniz.

Karşılaşabileceğiniz mesajlar:

| Mesaj | Anlamı |
| - | - |
| "SMS ayarları mevcut değil. Lütfen Ayarlar sayfasından güncelleme yapınız." | Hermes SMS bilgileri girilmemiş. Bkz. [Büro Ayarları](https://docs.pratikportal.com/buro-yonetimi/buro-ayarlari.md) |
| "Lütfen bir şablon seçiniz." | Şablon seçilmedi. |
| "Lütfen "…" parametresini doldurunuz." | Şablondaki bir parametre boş. |
| "Lütfen SMS içeriğini giriniz." | Şablonsuz gönderimde metin boş. |
| "SMS gönderilemedi: …" | Hermes gönderimi reddetti; nedeni mesajda yazar. |
| "Geçersiz telefon numarası." | Kayıtlı numara SMS için uygun biçimde değil. |

> [!WARNING]
>
> SMS yalnızca **masaüstü uygulamasından** gönderilebilir. Web'den denediğinizde "SMS gönderilirken bir hata oluştu." mesajı çıkar.

### E-posta gönderme

**E-postalar** tablosunda adresin satırındaki zarf düğmesine tıklayın. Düğmenin davranışı büronuzun SMTP ayarına göre değişir:

> [tab] SMTP ayarlıysa
>
> Düğmenin üzerinde **E-posta Gönder** yazar ve **E-posta Gönder** penceresi açılır.
>
> * **Gönderen:** Büronuzun SMTP hesabı
> * **Alıcı:** Borçlunun adı ve e-posta adresi
> * **Bilgi (CC):** **CC ekle** ile açılır. Birden fazla adresi virgülle ayırın.
> * **Konu:** "İcra Dosyası Bilgilendirme - *dosya no*" olarak hazır gelir; değiştirebilirsiniz.
> * **Mesaj:** En fazla 5000 karakter
>
> **Gönder**'e tıklayın. Başarılı olursa "E-posta başarıyla gönderildi." mesajı görünür. Konu veya mesaj boşsa "Konu boş bırakılamaz." / "Mesaj boş bırakılamaz." uyarısı çıkar.
>
> Pencerenin altındaki **Mail uygulamasında aç** düğmesi, aynı taslağı bilgisayarınızdaki mail uygulamasında açar.
>
> > [!NOTE]
> >
> > Uygulama içinden gönderim yalnızca masaüstü uygulamasında yapılır. Web'de "Uygulama içinden gönderim yalnızca masaüstü uygulamasında yapılabilir." uyarısı çıkar; bu durumda **Mail uygulamasında aç**'ı kullanın.
>
> Gönderim başarısız olursa "E-posta gönderilemedi. Lütfen ayarlardan SMTP bilgilerinizi kontrol ediniz." mesajı çıkar.

> [tab] SMTP ayarlı değilse
>
> Düğmenin üzerinde **Mail uygulamasında aç** yazar. Tıkladığınızda "SMTP ayarı bulunamadı. Bilgisayarınızdaki mail uygulaması açılıyor." bilgisi görünür ve varsayılan mail uygulamanızda alıcısı ve konusu dolu bir taslak açılır.
>
> Mail uygulaması açılamazsa "Mail uygulaması açılamadı." mesajı çıkar.

### 3CX ile arama

**Telefonlar** tablosunda numaranın satırındaki telefon düğmesine (**Ara (3CX) - *numara***) tıklayın. Arama, 3CX santraliniz üzerinden dahili numaranızdan başlatılır.

Arama başlatılamazsa "Arama başlatılamadı: …" mesajı çıkar. Mesajda "3CX bağlantısı yok. 3CX ayarlarının ve kullanıcının dahili numarasının tanımlı olduğunu kontrol ediniz." yazıyorsa büronuzun 3CX ayarlarını ve dahili numaranızı kontrol edin. 3CX bağlantı durumunu üst çubuktaki **3CX** göstergesinde görebilirsiniz. Bkz. [Arayüz Tanıtımı](https://docs.pratikportal.com/baslangic/arayuz-tanitimi.md)

> [!NOTE]
>
> 3CX ile arama yalnızca masaüstü uygulamasında çalışır.

## Gönderilen SMS'ler

Gönderilen bütün SMS'ler **Raporlar → Gönderilen SMSler** ekranında listelenir. Gönderim başarısız olsa da kayıt tutulur.

Sütunlar: **Gönderilme Tarihi**, **Karşı Yan TC**, **Karşı Yan Ad Soyad**, **Telefon Numarası**, **SMS İçeriği**, **Mesaj ID**, **Mesaj Durumu** ve **SMS Gönderen Kullanıcı**.

SMS'in karşı tarafa ulaşıp ulaşmadığını öğrenmek için:

* Tek bir SMS için satırdaki **Gönderim Sonucunu Sorgula** düğmesine tıklayın. Sonuç "… mesaj id numaralı mesajın durumu: …" şeklinde görünür.
* Birden çok SMS için satırları seçip **Seçilenlerin Gönderim Sonucunu Sorgula** düğmesine tıklayın.

**Mesaj Durumu** sütunu sorgudan sonra güncellenir.

## TCKN ile numara sorgulama

**Pratik İcra → TCKN'den Numara Sorgulama** ekranı, bir kişinin TC kimlik numarasından seçtiğiniz operatördeki telefon numarasını Hermes üzerinden sorgular.

> [!WARNING]
>
> Bu sorgu **ücretlidir**. Sonuç bulunduğunda ücret büronuzun Hermes hesabından düşer. Bkz. [Ücretli İşlemler](https://docs.pratikportal.com/temel-kavramlar/ucretli-islemler.md)

**1. TCKN girin**

**TCKN** alanına 11 haneli TC kimlik numarasını yazın.

**2. Operatörü seçin**

**Operatör** listesinden **Avea**, **Turkcell** veya **Vodafone**'u seçin. Her sorgu tek bir operatörde yapılır.

**3. Sorgulayın**

**Sorgula** düğmesine tıklayın. Bulunan numaralar tabloda **TC No**, **Telefon Numarası**, **Operatör**, **Sorgu Tarihi** ve **Sorgulayan Kullanıcı** sütunlarıyla listelenir.

### Kayıtlı sorgu bulunduğunda

Aynı TCKN ve operatör için büronuzda daha önce sorgu yapılmışsa sorgu hemen başlamaz; **Kayıtlı Sorgu Bulundu** penceresi açılır:

| Düğme | Ne olur? |
| - | - |
| **Kayıtlıyı Göster** | Eski sorgunun sonuçları getirilir. **Ücretlendirilmezsiniz.** |
| **Yine de Sorgula** | Yeni sorgu yapılır. Sonuç bulunursa **ücretlendirilirsiniz.** |

> [!WARNING]
>
> **Yine de Sorgula** düğmesi, çoğu pencerede **İptal** veya **Hayır** düğmesinin bulunduğu yerdedir. Vazgeçmek için bu düğmeye basmayın: yeni ve ücretli bir sorgu başlatır. Sorgu yapmadan çıkmak için pencereyi sağ üstteki **X** ile kapatın.

> [!TIP]
>
> Aynı kişiyi yeniden sorgulamanız gerekmiyorsa **Kayıtlıyı Göster**'i seçin. Büronuzda yapılmış bütün TCKN sorgularını **Raporlar → Telefon Raporları → Telefon Raporları (TCKN)** ekranında da görebilirsiniz.

### Uyarı mesajları

| Mesaj | Anlamı |
| - | - |
| "TCKN alanı boş bırakılamaz." | TCKN girilmedi. |
| "TC Kimlik Numarası hatalı." | Numara geçerli bir TC kimlik numarası değil. |
| "Operatör alanı boş bırakılamaz." | Operatör seçilmedi. |
| "Hermes SMS yapılandırması bulunamadı. Ayarlar sayfasından yapılandırmanız gerekiyor." | Hermes bilgileri girilmemiş. Bkz. [Büro Ayarları](https://docs.pratikportal.com/buro-yonetimi/buro-ayarlari.md) |

Numara bulunamazsa tabloda numarası boş bir satır görünür.

> [!NOTE]
>
> Sorgu yalnızca **masaüstü uygulamasında** çalışır.

## Gerekli yetkiler

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

| İşlem | Yetki adı | Rol ekranındaki açıklaması |
| - | - | - |
| Sms Şablonları ekranını görme | `SmsTemplateDefault` | SMS şablonlarını görüntüleyebilir. |
| Şablon ekleme | `SmsTemplateCreate` | Yeni SMS şablonu oluşturabilir. |
| Şablon düzenleme | `SmsTemplateUpdate` | SMS şablonlarını güncelleyebilir. |
| Şablon silme | `SmsTemplateDelete` | SMS şablonlarını silebilir. |
| Şablonsuz (serbest metinle) SMS gönderme | `SmsSablonsuzGonder` | Şablon kullanmadan serbest metinle SMS gönderebilir. |
| Gönderilen SMS'in kaydedilmesi | `SmsLogCreate` | Yeni SMS gönderim kaydı oluşturabilir. |
| Gönderilen SMSler ekranı ve gönderim sonucu sorgulama | `SmsLogDefault` | Gönderilen SMS kayıtlarını görüntüleyebilir. |
| Telefon ekleme / düzenleme / silme | `PhoneCreate` / `PhoneUpdate` / `PhoneDelete` | Yeni telefon kaydı ekleyebilir. / Telefon kayıtlarını güncelleyebilir. / Telefon kayıtlarını silebilir. |
| E-posta ekleme / düzenleme / silme | `EmailCreate` / `EmailUpdate` / `EmailDelete` | Yeni e-posta kaydı ekleyebilir. / E-posta kayıtlarını güncelleyebilir. / E-posta kayıtlarını silebilir. |
| TCKN'den Numara Sorgulama ekranı | `HermesTcknSorgulamaDefault` | TCKN üzerinden telefon numarası sorgulama ekranını kullanabilir. |
| TCKN sorgusunun kaydedilmesi | `HermesTcknSorgulamaCreate` | TCKN telefon sorgusu başlatabilir. |
| Telefon Raporları (TCKN) | `TelefonRaporuTcknDefault` | TCKN telefon sorgu raporlarını görüntüleyebilir. |

> [!NOTE]
>
> Sorgu önce Hermes'e gönderilir, sonucu sonra büronun kayıtlarına yazılır. `HermesTcknSorgulamaCreate` yetkisi olmayan kullanıcının sorgusu ücretlendirilebilir ama kaydedilemez; bu yüzden sonraki sorgularda **Kayıtlı Sorgu Bulundu** penceresi çıkmaz. Sorgu yapacak kullanıcılara iki yetkiyi birlikte verin.


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