الموارد · مركز المطورين

مُزودو خدمة توصيل البريد الإلكتروني

أرسل عبر مزودي خدمة البريد الإلكتروني الذين تستخدمهم حاليًا. يقوم المسؤول بتكوين مزود واحد أو أكثر، بالإضافة إلى خيار احتياطي مُرتب في لوحة التحكم؛ Flash يرسل عبرهم بشكل متسلسل ينتهي دائمًا عند خدمة البريد الإلكتروني المُدارة من المنصة. المزود هو تبادل نقل فقط — Flash لا يزال يُضيف التتبع، والتخصيص، وفروع اختبار A/B، ومعالجة إلغاء الاشتراك بنفسه، لذا لا يتغير شيء في كيفية إنشاء الحملة أو قياسها. أرسل عبر مزودي خدمة البريد الإلكتروني الذين تستخدمهم حاليًا.

احجز عرضًا توضيحيًا تصفح API

ما يمكنك ربطه

يتم ضبطها ضمن الإعدادات ← موفرو البريد الإلكتروني بواسطة مسؤول المؤسسة، ولا يتم ضبطها لكل حملة تسويقية بواسطة المسوّق.

SendGrid

اربط حسابك في SendGrid بمفتاح API. يرسل Flash عبر بريد الإصدار 3 API.

خدمة Amazon SES (حسابك)

أحضر حسابك الخاص على AWS SES (مفتاح الوصول / المنطقة / تم التحقق منه). يختلف هذا الحساب عن حساب SES الاحتياطي للمنصة.

تخصيص REST — أي منصة تسويق عبر البريد الإلكتروني

وجّه Flash إلى أي مُزوّد، ثم أرسل API بيانات JSON مع خريطة الحقول. لا حاجة لانتظار مُحوّل.

ترحيل 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.

ربط أي وحدة ESP بـ REST المخصصة

إذا لم يكن موفر الخدمة مُدمجًا، فقم بتوصيله عبر إرسال 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 - من قِبل مزود خدمة البريد الإلكتروني، أو مركز التفضيلات، أو نموذج. يمكنك إلغاء الاشتراك باستخدام 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 أو عرضها مرة أخرى - فهي قابلة للكتابة فقط في واجهة المستخدم.

خاص بالمسؤولين فقط.

يُسمح فقط لمالكي/مديري المؤسسة بإضافة أو إعادة ترتيب أو اختبار أو إزالة مزودي الخدمات. لا يرى المسوقون مزود الخدمة ولا يختارونه.

النقل فقط

يحمل مقدمو الخدمة الرسالة؛ Flash لا تزال تملك التتبع والتخصيص واختبارات A/B ورؤوس إلغاء الاشتراك وحدود التردد - يمكنك استبدال مقدم الخدمة دون تغيير أي منها.

آمن افتراضيًا

إذا تعذر قراءة إعدادات الموفر، أو فشل كل الموفر، فإن التسليم يعود إلى خدمة البريد الإلكتروني المُدارة الخاصة بالمنصة - ولا يتوقف الإرسال أبدًا.

انظر أيضًا: التوصيل عبر القنوات · REST API

هل ستستخدم مزود خدمة البريد الإلكتروني الخاص بك؟

تحدث إلى مهندس حول مزود خدمة البريد الإلكتروني الخاص بك، وإمكانية وصول الرسائل، واستراتيجية النسخ الاحتياطي، أو ربط مزود الخدمة عبر API.

تحدث إلى فريق الهندسة