SenderTR Dokümantasyon

SenderTR Dokümantasyon

Türkiye'nin inbox-odaklı, KVKK uyumlu e-posta pazarlama platformu. Bu rehber hem panelin nasıl kullanılacağını hem de REST API ile entegrasyonu adım adım anlatır.

Yeni misiniz? Hızlı Başlangıç ile 5 dakikada ilk kampanyanızı gönderin.

Bu dokümantasyonda neler var?

Temel kavramlar

KavramAçıklama
KrediGönderilen her e-posta 1 kredi düşer. Krediler süresizdir.
KampanyaBir listeye/segmente tek seferlik toplu gönderim.
OtomasyonTetikleyiciye bağlı otomatik e-posta akışı (hoşgeldin, doğum günü vb.).
TransactionalSipariş onayı, şifre sıfırlama gibi işlemsel e-postalar (API/SMTP ile).
Sending DomainAdınıza e-posta gönderdiğimiz, DNS doğrulaması yapılmış alan adı.

Hızlı Başlangıç

5 adımda ilk kampanyanızı gönderin.

  1. Hesap oluşturun. app.sendertr.com/register üzerinden kaydolun. Kayıtta 1.000 e-posta kredisi hediye gelir.
  2. Domain ekleyin & doğrulayın. Ayarlar → Domainler'den gönderim alan adınızı ekleyin ve verilen SPF/DKIM/DMARC kayıtlarını DNS'e işleyin. (Detay)
  3. Kişilerinizi yükleyin. Kişiler → İçe Aktar ile CSV/Excel dosyanızı yükleyin ya da tek tek ekleyin. (Detay)
  4. Kampanya oluşturun. Kampanyalar → Yeni Kampanya: gönderen domaini, konu ve içeriği belirleyin. (Detay)
  5. Onaya gönderin / gönderin. Sender Contract ön kontrolünden geçen kampanya zamanlanır veya hemen gönderilir.
İpucu: İlk gönderiminizden önce domaininizin DNS sağlık skorunun yeşil olduğundan emin olun — bu, gelen kutusuna ulaşma oranını doğrudan etkiler.

Domain & DNS Doğrulama

E-postaları kendi alan adınızdan göndermek için domaini ekleyip DNS kayıtlarını doğrulamanız gerekir. Bu, hem teslim edilebilirlik hem de yasal gönderen kimliği için zorunludur.

Adımlar

  1. Ayarlar → Domainler → "Domain Ekle".
  2. Sistem size 3 DNS kaydı üretir: SPF (TXT), DKIM (TXT, 2048-bit) ve DMARC (TXT).
  3. Bu kayıtları alan adınızın DNS yönetim panelinde oluşturun.
  4. "Doğrula" butonuna basın. Yayılma birkaç dakika–saat sürebilir.
Önemli: Doğrulanmamış (sağlık skoru 0) domainler kampanya gönderiminde kullanılamaz. Domain sağlık skoru panelde sürekli izlenir.

Krediler & Faturalandırma

SenderTR kullandıkça-öde modeliyle çalışır: gönderilen her e-posta 1 kredi düşer ve krediler süresizdir (aylık abonelik zorunluluğu yoktur).

Kredi paketleri

PaketE-postaFiyat (+KDV)
Başlangıç10.000₺250
Standart50.000₺1.100
Profesyonel100.000₺1.900
İşletme250.000₺4.250
Kurumsal500.000₺7.500
Enterprise1.000.000+₺12.500 / özel

Krediler Krediler → Paket Satın Al menüsünden PayTR ile güvenli şekilde alınır. Bakiye %80, %95 ve %100 eşiklerinde uyarılır.

Kampanyalar

Bir liste veya segmente tek seferlik toplu e-posta gönderimi. Kampanyalar bir onay (Sender Contract) sürecinden geçer.

Kampanya oluşturma

  1. Kampanyalar → Yeni Kampanya.
  2. Gönderen domaini seçin (DNS doğrulanmış olmalı), gönderen adı/e-posta ve konu girin. E-postanın yerel kısmını yazmanız yeterli — @alanadi.com otomatik eklenir.
  3. İçeriği sürükle-bırak editör veya bir şablonla hazırlayın. Konu için AI Öner ile öneri alabilirsiniz (OpenAI yapılandırılmışsa).
  4. Alıcı liste/segment seçin.
  5. Taslak Olarak Kaydet veya Onaya Gönder.

Durumlar

draftsubmittedapprovedscheduled/queuedsendingcompleted. Yan durumlar: rejected, paused, stopped.

A/B Testi: Konu satırının iki varyantını test edebilir, kazananı kalan alıcılara otomatik gönderebilirsiniz.
Send Time Optimization: Açıksa, her kişiye en yüksek açılma olasılığı olan saatte gönderim yapılır.

Şablonlar

Tekrar kullanılabilir e-posta tasarımları. Sürükle-bırak editör (EmailBuilder.js) ile kod bilmeden tasarlayın.

  • Şablonlar → Yeni Şablon ile görsel editörü açın.
  • Bloklar (metin, görsel, buton, ayraç) sürükleyin; {{first_name}} gibi merge tag'lerle kişiselleştirin.
  • Kampanya oluştururken şablonu seçin; "yeni şablon oluştur" linki yeni sekmede açılır, kampanya formunuz korunur.

Kişiler & Listeler

Aboneleriniz "kişi", grupları ise "liste" olarak yönetilir.

Kişi ekleme

  • Tek tek: Kişiler → Yeni Kişi. E-posta zorunlu; ad, soyad, telefon, şehir ve liste seçimi opsiyonel.
  • Toplu içe aktarma: Kişiler → İçe Aktar. CSV veya Excel (xlsx) yükleyin, kolonları eşleyin (e-posta eşlemesi zorunlu), hedef liste seçin. İçe aktarma arka planda işlenir; tamamlanınca bildirim alırsınız.

Listeye kişi ekleme

Bir listeye girip "Kişi Ekle" ile yeni kişi oluşturabilir veya mevcut kişileri "Kişi Aktar" ile listeye taşıyabilirsiniz.

Suppression: Abonelikten çıkan, sert bounce veren veya şikayet eden adresler kalıcı olarak engellenir ve hiçbir şekilde gönderim yapılmaz.

Segmentler

Kurallara göre dinamik kişi grupları. Örn: "son 90 günde açan", "İstanbul'daki kişiler", "etkileşim puanı > 50".

Segment kuralları e-posta, şehir, ülke, durum, etkileşim puanı, son açılma/tıklama, doğrulama durumu gibi alanlar üzerinde tanımlanır ve kampanya hedeflemede kullanılır.

Otomasyonlar

Tetikleyiciye bağlı, otomatik çalışan e-posta akışları.

Otomasyon oluşturma

  1. Otomasyonlar → Yeni Otomasyon. Ad ve tetikleyici seçin.
  2. Tetikleyiciler: Kişi eklendi, etikete eklendi, tarih alanı (ör. doğum günü), form gönderildi, e-ticaret olayı (sipariş/sepet).
  3. Adımları tanımlayın: e-posta, gecikme, koşul, aksiyon.
  4. Gönderen domaini ve e-postayı belirleyin (yerel kısım + otomatik @domain).
  5. Otomasyonu etkinleştirin.

Hazır şablonlar

Hoşgeldin serisi, doğum günü, yeniden etkileşim, satın alma sonrası, etkinlik, lead besleme.

Silme: Taslak ve duraklatılmış otomasyonlar silinebilir. Aktif otomasyonu silmek için önce duraklatın.

Formlar

Web sitenize gömülebilen abone kayıt formları. Ziyaretçiler form doldurarak listenize eklenir.

  1. Formlar → Yeni Form. Form adı verin.
  2. Alanları ekleyin (her alana ad ve etiket zorunlu). En az bir e-posta alanı olmalı.
  3. Kayıtların ekleneceği listeyi seçin.
  4. Oluşan gömme kodunu (embed) web sitenize yapıştırın.
Double Opt-in: Formdan gelen kişiler için onay e-postası gönderilerek izinli liste oluşturulabilir.

Landing Page

Kampanyalarınız için açılış sayfaları oluşturun.

  1. Sayfalar → Yeni Sayfa. Başlık, slug ve içerik (HTML) girin.
  2. Sayfayı Onaya Gönder.
  3. İçerik moderasyon ekibimizce incelenir; onaylanınca /p/{slug} adresinden yayınlanır.
Moderasyon: İçerikte hukuka aykırı unsur olmaması için her sayfa yayından önce onaydan geçer. Onaylı bir sayfayı düzenlerseniz tekrar onaya gönderilir ve onaylanana kadar yayından kalkar.

E-posta Doğrulama

Listelerinizi temiz tutmak için e-posta adreslerini gönderim öncesi doğrulayın. MX kontrolü, SMTP el sıkışması, geçici (disposable) ve rol adresi tespiti yapılır.

  • Tek adres: Doğrulama sayfasından bir e-posta sorgulayın.
  • Toplu: Bir listeyi topluca doğrulayın.
  • Sonuçlar: valid, invalid, risky, disposable, role, unknown.

Tüm doğrulama lokal yapılır, dış servise veri gönderilmez (KVKK uyumlu).

Raporlar

Gönderim performansınızı detaylı izleyin.

  • Kampanya raporları: Açılma, tıklama, bounce, şikayet, teslim oranları.
  • Link tıklama (heatmap): Hangi linke kim tıkladı.
  • Coğrafi & cihaz: Açılmaların ülke/şehir ve cihaz/e-posta istemcisi dağılımı.
  • Deliverability & DMARC: SPF/DKIM hizalama ve itibar raporları.

Ekip & Roller

Ayarlar → Ekip'ten ekip üyesi davet edin. Davet edilen kişiye e-posta ile bağlantı gider; kabul edince hesabınıza katılır.

RolYetki
OwnerTam yetki (hesap sahibi)
AdminTüm yönetim, faturalandırma dahil
MarketerKampanya, otomasyon, içerik
UploaderKişi & liste yönetimi
ViewerSalt görüntüleme

Deliverability — Gelen Kutusuna Ulaşmak

SenderTR'nin en güçlü yanı teslim edilebilirliktir. Başarılı gönderim için:

  • SPF / DKIM / DMARC: Domain doğrulamada otomatik üretilir; üçü de geçerli olmalı.
  • IP Warmup: Yeni gönderim IP'leri 30 günlük kademeli ısıtma planıyla itibar kazanır.
  • Liste hijyeni: Doğrulanmamış/etkileşimsiz adresleri temizleyin; bounce > %5, şikayet > %0,3 itibarı düşürür.
  • İçerik: Spam skoru analizi ile gönderim öncesi riskli içerikleri tespit edin.
  • One-Click Unsubscribe (RFC 8058): Gmail/Yahoo gereksinimlerine tam uyum.

API Genel Bakış

SenderTR REST API ile transactional e-posta gönderebilir, adres doğrulayabilir ve pazarlama verilerinizi (kişi/liste/kampanya) programatik yönetebilirsiniz.

Temel URL: https://api.sendertr.com/v1

Tüm istekler JSON, kimlik doğrulama API anahtarı ile yapılır. Rate limit: transactional 300/dk, genel API 60/dk.

API anahtarınızı Ayarlar → API / Entegrasyon'dan oluşturun. Her anahtara yetki (scope) atayabilirsiniz.

Kimlik Doğrulama

İstek başlığında API anahtarınızı gönderin:

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Yetki kapsamları (scope)

Her anahtar yalnızca atanan yetkilerde işlem yapar: send, verify, contacts:read, contacts:write, lists:read, lists:write, segments:read, campaigns:read, campaigns:write. Yetki dışı istek 403 insufficient_scope döner.

Transactional E-posta Gönderimi

POST /v1/send — Sipariş onayı, şifre sıfırlama gibi işlemsel e-postalar.

POST https://api.sendertr.com/v1/send
Authorization: Bearer YOUR_API_KEY

{
  "from": "siparis@sirketiniz.com",
  "to": "musteri@example.com",
  "subject": "Siparişiniz alındı",
  "html": "<h1>Teşekkürler!</h1><p>Siparişiniz hazırlanıyor.</p>"
}

Gönderim durumu için: GET /v1/messages/{messageId} ve listelemek için GET /v1/messages.

Doğrulama API

POST /v1/verify — tek adres; POST /v1/verify/bulk — toplu.

POST https://api.sendertr.com/v1/verify
{ "email": "test@example.com" }

// Yanıt
{ "email":"test@example.com", "result":"valid", "score":95, "disposable":false, "role":false }

Marketing CRUD API

Kişi, liste, segment ve kampanyalarınızı programatik yönetin. (İlgili scope gerekir.)

MethodEndpointAçıklama
GET/v1/contactsKişileri listele (filtre: list_id, status, search)
GET/v1/contacts/{id}Tek kişi
POST/v1/contactsKişi oluştur/güncelle (upsert)
PUT/v1/contacts/{id}Kişi güncelle
DEL/v1/contacts/{id}Kişi sil
GET/v1/listsListeler
POST/v1/listsListe oluştur
GET/v1/segmentsSegmentler
GET/v1/campaignsKampanyalar + istatistik
POST/v1/campaignsTaslak kampanya oluştur
İzolasyon: Her anahtar yalnızca kendi hesabınızın verisine erişir; başka hesabın kaydı istenirse 404 döner.

Webhook'lar

E-posta olaylarını kendi sisteminize anlık iletin. Ayarlar → Webhook'lar'dan endpoint ekleyin.

Event türleri

delivered, bounced, opened, clicked, unsubscribed, complained

İmza doğrulama (HMAC)

Her istek X-Webhook-Signature başlığında HMAC-SHA256 imzası taşır. Webhook oluştururken bir kez gösterilen secret ile gövdeyi doğrulayın:

signature = HMAC_SHA256(secret, request_body)
// X-Webhook-Signature başlığıyla eşleşmeli
Başarısız teslimatlar 3 kez yeniden denenir; sürekli hata veren endpoint otomatik devre dışı bırakılır.

SMTP Relay

API yerine SMTP tercih ediyorsanız, transactional e-postaları relay üzerinden gönderebilirsiniz.

AyarDeğer
Sunucusmtp.sendertr.com
Port587 (STARTTLS)
Kullanıcı adıSMTP kimlik bilgisi (panelden)
ŞifreSMTP kimlik bilgisi (panelden)

SMTP kimlik bilgilerinizi Ayarlar → API / Entegrasyon'dan oluşturun.

Sıkça Sorulan Sorular

Krediler süreli mi?

Hayır, krediler süresizdir. Aylık abonelik zorunluluğu yoktur.

E-postalarım neden spam'e düşüyor?

Genelde eksik DNS doğrulaması (SPF/DKIM/DMARC) veya kötü liste hijyeni nedeniyle. Domain sağlık skorunuzu ve Deliverability bölümünü kontrol edin.

API anahtarımı nereden alırım?

Ayarlar → API / Entegrasyon. Her anahtara yetki kapsamı atayabilirsiniz.

Verilerim güvende mi?

Tüm sunucular Türkiye'de, %100 KVKK uyumlu. Veriler yurt dışına çıkmaz, doğrulama lokal yapılır.

Daha fazla yardım?

destek@sendertr.com veya panel içi destek.