Sumber · Pusat Pembangun

Penyedia Penghantaran E-mel

Hantar melalui penyedia e-mel yang telah anda jalankan. Pentadbir mengkonfigurasi satu atau lebih penyedia dan sandaran tersusun di pejabat belakang; Flash menghantar melalui mereka sebagai air terjun yang sentiasa berakhir pada perkhidmatan e-mel terurus platform. Penyedia tersebut hanyalah swap pengangkutan — Flash masih menyuntik penjejakan, pemperibadian, cawangan A/B dan pengendalian berhenti melanggan sendiri, jadi tiada apa yang berubah tentang cara kempen dibina atau diukur.

Tempah demo Layari API

Apa yang anda boleh sambungkan

Dikonfigurasikan di bawah Tetapan → Penyedia E-mel oleh pentadbir organisasi — tidak pernah setiap kempen oleh pemasar.

SendGrid

Sambungkan akaun SendGrid anda dengan kunci API. Flash menghantar melalui mel v3 API.

Amazon SES (akaun anda)

Bawa akaun AWS SES anda sendiri (kunci akses / rantau / disahkan daripada). Berbeza daripada SES sandaran platform.

Tersuai REST — sebarang ESP

Titik Flash pada mana-mana penghantaran JSON pembekal API dengan peta medan. Tiada penyesuai untuk menunggu.

Relay SMTP mentah sedang dalam pelan tindakan, belum tersedia — sambungkan melalui API pembekal buat masa ini.

Air terjun sandaran

Setiap penghantaran mencuba penyedia anda dalam susunan keutamaan yang anda tetapkan; penyedia yang gagal atau tidak tersedia dilangkau dan penghantaran jatuh ke yang seterusnya. Perkhidmatan e-mel terurus platform sentiasa menjadi sandaran terminal.

// 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 mana-mana ESP dengan Tersuai REST

Jika pembekal anda tidak terbina dalam, sambungkannya dengan hantarannya API — berikan titik akhir, pengepala pengesahan dan peta medan. Tiada kod, tiada penyesuai untuk dibina.

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

Segerakkan penyahlanggan kembali ke Flash

Apabila anda menghantar melalui penyedia anda sendiri, pilihan keluar mungkin dirakam di luar Flash — oleh ESP anda, pusat pilihan anda atau borang. Tolaknya ke belakang dengan Nyah Langgan API supaya Flash menyekat alamat tersebut pada setiap penghantaran. Anda juga boleh membaca status pilihan keluar alamat. Pengesahan dengan kunci penyewa API; e-mel adalah identiti.

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

Cara kelayakan disimpan dengan selamat

Disulitkan semasa rehat

Setiap rahsia pembekal disulitkan serta-merta (AES-256-GCM) dan tidak pernah dikembalikan oleh API atau ditunjukkan lagi — tulis sahaja dalam UI.

Pentadbir sahaja

Hanya pemilik organisasi/pentadbir boleh menambah, memesan semula, menguji atau mengalih keluar penyedia. Pemasar tidak pernah melihat atau memilih penyedia.

Pengangkutan sahaja

Penyedia membawa mesej; Flash masih memiliki penjejakan, pemperibadian, A/B, pengepala nyahlanggan dan had frekuensi — tukar penyedia tanpa mengubah mana-mana daripadanya.

Selamat secara lalai

Jika konfigurasi pembekal tidak dapat dibaca, atau setiap pembekal gagal, penghantaran akan kembali kepada perkhidmatan e-mel terurus platform — penghantaran tidak akan terhenti.

Lihat juga: Penyampaian rentas saluran · REST API

Membawa pembekal e-mel anda sendiri?

Bercakap dengan jurutera tentang ESP, kebolehhantaran, strategi sandaran atau menghubungkan pembekal anda dengan API.

Bercakap dengan jurutera