انتقل إلى المحتوى
OmniChannels.ai
القائمة

الإشعارات الفورية Push لتطبيقك: واجهة API واحدة ومنصة واحدة

أرسل الإشعارات الفورية إلى مستخدمي تطبيقك من واجهة REST API نفسها التي تستخدمها لرسائل SMS وWhatsApp وRCS، ثم تواصل عبر قناة أخرى مع من لم يفتح التطبيق.

POST /push/message/sendcURL
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 للإشعارات الفورية

Push أم SMS أم WhatsApp: أيّها تختار؟

يصل Push إلى من ثبّتوا تطبيقك، بينما يصل SMS وWhatsApp إلى رقم هاتف. تستخدم معظم الشركات القنوات الثلاث، بهذا الترتيب من حيث الأفضلية لكل رسالة.

القناةتصل إلىالأنسب لـملاحظة
إشعار Pushمستخدمين ثبّتوا تطبيقك وسجّلوا جهازاًنشاط التطبيق: حالة الطلب والتذكيرات والعروض داخل التطبيق وإعادة التفاعلاستخدمه خطوة أولى حين يكون المستخدم داخل تطبيقك.
WhatsAppعملاء وافقوا على التلقي عبر رقم الهاتفمحادثات غنية وقوالب ودعم وإيصالاتاستخدمه حين تحتاج إلى محادثة أو وسائط.
SMSأي رقم جوالرموز OTP والتنبيهات العاجلة والعملاء الذين لا يملكون التطبيق أو WhatsAppاستخدمه احتياطاً شاملاً.

كيف تبدأ إرسال الإشعارات الفورية

يعمل Push عبر Firebase Cloud Messaging، وعبر APNs من Apple لنظام iOS، لذلك تأتي خطوة تفعيل قصيرة أولاً.

  1. 1

    اربط تطبيقك

    يربط فريقنا مشروع Firebase Cloud Messaging وبيانات APNs لنظام iOS، ويزوّدك بمعرّف تطبيقك.

  2. 2

    سجّل الأجهزة مقابل معرّفات مستخدميك

    يسجّل تطبيقك كل جهاز مقابل معرّفك الخاص (userRef)، فترسل إلى الأشخاص بدل الرموز.

  3. 3

    تحقق من الحمولة بتجربة جافة

    استدعِ POST /push/message/send مع dryRun بقيمة true وتأكد من صحة الطلب قبل أن يرى المستخدمون الفعليون أي شيء.

  4. 4

    أرسل أو جدول

    أرسل إلى userRefs أو الرموز أو المواضيع أو شريحة، أو جدول الإرسال. واحفظ الرسائل المتكررة قوالب.

  5. 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.

أدلة حول هذا الموضوع

اكتشف المزيد من المنصة

أضف Push إلى منظومة رسائلك

حدّثنا عن تطبيقك. سنربط FCM وAPNs ونعرض لك Push إلى جانب SMS وWhatsApp.

شاركنا الأنظمة التي تستخدمها وما تريد ربطه، وسيتواصل معك مهندس حلول.

تحدث مع مختص في API

نستخدمه للرد عليك. يمكنك استخدام أي نطاق خاص بشركتك.

اختياري. أضف رمز الدولة إذا كنت تفضّل الاتصال الهاتفي.

أضف تفاصيل (اختياري)
القنوات التي تهمك(اختياري)

سيتواصل معك فريقنا بخصوص عملية الربط.