SocialHub.AI
Kaynaklar · Geliştirici Merkezi

E-posta Dağıtımı Sağlayıcıları

Zaten kullandığınız e-posta sağlayıcıları üzerinden gönderin. Bir yönetici, arka ofiste bir veya daha fazla sağlayıcıyı ve sıralı bir yedeklemeyi yapılandırır; Flash, her zaman platformun yönetilen e-posta hizmetinde sonlanan bir şelale olarak bunlar üzerinden gönderim yapar. Sağlayıcı yalnızca bir taşıma değişimidir — Flash yine de izleme, kişiselleştirme, A/B dallanmaları ve abonelikten çıkma işlemlerini kendisi ekler, bu nedenle bir kampanyanın nasıl oluşturulduğu veya ölçüldüğü konusunda hiçbir şey değişmez.

Bağlanabilecekleriniz

Kuruluş yöneticisi tarafından Ayarlar → E-posta Sağlayıcıları altında yapılandırılır; pazarlamacı tarafından kampanya bazında asla yapılandırılmaz.

SendGrid

SendGrid hesabınızı bir API anahtarıyla bağlayın. Flash, v3 posta API aracılığıyla gönderir.

Amazon SES (hesabınız)

Kendi AWS SES hesabınızı getirin (erişim anahtarı / bölge / doğrulandığı yer). Platformun geri dönüş SES'inden farklı.

Özel REST — herhangi bir ESP

Herhangi bir sağlayıcının JSON gönderimine API alan haritasıyla Flash işaret edin. Beklenecek adaptör yok.

Ham SMTP geçişi yol haritasında yer alıyor, henüz kullanılamıyor; şimdilik bir sağlayıcının API aracılığıyla bağlanın.

Yedek şelale modeli

Her gönderim, sağlayıcılarınızı belirlediğiniz öncelik sırasına göre dener; Arızalı veya kullanılamayan bir sağlayıcı atlanır ve teslimat bir sonrakine düşer. Platformun yönetilen e-posta hizmeti her zaman terminalin geri dönüşüdür.

// Providers are tried in the priority order an admin sets. The list ALWAYS ends at
// the platform's managed Amazon SES account (the terminal fallback), which uses its
// own verified from-address so a fallback never bounces on an unverified domain.
Priority 1  →  SendGrid            (your account)
Priority 2  →  Amazon SES          (your own AWS account)
Priority 3  →  Custom REST         (any ESP with a send API)
Terminal    →  Platform Amazon SES (always on — the safety net)
// A provider that errors or is circuit-broken is skipped; delivery falls to the next.

Herhangi bir ESP'yi Özel REST ile bağlayın

Sağlayıcınız yerleşik değilse, gönderme API yoluyla bağlayın — uç noktayı, kimlik doğrulama başlığını ve bir alan eşlemesini sağlayın. Kod yok, adaptör oluşturmaya gerek yok.

// A "Custom REST" provider connects ANY ESP that exposes a JSON send API — no
// code, just configuration. An admin supplies the endpoint, the auth header, and a
// field map; Flash builds the request per message. Example (a generic ESP):
{
  "provider": "custom_rest",
  "config": {
    "endpoint":    "https://api.your-esp.com/v1/send",
    "authHeader":  "Authorization",
    "authScheme":  "Bearer",              // → "Authorization: Bearer <apiKey>"
    "toField":     "to",
    "fromField":   "from",
    "subjectField":"subject",
    "htmlField":   "html"
  },
  "secret": { "apiKey": "sk_live_…" }      // encrypted at rest; never returned
}
// Per send, Flash POSTs: { "to": "...", "from": "...", "subject": "...", "html": "..." }
// with the auth header applied. 401/403 → credentials error (skip to next provider),
// 5xx/timeout → transient (skip to next provider). The HTML already carries Flash's
// own tracking pixel + link redirects, so opens/clicks keep working.

Senkronizasyon, abonelikten çıkmayı tekrar Flash'a geri döndürür

Kendi sağlayıcılarınız aracılığıyla gönderim yaptığınızda, çıkışlar Flash dışında ESP'niz, tercih merkeziniz veya bir form tarafından yakalanabilir. Aboneliği İptal Et API ile bunları geri gönderin, böylece Flash her gönderimde bu adresi bastırır. Ayrıca bir adresin devre dışı kalma durumunu da okuyabilirsiniz. Kiracı API anahtarıyla kimlik doğrulaması yapın; e-posta kimliktir.

// Push an opt-out INTO Flash — from your ESP's unsubscribe webhook, your own
// preference center, or a third-party form. Flash then suppresses this address on
// EVERY campaign send (the same signal the audience resolver checks). Idempotent.
POST https://flash.socialhub.ai/api/v2/members/unsubscribe
Authorization: Bearer fl_live_…            // scope: members:write
Content-Type: application/json
{ "email": "ada@acme.com" }
// → 200  { "data": { "email": "ada@acme.com", "unsubscribed": true } }

// Read an address's opt-out status (e.g. reconcile before a bulk send):
GET https://flash.socialhub.ai/api/v2/members/unsubscribe?email=ada@acme.com
Authorization: Bearer fl_live_…            // scope: members:read
// → 200  { "data": { "email": "ada@acme.com", "unsubscribed": true } }

// Re-subscribing is deliberately NOT an API toggle — re-granting marketing consent
// needs provable opt-in (CAN-SPAM / CASL), so it goes through the member's own
// consent flow, never this endpoint.

Kimlik bilgileri nasıl güvende tutulur?

Dinlenme sırasında şifrelendi

Her sağlayıcı gizli anahtarı anında şifrelenir (AES-256-GCM) ve API tarafından asla geri döndürülmez veya tekrar gösterilmez — kullanıcı arayüzünde yalnızca yazma işlemine izin verilir.

Sadece yöneticiler için

Yalnızca kuruluş sahipleri/yöneticiler sağlayıcıları ekleyebilir, yeniden sıralayabilir, test edebilir veya kaldırabilir. Pazarlamacılar asla bir sağlayıcıyı görmez veya seçmez.

Sadece Taşıma

Sağlayıcılar mesajı taşır; Flash hala izleme, kişiselleştirme, A/B testleri, abonelikten çıkma başlıkları ve frekans sınırlamalarına sahiptir — hiçbirini değiştirmeden bir sağlayıcıyı değiştirebilirsiniz.

Varsayılan olarak güvenli

Bir sağlayıcının yapılandırması okunamıyorsa veya tüm sağlayıcılar başarısız olursa dağıtım, platformun yönetilen e-posta hizmetine kalır; gönderim hiçbir zaman durmaz.

Ayrıca bakınız: Çapraz kanal teslimatı · REST API

Kendi e-posta sağlayıcınızı mı getiriyorsunuz?

ESP'niz, teslim edilebilirlik, yedekleme stratejiniz veya bir sağlayıcıyı API ile bağlama konusunda bir mühendisle konuşun.

Mühendislikle konuş