إشعار التطبيق
حوّل تطبيقك الأصلي إلى قناة إرسال SocialHub. يسجل الأعضاء رمز الجهاز من داخل مركز الأعضاء في التطبيق؛ ثم ينضم الإشعار إلى نفس محرك الأتمتة والحملات الذي يرسل بريدك الإلكتروني - مع نظام إغلاق القناة في حالة الفشل وحد أقصى مشترك للتكرار.
تسجيل الرمز المميز وربط مكدس الإرسال مُفعّلان برمجيًا اليوم . يتم إطلاق خدمة الدفع الفعلية خلف علامة تفعيل مُتحكّم بها لكل فريق - اطلب من فريق SocialHub تفعيلها بمجرد تكوين بيانات اعتماد FCM/APNs الخاصة بك.
كيف يعمل
تسجيل رمز الجهازمباشر
يقوم تطبيق العضو المُسجّل بتسجيل الدخول بإرسال رمز FCM/APNs الخاص به. عملية UPSERT متكررة النتائج - آمنة للاستخدام عند كل تشغيل وعند تغيير رمز نظام التشغيل.
انضمام الإشعارات إلى سلسلة الإرسالمباشر
الإشعارات الفورية هي قناة ضمن نفس محرك الأتمتة/الحملات الخاص بالبريد الإلكتروني، وليست قناة منفصلة API. رحلة واحدة، قناة واحدة يختارها كل عضو.
قناة متسلسلة + غطاء واحدمباشر
نظام إرسال متتابع (إشعار ← بريد إلكتروني ← ...) مع حد أقصى مشترك للتكرار، بحيث لا يتلقى العضو رسالتين عبر القنوات.
تمكين عمليات التسليمالتطبيق
التسجيل وربط الإرسال مُبرمجان حاليًا؛ ويتم إرسال الإشعارات الفعلية تلقائيًا عبر علامة تحكم، لكل فريق. اطلب من فريق SocialHub تفعيل هذه الميزة.
تسجيل رمز الجهاز مباشر
استدعاء هذا من داخل WebView الخاص بالأعضاء المسجلين (ملف تعريف ارتباط جلسة المستهلك يحمل الهوية). راجع دليل Member Portal Embed لمعرفة آلية تسجيل الدخول الموحد (SSO) لـ WebView التي تُنشئ هذه الجلسة.
// The member must be signed in (consumer session cookie, set by the WebView SSO
// flow). teamId + memberId are taken from the SESSION — never the request body —
// so there is no member-enumeration surface here.
POST https://flash.socialhub.ai/api/consumer/push/register
Content-Type: application/json
{
"platform": "ios", // "ios" | "android"
"provider": "fcm", // "fcm" (default) | "apns" — optional
"token": "<device push token>",
"appBundleId": "com.yourbrand.app" // optional
}
// → 200 { "ok": true }
// Idempotent UPSERT keyed on (team, token): re-registering the same device
// simply re-points it at the current member. Call it on every app launch and
// whenever the OS rotates the token.الإرسال: الدفع هو قناة، وليس استدعاءً من API
// You do NOT call a "send push" endpoint. Push is a CHANNEL inside the existing
// automation + campaign send stack — the same engine that sends email. When a
// journey or campaign targets a member:
//
// 1. SocialHub resolves the member's channels in a waterfall (fail-open):
// push (if a token + consent exist) → email → …
// 2. One SHARED frequency cap applies across channels, so a member is never
// double-messaged on push AND email for the same step.
// 3. No token / no consent / push disabled → silently falls back to email.
//
// Net: you author one journey; SocialHub picks the best channel per member.يُنشئ المسوّقون الإشعارات بدون كتابة أي كود: خطوة Push step في لوحة الحملة المرئية (بجوار البريد الإلكتروني)، مع نص مُولّد بواسطة الذكاء الاصطناعي، ونفس علامات الدمج المستخدمة في البريد الإلكتروني، وقوالب push templates قابلة لإعادة الاستخدام. أي محتوى يُنشئونه يُصبح محتوى الإشعارات للحملة، ويقوم مسار الإرسال المذكور أعلاه بتوصيله - لا يقوم تطبيقك سوى بتسجيل رموز الجهاز. يُصبح المحتوى الذي يُنشئونه هو محتوى الإشعارات للحملة، ويقوم مسار الإرسال أعلاه بتوصيله - لا يقوم تطبيقك سوى بتسجيل رموز الجهاز.
قبل بدء التشغيل
FCM (أندرويد + iOS عبر Firebase)
قدّم بيانات اعتماد حساب خدمة Firebase الخاص بك إلى فريق SocialHub. أرسلها عبر FCM HTTP v1 (OAuth عبر حساب خدمة) - المزوّد الافتراضي.
APNs (اختياري، مباشر)
إذا كنت ترسل إلى نظام iOS مباشرةً عبر APNs، فأدخل مفتاح مصادقة APNs (.p8)، ومعرّف المفتاح، ومعرّف الفريق. سجّل هذه الأجهزة لدى المزوّد: "apns".
الموافقة
يتم التحكم في الإشعارات الفورية بموافقة صريحة من العضو بالإضافة إلى إشارة التحكم في الخصوصية العالمية (إغلاق في حالة الفشل). يتم تخطي العضو الذي لا يملك موافقة فعالة على الإشعارات الفورية، ويعود التسلسل إلى البريد الإلكتروني.
قائمة التحقق من القبول
لا يؤدي تسجيل الجهاز نفسه مرتين إلى إنشاء نسخة مكررة، حيث يقوم أمر UPSERT بإعادة توجيهه إلى العضو الحالي.
يتلقى العضو المُسجّل برمز مميز صالح إشعارًا فوريًا؛ أما العضو الذي لا يملك رمزًا مميزًا/موافقة، فيتلقى رسالة بريد إلكتروني بديلة - لا شيء أبدًا، ولا كلاهما.
إلغاء الموافقة على الإشعارات الفورية (أو إشارة التحكم في الخصوصية العامة) يُحوّل العضو فورًا إلى قناة البريد الإلكتروني.
هل تُجهز خدمة الإشعارات؟
تحدث إلى مهندس حول بيانات اعتماد FCM/APNs، أو آلية إرسال القنوات، أو تفعيل خدمة التوصيل لفريقك.
تحدث إلى فريق الهندسة