Sumber Daya · Pusat Pengembang

Penyedia Pengiriman Email

Kirim melalui penyedia email yang sudah Anda jalankan. Seorang admin mengkonfigurasi satu atau lebih penyedia dan fallback yang terurut di back office; Flash mengirim melalui mereka sebagai waterfall yang selalu berakhir di layanan email terkelola platform. Penyedia tersebut hanya merupakan transport swap — Flash masih menyisipkan pelacakan, personalisasi, cabang A/B, dan penanganan berhenti berlangganan sendiri, sehingga tidak ada yang berubah tentang bagaimana kampanye dibangun atau diukur.

Jadwalkan Demo Jelajahi API

Apa yang dapat Anda hubungkan

Dikonfigurasi di bawah Pengaturan → Penyedia Email oleh administrator organisasi — tidak pernah per-kampanye oleh pemasar.

SendGrid

Hubungkan akun SendGrid Anda dengan kunci API. Flash mengirim melalui email v3 API.

Amazon SES (akun Anda)

Gunakan akun AWS SES Anda sendiri (kunci akses / wilayah / diverifikasi dari). Berbeda dari SES cadangan platform.

REST Kustom — ESP apa pun

Arahkan Flash ke pengiriman JSON API penyedia mana pun dengan peta bidang. Tidak ada adaptor yang perlu ditunggu.

Relay SMTP mentah ada dalam rencana pengembangan, belum tersedia — hubungkan melalui API penyedia untuk saat ini.

Waterfall cadangan

Setiap pengiriman mencoba penyedia Anda dalam urutan prioritas yang Anda tetapkan; penyedia yang gagal atau tidak tersedia akan dilewati dan pengiriman akan diteruskan ke penyedia berikutnya. Layanan email terkelola platform selalu menjadi cadangan terakhir.

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

Hubungkan ESP apa pun dengan komunitas Kustom REST

Jika penyedia Anda tidak terintegrasi, hubungkan melalui API pengirimannya — berikan titik akhir, header otentikasi, dan peta bidang. Tanpa kode, tanpa adaptor untuk dibangun.

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

Sinkronkan pembatalan berlangganan kembali ke Flash

Saat Anda mengirim melalui penyedia Anda sendiri, opt-out dapat ditangkap di luar Flash — oleh ESP Anda, pusat preferensi Anda, atau formulir. Dorong kembali dengan Berhenti Berlangganan API sehingga Flash menekan alamat tersebut pada setiap pengiriman. Anda juga dapat membaca status opt-out suatu alamat. Otentikasi dengan kunci API penyewa; email adalah identitasnya.

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

Bagaimana kredensial dijaga keamanannya

Dienkripsi saat tidak aktif

Setiap rahasia penyedia dienkripsi segera (AES-256-GCM) dan tidak pernah dikembalikan oleh API atau ditampilkan lagi — hanya dapat ditulis di UI.

Hanya untuk admin

Hanya pemilik/admin organisasi yang dapat menambah, menyusun ulang, menguji, atau menghapus penyedia. Pemasar tidak pernah melihat atau memilih penyedia.

Hanya Transportasi

Penyedia menyampaikan pesan; Flash masih memiliki pelacakan, personalisasi, A/B, header berhenti berlangganan, dan batasan frekuensi — ganti penyedia tanpa mengubah apa pun.

Aman secara default

Jika konfigurasi penyedia tidak dapat dibaca, atau semua penyedia gagal, pengiriman akan kembali ke layanan email terkelola platform — pengiriman tidak pernah terhenti.

Lihat juga: Pengiriman lintas saluran · REST API

Menggunakan penyedia email Anda sendiri?

Bicaralah dengan seorang insinyur tentang ESP Anda, kemampuan pengiriman, strategi cadangan, atau menghubungkan penyedia melalui API.

Bicara dengan bagian teknik