إعداد متجر المبدع | Social Stream Ninja

توصيل التنبيهات في 5 خطوات

افتح تحقيق الدخل (Monetization) ← تنبيهات Fourthwall وKo-fi وBuy Me a Coffee واختر المزود.
انقر على إعداد المستقبِل وفعّل التحكم في الإضافة عن بُعد عبر API.
عُد إلى تحقيق الدخل وانقر نسخ رابط Webhook ‏(Copy webhook URL).
الصقه في إعدادات webhook لدى مزودك (الخطوات أدناه).
أبقِ Social Stream Ninja قيد التشغيل.

منتقي مزوّد SSN ورابط Webhook المحجوب وإعداد المستقبِل ودليل الإعداد وعناصر معاينة النموذج — لوحة إعداد المزود. يظل الرابط الخاص مخفياً. انقر للتكبير.

هل يعمل؟ تعني عبارة «المستقبِل متصل» فقط أن SSN يستمع. يتحدث سطر آخر حدث عند وصول حدث حقيقي (ويُعاد ضبطه عند إعادة التشغيل).

حافظ على خصوصية رابط webhook. إنه وسيلة الحماية الوحيدة لهذه التنبيهات (لا يجري التحقق من سرّ توقيع). يصلح للتنبيهات، لا لإثبات الدفع عند شحن الطلبات. لا تنشره أو تستخدمه في رمز QR.

معاينة تنبيه نموذجي يعرض المظهر فقط. لا يؤثر في الإجماليات أو Event Flow أو webhook الخاص بك.

لـ NinjaBacker وThrone وAmazon وeBay: راجع دليل تحقيق الدخل. لـ Shopify: راجع إعداد Shopify.

Fourthwall

في Fourthwall، افتح الإعدادات (Settings) ← للمطورين (For Developers) ← Webhooks.
أنشئ webhook والصق رابط Fourthwall من SSN.
حدد الأحداث التي تريدها (راجع الجدول).
احفظ وأبقِ SSN قيد التشغيل.

حدث Fourthwall	يظهر بوصفه
`ORDER_PLACED`	عملية شراء. تظل تضيف قيمة التبرع للتوافق مع الإعدادات القديمة.
`GIFT_PURCHASE`	هدية.
`DONATION`	تبرع.
`SUBSCRIPTION_PURCHASED`	عضوية جديدة.

لا تضيف طلبات بطاقات الهدايا قيمتها مرتين. يتم تجاهل الأحداث التجريبية.

توثيق Webhook في Fourthwall · معاينة شراء نموذجي

Ko-fi

افتح Ko-fi Webhooks.
الصق رابط Ko-fi من SSN في رابط Webhook واحفظ.
أبقِ SSN قيد التشغيل.

تستخدم الإكراميات العامة والعضويات وطلبات المتجر والتكليفات كلها هذا الرابط الواحد. تُستبعد الدفعات الخاصة. تظهر طلبات المتجر والتكليفات كمشتريات ولا تُضاف إلى إجماليات التبرع. لا يبلغ Ko-fi عن العضويات الملغاة.

اختبر باستخدام معاينة SSN. تبدو دفعات Ko-fi التجريبية حقيقية وقد تشغّل التنبيهات والإجماليات والإجراءات. لا تستخدمها أثناء تفعيل المكافآت المدفوعة.

توثيق Webhook في Ko-fi · معاينة دعم نموذجي

Buy Me a Coffee

في لوحة تحكم المنشئ، افتح التكاملات (Integrations) واختر Webhook جديد (New webhook).
سمّه والصق رابط Buy Me a Coffee من SSN.
حدد الأحداث التي تريدها (راجع الجدول).
احفظ واترك الإرسال مفعّلاً. إذا فشل شيء، راجع سجل الإرسال هناك.

الحدث	يظهر بوصفه
`donation.created`	تبرع.
`extra_purchase.created`	عملية شراء.
`commission_order.created`	عملية شراء.
`wishlist_payment.created`	مساهمة في هدية.
`membership.started`	إعلان عضوية جديدة (وليس رسماً منفصلاً).

تبقى الملاحظات المخفية والداعمون المجهولون مخفيين. اختبارات لوحة التحكم (live_mode: false) يتم تجاهلها. لا تقلل المبالغ المستردة الإجماليات.

توثيق Webhook في Buy Me a Coffee · معاينة مساهمة نموذجية

استيراد منتج Fourthwall

في Fourthwall، انتقل إلى الإعدادات (Settings) ← للمطورين (For Developers) وأنشئ رمز Storefront. لا تستخدم مفتاح API للمسؤول.
في SSN، افتح روابط المنتجات والدعم (Products & support links) ← إعداد المنتجات والروابط (Set up products and links) ← استيراد منتج Fourthwall ‏(Import a Fourthwall product).
الصق الرابط العام للمنتج والرمز. انقر تحميل تفاصيل المنتج (Load product details).
تحقّق من الاسم والصورة والسعر والرابط. يجب أن ينتمي الرابط إلى المتجر نفسه الذي يخصه الرمز.
اختر الغرض: تسوّق أو هدية أو دعم أو انضمام.
انقر على إضافة منتج أو رابط (Add product or link)، فعّل روابط المنتجات والدعم (Products & support links)، ثم انقر حفظ الإعداد (Save setup).

عناصر تحكم استيراد Fourthwall وحقول المنتج المحمّلة الجاهزة للمراجعة في SSApp — يملأ الاستيراد المحرر كي تتمكن من المراجعة قبل الحفظ.

ما الذي يفعله الاستيراد

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

إنشاء رمز Storefront · حقول منتج Fourthwall

عرض المنتجات ورموز QR على البث

يمكنك أيضاً إضافة أي رابط عام يدوياً، مثل Shopify أو Tiltify أو Patreon. لا يؤدي ذلك إلى توصيل تنبيهات الدفع.

ضمن تراكب OBS لـ، اختر روابط المنتجات والدعم (Products & support links).
افتح خيارات رابط التراكب واختر عرض التراكب: عرض المنتجات فقط، أو بطاقة الدعم فقط، أو تنبيهات النشاط فقط، أو العرض والتنبيهات.
انقر على نسخ رابط OBS وأضفه إلى OBS بوصفه مصدر المتصفح. ابدأ بمقاس 800 × 600. استخدم مصدراً واحداً لكل عرض.
في خيارات العرض، وثبّت المنتج الأول أو دوّر المنتجات، ثم فعّل إظهار رمز QR.
امسح رمز QR بهاتفك وأنت تنظر إلى التخطيط النهائي في OBS.

عرض منتج مقصوص يتضمن اسم المنتج وسعره ورابطاً عاماً مقروءاً ورمز QR — بطاقة منتج برابطه العام ورمز QR. منتج تجريبي.

لا يمكن مسح رمز QR؟ لا تصغّر التراكب أو تقتصّه كثيراً. لمشاركة رابط في الدردشة، انقر نسخ الرابط العام (Copy public link).

التنبيهات والتنبيهات المتعددة وEvent Flow

يعرض معرض المنتجات صورة المنتج، أما بطاقة الدعم الأصغر فلا تعرضها.
تعمل تنبيهات النشاط بصورة مستقلة، ولا تعرض أبداً رمز QR لمنتج غير ذي صلة.
تعمل التنبيهات المتعددة وخلاصة النشاط مع الجلسة نفسها دون الحاجة إلى قائمة منتجات. يتطلب عرض نشاط تحقيق الدخل تفعيل قائمة المنتجات.
في Event Flow، يظل مشغّل التبرع يشمل الصفوف التي تحتوي على hasDonation. استخدم نوع الحدث للمشتريات أو الهدايا المكتملة. راجع تعيين الأحداث.

للتبديل بين المنتجات مباشرة أو مشاركة رابط عرض واحد: راجع التحكم المباشر بالمنتجات.

إذا لم يظهر شيء

المشكلة	جرّب هذا
المستقبِل معطّل	فعّل التحكم في الإضافة عن بُعد عبر API. تؤدي مفاتيح API الأخرى وظائف مختلفة.
غير متصل	أبقِ SSN قيد التشغيل وتحقّق من الإنترنت. هذا اتصال SSN وليس اتصال مزودك.
لم يصل أي حدث	تحقّق من المزود الذي اخترته والرابط وإعدادات webhook لدى المزود.
تم تجاهل الحدث	تُستبعد الاختبارات والدفعات الخاصة والأحداث غير المدعومة والمبالغ غير الصالحة.
وصل الحدث، لكن التراكب لم يظهر	تحقّق من الجلسة وكلمة المرور والمرشحات وقواعد SSN وظهور مصدر OBS. معظم المشتريات ليست تبرعات.
تظهر التنبيهات مرتين	لا ترسل الدفعة نفسها عبر المزود وخدمة أخرى معاً.
فشل الاستيراد	تحقّق من رابط المنتج ورمز Storefront ومن أن المنتج عام ومتاح. يمكنك دائماً إدخاله يدوياً.

هذه خلاصة تنبيهات مباشرة وليست سجلاً للطلبات. استخدم لوحة تحكم مزودك للمدفوعات والاستردادات والشحن. تنبيهات Tiltify وPatreon غير مدعومة حتى الآن.