# iletiMerkezi - Detaylı Bilgi

> iletiMerkezi, eMarka İletişim ve Bilgi Teknolojileri A.Ş. tarafından işletilen, BTK lisanslı (STH-195) bulut tabanlı toplu SMS ve mesajlaşma platformudur. 150'den fazla ülkeye, 800'den fazla operatöre SMS iletimi sağlar. İşletmelere toplu SMS, SMS API, OTP doğrulama, e-posta ile SMS gönderimi, rehber yönetimi, iim.to ile kısa link oluşturma, İYS izin yönetimi ve MCP server (Claude Desktop, Cursor, Cline) hizmetleri sunar.

> Last updated: 2026-08-05
> Languages: Turkish (primary), English (full parallel coverage at /en/*)
> Audience indexes:
> - https://www.iletimerkezi.com/llms-developer.txt — Developer-focused (API + SDK + MCP + webhooks)
> - https://www.iletimerkezi.com/llms-general.txt — General-user (product + pricing + regulation + guides)
> - https://www.iletimerkezi.com/llms.txt — Master index

## LLM-ready resources

- API manifest: https://www.iletimerkezi.com/api/manifest.json — 11 endpoints + webhook spec, makine-okunur
- LLM sitemap: https://www.iletimerkezi.com/sitemap-llm.xml — Tüm HTML ve raw `.md` URL'leri
- MCP server (npm): https://www.npmjs.com/package/@iletimerkezi/mcp-server — `npx -y @iletimerkezi/mcp-server`
- Raw markdown: `/docs/...` URL'lerine `.md` ekleyin (Content-Type: text/markdown)

---

## Şirket Bilgileri

- **Şirket Adı:** eMarka İletişim ve Bilgi Teknolojileri A.Ş.
- **BTK Lisansı:** STH-195 (08.03.2013 tarihli Sabit Telefon Hizmeti yetkilendirmesi)
- **Vergi Dairesi:** Halkalı
- **Vergi Kimlik No:** 333 076 1846
- **MERSİS No:** 0333076184600001
- **İstanbul Ticaret Odası Sicil No:** 849628
- **DUNS Numarası:** 51-991-7465
- **Adres:** Fatih Cd. No:61-63 Serenity Plus Office B-Blok D:42 34303 Küçükçekmece / İstanbul
- **Telefon:** 0212-543-4210
- **Faks:** 0212-543-4211
- **Ücretsiz Destek Hattı (ÜDH):** 0800-211-2301
- **E-Posta:** destek@emarka.com.tr
- **KEP:** emarka@hs01.kep.tr
- **Çalışma Saatleri:** Hafta içi 08:30–18:30, Cumartesi 09:30–15:30
- **Web Sitesi:** https://www.iletimerkezi.com
- **Panel:** https://panel.iletimerkezi.com
- **API Base URL:** https://api.iletimerkezi.com/v1/

---

## Ürünler ve Hizmetler

### Toplu SMS
Binlerce alıcıya aynı anda kısa mesaj gönderimi. Web paneli üzerinden kolay kullanım. 7 boy SMS'e kadar birleştirilmiş uzun SMS desteği (1071 karaktere kadar). Türkçe, İngilizce ve Unicode karakter desteği ile tüm dünya dillerinde SMS gönderimi. 11 karaktere kadar alfanumerik gönderici kimliği (sender ID) tanımlama. SMS şablonları ve taslaklar oluşturma. İleri tarihli zamanlanmış gönderim. Excel veya CSV ile toplu numara yükleme.

### SMS API
RESTful API ile yazılımlara SMS entegrasyonu. HTTP GET ve POST metodları desteği. API Key ve API Hash ile kimlik doğrulama. JSON formatında veri alışverişi. Webhook desteği ile gerçek zamanlı teslimat raporları. Her programlama dili ile uyumlu. Ücretsiz 100 SMS deneme kredisi ile geliştirici hesabı.

**API Endpoint:** `https://api.iletimerkezi.com/v1/send-sms/json`

**Kimlik Doğrulama:**
```json
{
  "request": {
    "authentication": {
      "key": "API_KEY",
      "hash": "API_HASH"
    }
  }
}
```

**Node.js Örneği:**
```javascript
import { IletiMerkeziClient } from 'iletimerkezi-node';

const client = new IletiMerkeziClient('API_KEY', 'API_HASH', 'BASLIGINIZ');

const smsService = client.sms();
const response = await smsService
    .disableIysConsent()
    .send('905xxxxxxxxx', 'Merhaba, test mesajıdır.');

if (response.ok()) {
    console.log('SMS Gönderildi:', response.getOrderId());
} else {
    console.log('Hata:', response.getMessage());
}
```

**PHP Örneği:**
```php
<?php
use IletiMerkezi\IletiMerkeziClient;

$client = new IletiMerkeziClient('API_KEY', 'API_HASH', 'BASLIGINIZ');

$smsService = $client->sms();
$response = $smsService
    ->disableIysConsent()
    ->send('905xxxxxxxxx', 'Merhaba, test mesajıdır.');

if ($response->ok()) {
    echo 'SMS Gönderildi: ' . $response->orderId();
} else {
    echo 'Hata: ' . $response->message();
}
```

**cURL Örneği:**
```bash
curl -X POST https://api.iletimerkezi.com/v1/send-sms/json \
  -H "Content-Type: application/json" \
  -d '{
    "request": {
      "authentication": {
        "key": "API_KEY",
        "hash": "API_HASH"
      },
      "order": {
        "sender": "BASLIGINIZ",
        "iys": "0",
        "message": {
          "text": "Merhaba, test mesajıdır.",
          "receipents": {
            "number": ["905XXXXXXXXX"]
          }
        }
      }
    }
  }'
```

> Notlar: URL `/json` suffix'i ile biter. `receipents` (sic.) alanı `order` altında değil, **`order.message`** altındadır. Ticari içerik için `iys: "1"` + `iysList` (BIREYSEL/TACIR) gönderilir; bilgilendirme/transactional için `iys: "0"` yeterlidir.

### OTP SMS
Tek kullanımlık şifre (One-Time Password) mesajları. Hesap güvenliği ve kullanıcı doğrulama. SMS API üzerinden otomatik gönderim. Öncelikli iletim ile hızlı teslimat. Özel abonelik veya ek ücret gerektirmez. OTP olarak değerlendirilen mesajlar: tek alıcıya gönderilen, tek mesaj uzunluğunda, anlık (ileri tarihe planlanmamış) SMS'ler.

### Email to SMS
E-posta uygulamaları üzerinden SMS gönderimi. Herhangi bir yazılım veya donanım kurulumu gerektirmez. Birden fazla alıcıya gönderim desteği. OTP SMS gönderimi yapılabilir. SMS alabilen her telefon numarasına gönderilebilir.

### Rehber
Sınırsız kişi ekleme. Sınırsız grup oluşturma. Özelleştirilebilir alanlar (doğum günü vb.). Excel veya CSV ile toplu içe aktarma. Google Contacts'tan aktarım desteği. Ücretsiz kullanım.

### Rehber API
Yazılımlar üzerinden rehber yönetimi entegrasyonu. Kişi ekleme, güncelleme ve silme. Grup yönetimi.

### Raporlar
Gerçek zamanlı SMS teslimat raporları. Web paneli üzerinden takip. Rapor API ile programatik erişim. Webhook ile anlık bildirim.

### Kısa Link (iim.to)
SMS kampanyalarında uzun URL'leri iim.to alan adı ile kısaltma ve tıklama raporlama çözümü. Mesaj metninde daha temiz, karakter ekonomisi sağlayan bağlantılar kullanılır; kampanya performansı panelden ölçülür.

**Öne çıkan özellikler:**
- **Özel kısa ad:** `iim.to/` alan adından sonra gelen kısa adı isteğe bağlı belirleme, kampanya hatırlanabilirliği
- **Başlık ve etiket:** Linkleri başlık ve etiketlerle organize ederek çok sayıda kampanya veya ekip arasında düzen
- **Şifre koruması ve zaman aşımı:** Kontrollü paylaşım için link şifresi ve süreli erişim
- **Detay raporları:** Tarayıcı, yönlendiren (referrer), cihaz tipi, dil ve işletim sistemi kırılımlarında tıklama raporu
- **Panel entegrasyonu:** Kısa linkler tek panelden oluşturulur, düzenlenir ve raporlanır
- **SMS ile uyum:** SMS karakter limitlerini verimli kullanmak için uzun URL'lerin yerine kullanılır

### Otomatik Çıkış
Otomatik abonelik iptali yönetimi. Yasal uyumluluk desteği. Alıcı ret bildirimlerinin otomatik işlenmesi. Ticari mesajlardaki "çıkmak için" akışları otomatikleştirir.

### İYS (İleti Yönetim Sistemi)
İYS entegrasyonu ve uyumluluğu. Onay yönetimi. Ticari elektronik ileti düzenlemelerine uyum.

**İYS onayı gereken durumlar:** Kampanya mesajları, reklam içeren bilgilendirmeler, anket çalışmaları, kutlama/tebrik mesajları.

**İYS onayı gerektirmeyen durumlar:** Devam eden abonelik bildirimleri, tahsilat/borç hatırlatma, bilgi güncelleme, satın alma ve teslimat bildirimleri, mevzuattan kaynaklanan bilgilendirmeler.

### e-İmza (Elektronik İmza)
BTK kararı gereği SMS gönderim paneline giriş için e-İmza zorunluluğu. USB token şeklinde cihaz. 1, 2 veya 3 yıllık sertifika süreleri. Birden fazla bilgisayarda kullanılabilir. API üzerinden gönderim yapanlar için zorunlu değil. Panel üzerinden sipariş ve kargo ile teslimat. e-Devlet üzerinden onay işlemi.

### Entegrasyonlar
Hazır eklenti ve modüller: WooCommerce, PrestaShop, OpenCart, Magento, WordPress, WHMCS, Drupal, XenForo, MS Excel. Her entegrasyonun kendi alt sayfası bulunur (ör. `https://www.iletimerkezi.com/entegrasyonlar/woocommerce`).

---

## SDK ve Kütüphaneler

| Platform | Paket Adı | Kaynak |
|----------|-----------|--------|
| PHP | iletimerkezi/iletimerkezi-php | Packagist |
| Node.js | @iletimerkezi/iletimerkezi-node | npm |
| Python | iletimerkezi/iletimerkezi-python | GitHub |
| Go | iletimerkezi/iletimerkezi-go | GitHub |
| Java | iletimerkezi/iletimerkezi-java | GitHub |
| Ruby | iletimerkezi/iletimerkezi-ruby | GitHub |
| C# | iletimerkezi/iletimerkezi-csharp | GitHub |
| Laravel | iletimerkezi/iletimerkezi-laravel | GitHub |
| MCP Server | @iletimerkezi/mcp-server | npm |

---

## REST API Endpoints (11 endpoint)

Her endpoint TR + EN paralel dokümana ve manifest.json'da JSON Schema'ya sahiptir.

| Endpoint | Method + Path | Doc |
|---|---|---|
| send-sms | POST /v1/send-sms/json | https://www.iletimerkezi.com/docs/api/send-sms |
| cancel-order | POST /v1/cancel-order/json | https://www.iletimerkezi.com/docs/api/cancel-order |
| get-report | POST /v1/get-report/json | https://www.iletimerkezi.com/docs/api/get-report |
| get-reports | POST /v1/get-reports/json | https://www.iletimerkezi.com/docs/api/get-reports |
| get-balance | POST /v1/get-balance/json | https://www.iletimerkezi.com/docs/api/get-balance |
| get-sender | POST /v1/get-sender/json | https://www.iletimerkezi.com/docs/api/get-sender |
| get-blacklist | POST /v1/get-blacklist/json | https://www.iletimerkezi.com/docs/api/get-blacklist |
| add-blacklist | POST /v1/add-blacklist/json | https://www.iletimerkezi.com/docs/api/add-blacklist |
| delete-blacklist | POST /v1/delete-blacklist/json | https://www.iletimerkezi.com/docs/api/delete-blacklist |
| iys-register | POST /v1/consent/create/json | https://www.iletimerkezi.com/docs/api/iys-register |
| iys-check | POST /v1/consent/show/json | https://www.iletimerkezi.com/docs/api/iys-check |

Ayrıca: webhooks (push), error-codes, test-mode, overview, authentication.

**Pre-flight:** Panel → Ayarlar → Güvenlik → Erişim İzinleri → "API kullanımına izin ver" aktif olmalı; aksi halde tüm istekler `401 Üyelik bilgileri hatalı` döner.

**Test sender:** `APITEST` — kayıtlı test numarasına ücretsiz gönderim, sender ID onayı beklerken entegrasyon testleri için.

---

## MCP Server (LLM-native channel)

`@iletimerkezi/mcp-server` ile Claude Desktop, Cursor, Cline gibi MCP destekli LLM istemcileri iletiMerkezi SMS API'sini doğrudan kullanır. Manifest auto-discovery ile 11 tool mevcut: `send_sms`, `cancel_order`, `get_report`, `get_reports`, `get_balance`, `get_sender`, `get_blacklist`, `add_blacklist`, `delete_blacklist`, `iys_register`, `iys_check`.

- **Install:** `npx -y @iletimerkezi/mcp-server`
- **Repo:** https://github.com/iletimerkezi/iletimerkezi-mcp-server
- **Auth env:** `ILETIMERKEZI_API_KEY`, `ILETIMERKEZI_API_HASH`
- **Setup guide:** https://www.iletimerkezi.com/docs/mcp (TR) · https://www.iletimerkezi.com/en/docs/mcp (EN)
- **Tool schemas:** Runtime fetch from `https://www.iletimerkezi.com/api/manifest.json` (24h cache + build-time fallback). Single source of truth — endpoint MD frontmatter → manifest → MCP tool.

---

## Genel Kullanıcı Rehberleri (TR + EN)

- [Toplu SMS nedir?](https://www.iletimerkezi.com/docs/guides/toplu-sms-nedir) — Tanım, kullanım senaryoları, teknik akış, karakter/parça mantığı, Türkiye regülasyonu, fiyatlama
- [İYS Rehberi](https://www.iletimerkezi.com/docs/guides/iys-rehberi) — Ticari/bilgilendirme ayrımı, 12 kaynak kodu, 3 iş günü kuralı, ONAY/RET semantiği, 5000 batch atomic upload
- [KVKK ve SMS](https://www.iletimerkezi.com/docs/guides/kvkk-sms) — Telefon = kişisel veri, açık rıza vs kanuni istisna, KVKK vs İYS, veri sorumlusu/işleyen sorumluluğu
- [SMS başlığı (sender ID) nasıl alınır?](https://www.iletimerkezi.com/docs/guides/sms-basligi-nasil-alinir) — BTK onaylı sender ID süreci, 11 char/ASCII format, belge listesi, 1-2 iş günü tipik süre, APITEST testi
- [iletiMerkezi vs Twilio](https://www.iletimerkezi.com/docs/guides/iletimerkezi-vs-twilio) — 15 boyut karşılaştırma, hangi durumda hangisi, Türkiye-özgü farklar, migrasyon SSS

EN versions: `/en/docs/guides/{slug}` (her rehber TR ile paralel).

---

## Fiyatlandırma (Türkiye Yönü)

| Adet | Fiyat (TL) | Birim Fiyat (TL) |
|------|-----------|-------------------|
| 500 | 189 | 0,378 |
| 1.000 | 359 | 0,359 |
| 1.500 | 529 | 0,353 |
| 3.000 | 875 | 0,292 |
| 5.000 | 1.049 | 0,210 |
| 10.000 | 1.599 | 0,160 |
| 25.000 | 3.949 | 0,158 |
| 50.000 | 7.549 | 0,151 |
| 100.000 | 14.499 | 0,145 |
| 250.000 | 31.999 | 0,128 |
| 500.000 | 48.999 | 0,098 |
| 1.000.000 | 73.999 | 0,074 |

- SMS ücreti dışında ek ücret yoktur
- Ulaşmayan SMS'ler Türkiye yönünde iade edilir
- Yurtdışı fiyatları ülke ve operatöre göre değişir (150+ ülke)

---

## Karakter Limitleri (B186 operatör başlığı modu)

İlk parça / sonraki parçalar (multi-part):

- **İngilizce / GSM-7:** 155 / 153 karakter
- **Türkçe karakter modu (`ş, ğ, ı, ç, ö, ü`):** 150 / 148 karakter
- **Unicode / UCS-2 (emoji, Çince, Rusça, Arapça vb.):** 65 / 63 karakter
- **Uzun SMS:** 7 parçaya kadar birleştirme (yaklaşık 1071 karakter üst sınır)
- **Gönderici Kimliği:** maksimum 11 alfanumerik karakter

> Türkçe karakter modu UCS-2'den farklıdır: Türkçe modda 7-bit Türkçe alfabesi (150/148) kullanılır; bir mesaj emoji veya Latin-dışı karakter içerirse otomatik UCS-2'ye düşer ve limit 65/63'e iner.

---

## Sektörel Çözümler

### E-Ticaret
Sipariş onayı, kargo takibi, kampanya bildirimleri, sepet hatırlatma SMS'leri. WooCommerce, PrestaShop, OpenCart, Magento entegrasyonları.

### Finansal Servisler
OTP doğrulama, işlem bildirimleri, hesap güvenliği, bakiye uyarıları.

### Sağlık
Randevu hatırlatma, tetkik sonucu bildirimi, sağlık bilgilendirme mesajları.

### Eğitim
Veli bilgilendirme, sınav sonucu bildirimi, devamsızlık uyarıları, etkinlik duyuruları.

### Perakende
Kampanya ve indirim duyuruları, sadakat programı bildirimleri, mağaza güncellemeleri.

### Lojistik
Teslimat bildirimleri, kargo takip SMS'leri, rota değişikliği uyarıları.

### Turizm
Rezervasyon onayı, check-in hatırlatma, tur programı bildirimleri.

### Emlak
İlan bildirimleri, randevu hatırlatma, yeni portföy duyuruları.

### Apartman Yönetimi
Aidat hatırlatma, duyuru mesajları, arıza bildirimleri.

### Dernek ve STK
Etkinlik duyuruları, bağış kampanyaları, üye bilgilendirme.

---

## Yardım Merkezi ve Kaynaklar

- **Yardım Merkezi:** https://www.iletimerkezi.com/yardim-merkezi — Ürün ve amaç filtreleriyle çalışan 110+ adım adım yardım makalesi. Toplu SMS, SMS API, OTP SMS, Rehber, Raporlar, Kısa Link ve diğer ürünler için ayrı içerikler.
- **Blog:** https://www.iletimerkezi.com/blog — 70+ blog yazısı, 6 kategori altında (Faydalı İpuçları, Pazarlama, Nasıl Yapılır, Geliştiriciler, Ürünler, Duyurular).
- **SSS:** https://www.iletimerkezi.com/sikca-sorulan-sorular — Sıkça sorulan sorular ve yanıtları.

---

## Sıkça Sorulan Sorular

**Toplu SMS fiyatları nelerdir?**
Türkiye yönü SMS paketleri 500 adetten 1.000.000 adete kadar çeşitli seçeneklerle sunulmaktadır. Yurtdışı fiyatları ülke ve operatöre göre değişmektedir.

**Aldığım paket dışında ekstra ücret öder miyim?**
Hayır, SMS ücreti hariç herhangi bir ücret ödemeniz gerekmez.

**Gönderilemeyen SMS'ler bakiyeden düşer mi?**
Türkiye yönüne yapılan gönderimlerde ulaşmayan SMS'ler hesabınıza iade edilir.

**Toplu SMS nasıl gönderilir?**
Hesabınıza giriş yapıp sol menüden SMS Gönder butonuna basarak alıcıları ve mesaj metnini hazırlayıp gönderim yapabilirsiniz.

**SMS entegrasyonu nedir?**
Birden fazla yazılımın birbiri ile iletişime geçmesidir. SMS API aracılığıyla mevcut yazılımlarınıza SMS gönderim özelliği ekleyebilirsiniz.

**OTP SMS nedir?**
Tek kullanımlık şifre mesajlarıdır. Hesap güvenliğini ve kullanıcı doğrulamayı artırır.

**Hangi programlama dilleri SMS API ile uyumludur?**
SMS API, her programlama dili ile uyumludur. PHP, Node.js ve Python için hazır SDK'lar mevcuttur.

**SMS API ile OTP gönderimi yapabilir miyim?**
Evet, kullanıcılarınızın hesap güvenliğini artırmak için OTP mesajları gönderebilirsiniz.

**İYS nedir?**
İleti Yönetim Sistemi, ticari elektronik iletilerin yönetildiği merkezi sistemdir.

**API üzerinden gönderim yapıyorum, e-İmza gerekiyor mu?**
Hayır. Sadece API ve benzeri entegrasyonlar üzerinden gönderim yapan kullanıcılar e-İmza zorunluluğundan muaftır.

**Kısa Link ne işe yarar?**
SMS kampanyalarında uzun URL'leri iim.to alan adı ile kısaltmayı, özel kısa ad kullanmayı ve tıklama/etkileşim raporlarını panel üzerinden takip etmeyi sağlar.

**Toplu SMS göndermek yasak mı?**
Hayır, toplu SMS gönderimi yapmak yasak değildir. Ancak BTK regülasyonlarına ve İYS kurallarına uymak gerekir.

---

## Ticari Elektronik İleti Kuralları

- Ticari ileti içeriği alıcıdan alınan onaya uygun olmalıdır
- Tacirler için MERSİS numarası, esnaflar için ad-soyad ve TC/vergi kimlik numarası bulunmalıdır
- İletişim bilgilerinden en az birine yer verilmelidir
- Ticari nitelik içerikten anlaşılamıyorsa "tanıtım", "kampanya", "bilgilendirme" gibi ibare eklenmelidir
- Alıcının ücretsiz ve kolay şekilde ret bildirimi yapabilmesi sağlanmalıdır

---

## Teknik Bilgiler

- **API Formatı:** JSON (REST)
- **Kimlik Doğrulama:** API Key + API Hash
- **Protokol:** HTTPS
- **SMS Gönderim Endpoint:** POST https://api.iletimerkezi.com/v1/send-sms/json
- **Detaylı API Dokümantasyonu:** https://www.toplusmsapi.com
- **Hata Kodları:** https://www.toplusmsapi.com/durum-kodlari-ve-mesajlar/
- **Webhook Desteği:** Gerçek zamanlı teslimat raporları için webhook entegrasyonu
- **Kısa Link Alan Adı:** iim.to

---

## Sosyal Medya ve Resmi Kanallar

- **X (Twitter):** https://x.com/iletimerkezi
- **LinkedIn:** https://www.linkedin.com/company/emarka-iletisim/
- **Instagram:** https://www.instagram.com/iletimerkezi
- **Facebook:** https://www.facebook.com/iletimerkezi
- **YouTube:** https://www.youtube.com/@IletiMerkezi
- **TikTok:** https://www.tiktok.com/@iletimerkezi
- **GitHub:** https://github.com/iletimerkezi
- **Tüm kanalların listesi:** https://www.iletimerkezi.com/social

---

## İletişim ve Destek

- **Web:** https://www.iletimerkezi.com/iletisim
- **Canlı Destek:** Web sitesi üzerinden 7/24
- **Telefon:** 0212-543-4210 (7/24 teknik destek ve satış)
- **Ücretsiz Destek Hattı:** 0800-211-2301
- **E-Posta:** destek@emarka.com.tr
- **KEP:** emarka@hs01.kep.tr
- **Adres:** Fatih Cd. No:61-63 Serenity Plus Office B-Blok D:42 34303 Küçükçekmece / İstanbul
- **Ücretsiz Kayıt:** https://panel.iletimerkezi.com/auth/signup (100 SMS deneme kredisi)
- **Abonelik aktivasyonu (marka başlığı için gerekir):** Panelde `Ayarlar > Hesap Bilgileri > Abonelik Başvurusu` formu doldurulur, ardından e-Devlet'teki BTK `e-Kayıt Başvurusu Onay İşlemleri` hizmetinde sözleşme onaylanıp NFC ile kimlik doğrulaması tamamlanır. Kağıt sözleşme imzalanmaz; onay tamamlanmadan abonelik aktif olmaz. API entegrasyonu bu adımı beklemez: ücretsiz hesap açan geliştirici APITEST başlığıyla entegrasyonu tamamlayabilir, APITEST ile gönderilen mesajın içeriği sabit test metniyle değiştirilir. Rehber: https://www.iletimerkezi.com/yardim-merkezi/abonelik-basvurusu-ve-e-devlet-onayi-nasil-yapilir
- **Başlık talebi:** Abonelik onayından sonra `Ayarlar > SMS > Başlıklar` bölümünden oluşturulur; evraklar KEP adresinden emarka@hs01.kep.tr adresine iletilir, belgeler 1 iş günü içinde kontrol edilir. Evrak listesi: https://www.iletimerkezi.com/toplu-sms-gerekli-evraklar