الإشعارات الفورية Push لتطبيقك: واجهة API واحدة ومنصة واحدة
أرسل الإشعارات الفورية إلى مستخدمي تطبيقك من واجهة REST API نفسها التي تستخدمها لرسائل SMS وWhatsApp وRCS، ثم تواصل عبر قناة أخرى مع من لم يفتح التطبيق.
curl -X POST https://api.broadnet.me/push/message/send \
-H "Authorization: Bearer $BROADNET_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"userRefs": ["user-10293"],
"title": "Your order has shipped",
"body": "Tap to track your parcel.",
"deepLink": "https://example.com/orders/8842",
"category": "UTILITY",
"priority": "HIGH",
"ttl": 3600
}'طلب إشعار فوري إلى واجهة OmniChannels.ai API. القيم بيانات تجريبية.
الإجابة المختصرة
آخر تحديث
OmniChannels.ai خدمة وواجهة API للإشعارات الفورية (Push) لتطبيقات الجوال. تستدعي POST /push/message/send مع العنوان والنص والجمهور المستهدف: معرّفات المستخدمين أو رموز الأجهزة أو المواضيع أو شريحة. يمكن أن تحمل الإشعارات صوراً وروابط عميقة وأزرار إجراءات، وأن تعتمد قوالب محفوظة، وأن تُجدول، وأن تُتحقَّق منها بتجربة جافة أولاً. ويربط فريقنا مشروع Firebase Cloud Messaging وبيانات APNs لنظام iOS أثناء التفعيل.
ما تقوم به واجهة API للإشعارات الفورية
الاستهداف حسب المستخدم أو الرمز أو الموضوع أو الشريحة
خاطب معرّفات مستخدميك (userRefs) أو رموز أجهزة FCM صريحة أو مواضيع FCM أو شريحة محددة بالدولة والمدينة واللغة والوسوم.
إشعارات غنية
أضف صورة عبر HTTPS ورابطاً عميقاً يُفتح عند النقر وأزرار إجراءات مثل تأكيد أو إعادة جدولة.
قوالب محفوظة
أنشئ القوالب وعاينها وجرّب إرسالها وانشرها مع سجل للإصدارات، ثم أرسلها بمعرّف templateId مع متغيراتك الخاصة.
الأولوية ومدة الصلاحية والجدولة
حدّد الرسائل العاجلة بأولوية عالية، واضبط مدة الصلاحية (TTL)، واستبدل الإشعارات الأقدم بمفتاح الدمج (collapse key)، أو جدول الإرسال.
تجربة جافة قبل الإرسال
اضبط dryRun على true للتحقق من الطلب بالكامل دون تسليم أي شيء لمستخدمين فعليين.
التحكم بالدفعات
اعرض الدفعات واطّلع على تفاصيلها، وأوقفها مؤقتاً أو استأنفها أو ألغِها عبر نقاط نهاية الدفعات.
إشعارات مرتبطة بالموقع
يمكن للأسوار الجغرافية (Geofences) تشغيل الإشعارات بحسب الموقع. يفعّل فريقنا الأسوار الجغرافية لتطبيقك عند الطلب.
حالات التسليم عبر Webhook
تابع حالات التسليم على رابط Webhook المضبوط في حسابك، بالطريقة نفسها المعتمدة للقنوات الأخرى.
Push أم SMS أم WhatsApp: أيّها تختار؟
يصل Push إلى من ثبّتوا تطبيقك، بينما يصل SMS وWhatsApp إلى رقم هاتف. تستخدم معظم الشركات القنوات الثلاث، بهذا الترتيب من حيث الأفضلية لكل رسالة.
| القناة | تصل إلى | الأنسب لـ | ملاحظة |
|---|---|---|---|
| إشعار Push | مستخدمين ثبّتوا تطبيقك وسجّلوا جهازاً | نشاط التطبيق: حالة الطلب والتذكيرات والعروض داخل التطبيق وإعادة التفاعل | استخدمه خطوة أولى حين يكون المستخدم داخل تطبيقك. |
| عملاء وافقوا على التلقي عبر رقم الهاتف | محادثات غنية وقوالب ودعم وإيصالات | استخدمه حين تحتاج إلى محادثة أو وسائط. | |
| SMS | أي رقم جوال | رموز OTP والتنبيهات العاجلة والعملاء الذين لا يملكون التطبيق أو WhatsApp | استخدمه احتياطاً شاملاً. |
كيف تبدأ إرسال الإشعارات الفورية
يعمل Push عبر Firebase Cloud Messaging، وعبر APNs من Apple لنظام iOS، لذلك تأتي خطوة تفعيل قصيرة أولاً.
- 1
اربط تطبيقك
يربط فريقنا مشروع Firebase Cloud Messaging وبيانات APNs لنظام iOS، ويزوّدك بمعرّف تطبيقك.
- 2
سجّل الأجهزة مقابل معرّفات مستخدميك
يسجّل تطبيقك كل جهاز مقابل معرّفك الخاص (userRef)، فترسل إلى الأشخاص بدل الرموز.
- 3
تحقق من الحمولة بتجربة جافة
استدعِ POST /push/message/send مع dryRun بقيمة true وتأكد من صحة الطلب قبل أن يرى المستخدمون الفعليون أي شيء.
- 4
أرسل أو جدول
أرسل إلى userRefs أو الرموز أو المواضيع أو شريحة، أو جدول الإرسال. واحفظ الرسائل المتكررة قوالب.
- 5
أضف قناة احتياطية
حدّد الرسائل التي تحتاج قناة ثانية، مثل SMS لرمز OTP أو تنبيه التوصيل، واضبط الترتيب لكل حالة استخدام.
متى يكون Push القناة المناسبة؟
يناسبك إذا
- لديك تطبيق جوال وتريد الوصول إلى المستخدمين المثبّتين دون الحاجة إلى أرقام هواتفهم.
- رسائلك مرتبطة بنشاط التطبيق، مثل حالة الطلب وتذكيرات المواعيد وتنبيهات الحساب.
- تريد واجهة API واحدة وصيغة Webhook واحدة لـ Push وSMS وWhatsApp وبقية القنوات.
- تريد الإرسال بمعرّف المستخدم لديك بدل إدارة رموز الأجهزة.
ما يجب معرفته قبل البدء
- يصل Push فقط إلى من ثبّتوا تطبيقك وسمحوا بالإشعارات.
- تغطي الواجهة الموثّقة إشعارات تطبيقات الجوال عبر FCM وAPNs. اسأل فريقنا عن أي أمر يتجاوز ذلك قبل أن تبني خطتك عليه.
- لا تعتمد على Push وحده لرموز OTP أو التنبيهات الحرجة: أضف SMS أو الصوت قناة احتياطية.
- تُفعَّل الأسوار الجغرافية عند الطلب لتطبيقك.
أسئلة عن خدمة الإشعارات الفورية
ما هي خدمة الإشعارات الفورية (Push)؟
خدمة الإشعارات الفورية توصل رسائل قصيرة من خوادمك إلى أجهزة المستخدمين حتى لو كان التطبيق مغلقاً. يتم التسليم على Android عبر Firebase Cloud Messaging وعلى iOS عبر APNs من Apple. وتقف خدمة مثل OmniChannels.ai أمام الاثنين لتمنحك واجهة API واحدة تستدعيها.
كيف تعمل واجهة API للإشعارات الفورية؟
يسجّل تطبيقك كل جهاز برمز. ثم يستدعي الخادم الخلفي لديك الواجهة بالجمهور والمحتوى، وتسلّم الخدمة الإشعار إلى FCM أو APNs. مع OmniChannels.ai تستدعي POST /push/message/send ويمكنك استهداف المستخدمين بمعرّفاتك الخاصة.
ما الفرق بين الإشعارات الفورية وSMS؟
يصل Push إلى من ثبّتوا تطبيقك وسمحوا بالإشعارات، ويحتاج إلى اتصال بيانات. أما SMS فيصل إلى أي رقم جوال دون تطبيق. يناسب Push تحديثات التطبيق والتفاعل، ويناسب SMS رموز OTP والتنبيهات العاجلة والعملاء الذين لا يملكون تطبيقك.
هل يمكنني إرسال إشعار فوري إلى شريحة من المستخدمين؟
نعم. إضافة إلى معرّفات المستخدمين ورموز الأجهزة والمواضيع، تقبل الواجهة كائن شريحة بمعايير مثل الدولة والمدينة واللغة والوسوم، مع معرّف تطبيقك. ويمكنك أيضاً جدولة الإرسال ووسمه باسم حملة.
هل يمكنني اختبار الإشعار قبل إرساله؟
نعم. اضبط dryRun على true للتحقق من الطلب دون تسليم أي شيء. وبالنسبة إلى القوالب يمكنك المعاينة ببيانات تجريبية وإرسال اختبار إلى جهازك قبل نشر إصدار.
هل يمكنني إضافة صور وروابط وأزرار؟
نعم. يمكن أن تتضمن الإشعارات صورة عبر HTTPS ورابطاً عميقاً يُفتح عند النقر وبيانات مخصصة لتطبيقك وأزرار إجراءات، لكلٍّ منها معرّف وعنوان وإجراء. ويمكنك أيضاً إرسال رسائل بيانات فقط ورسائل صامتة.
ماذا لو لم يفتح المستخدم التطبيق أو أوقف الإشعارات؟
لا يستطيع Push الوصول إليه. بالنسبة إلى الرسائل المهمة، اضبط قناة احتياطية مثل SMS أو WhatsApp. يُحدَّد ترتيب الاحتياط لكل حالة استخدام، وتصل حالات التسليم بصيغة Webhook واحدة.
كيف أبدأ؟
احجز عرضاً توضيحياً. يربط فريقنا مشروع Firebase وبيانات APNs أثناء التفعيل ويزوّدك بمعرّف تطبيقك، ثم تستدعي الواجهة برمزك. وتسرد وثائق المطورين كل نقاط نهاية Push.
أدلة حول هذا الموضوع
- تعدد القنواتاستراتيجية القناة البديلة: WhatsApp وRCS وSMS12 دقيقة للقراءة
- الرسائل النصية ورموز التحققWhatsApp أم SMS أم RCS: أي قناة تناسب OTP والتسويق؟8 دقائق للقراءة
- التكاملدليل تكامل واجهة API للمراسلة: REST وSMPP وWebhooks9 دقائق للقراءة
- الامتثالالموافقة المسبقة (Opt-in) لحملات WhatsApp وSMS والبريد الإلكتروني8 دقائق للقراءة
- تعدد القنواتما هي المراسلة متعددة القنوات؟ البنية والأمثلة والفوائد10 دقائق للقراءة
اكتشف المزيد من المنصة
أضف Push إلى منظومة رسائلك
حدّثنا عن تطبيقك. سنربط FCM وAPNs ونعرض لك Push إلى جانب SMS وWhatsApp.
شاركنا الأنظمة التي تستخدمها وما تريد ربطه، وسيتواصل معك مهندس حلول.
