연결할 수 있는 것들
설정 → 이메일 제공업체에서 조직 관리자가 구성합니다. 마케터가 캠페인별로 설정하는 경우는 없습니다.
SendGrid
API 키를 사용하여 SendGrid 계정을 연결하세요. Flash은 v3 메일 API을 통해 메시지를 전송합니다.
아마존 SES(귀하의 계정)
자신의 AWS SES 계정(액세스 키/리전/인증된 계정)을 가져오세요. 플랫폼의 대체 SES와는 다릅니다.
커스텀 REST — 모든 ESP
필드 맵이 포함된 모든 공급자의 JSON 전송 API을 Flash로 가리키세요. 어댑터를 기다릴 필요가 없습니다.
원시 SMTP 릴레이는 로드맵에 있지만 아직 사용할 수 없습니다. 지금은 공급자의 API을 통해 연결하세요.
폴백 워터폴
각 전송은 귀하가 설정한 우선 순위에 따라 공급자를 시도합니다. 실패하거나 사용할 수 없는 공급자는 건너뛰고 배달은 다음 공급자로 넘어갑니다. 플랫폼의 관리형 이메일 서비스는 항상 터미널 대체 서비스입니다.
// 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.Custom REST를 사용하여 모든 ESP를 연결하세요
공급자가 내장되어 있지 않은 경우, 전송 API을 통해 연결하세요. 엔드포인트, 인증 헤더 및 필드 맵을 제공하면 됩니다. 코드를 작성하거나 어댑터를 구축할 필요가 없습니다.
// 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.Flash에 구독 취소 동기화
자체 서비스 제공업체를 통해 전송하는 경우 Flash 외부(ESP, 기본 설정 센터 또는 양식)를 통해 제외 정보가 캡처될 수 있습니다. Unsubscribe API을 사용하여 다시 푸시하면 Flash는 모든 전송에서 해당 주소를 억제합니다. 주소의 옵트아웃 상태를 읽을 수도 있습니다. 테넌트 API 키로 인증합니다. 이메일이 신원입니다.
// 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.자격 증명을 안전하게 보관하는 방법
저장 시 암호화됨
모든 공급자 비밀 키는 즉시 암호화(AES-256-GCM)되며 API에서 반환되거나 다시 표시되지 않습니다. UI에서는 쓰기 전용입니다.
관리자 전용
조직 소유자/관리자만 공급자를 추가, 재정렬, 테스트 또는 제거할 수 있습니다. 마케팅 담당자는 공급자를 보거나 선택하지 않습니다.
운송 전용
메시지 전달은 서비스 제공업체가 담당합니다. Flash는 여전히 추적, 개인화, A/B 테스트, 구독 취소 헤더 및 빈도 제한 기능을 소유하고 있습니다. 서비스 제공업체를 변경해도 이러한 기능은 전혀 변경되지 않습니다.
기본적으로 안전함
제공업체의 구성 정보를 읽을 수 없거나 모든 제공업체가 실패하는 경우, 전송은 플랫폼에서 관리하는 이메일 서비스로 전환되며 전송 자체는 중단되지 않습니다.