إشعارات Communication Services
حزم SDK للدردشة والمكالمات في Azure Communication Services بإنشاء قناة مراسلة في الوقت الفعلي تسمح بنقل رسائل الإشارات إلى العملاء المتصلين بطريقة فعالة وموثوق بها. يتيح لك ذلك إنشاء وظيفة اتصال غنية في الوقت الفعلي في التطبيقات الخاصة بك دون الحاجة إلى تطبيق منطق استقصاء HTTP معقد. ومع ذلك، على تطبيقات الجوال، لا تظل قناة الإشارات هذه متصلة إلا عندما يكون التطبيق نشطًا في الخلفية. إذا كنت تريد أن يتلقى المستخدمون المكالمات الواردة أو رسائل الدردشة في أثناء عمل التطبيق في الخلفية، فإنه يجب عليك استخدام الإشعارات المنبثقة.
تتيح لك الإشعارات المنبثقة إرسال معلومات من التطبيق إلى أجهزة الجوال الخاصة بالمستخدمين. يمكنك استخدام الإشعارات المنبثقة لإظهار مربع حوار أو تشغيل صوت أو عرض واجهة مستخدم المكالمات الواردة. توفر Azure Communication Services عمليات تكامل مع Azure Event Grid وAzure Notification Hubs التي تمكنك من إضافة إشعارات دفع إلى تطبيقاتك.
تفعيل الإشعارات المنبثقة عبر Azure Event Grid
تتكامل Azure Communication Services مع Azure Event Grid لتقديم إعلامات الأحداث في الوقت الحقيقي بطريقة موثوقة وقابلة للتطوير وآمنة. يمكنك الاستفادة من هذا التكامل لإنشاء خدمة إعلام توفر إعلامات دفع الأجهزة المحمولة للمستخدمين عن طريق إنشاء اشتراك شبكة حدث يؤدي إلى تشغيل Azure Function أو webhook.
تعرف على المزيد حول معالجة الأحداث في Azure Communication Services.
تسليم الإشعارات المنبثقة عبر Azure Notification Hubs
هام
أعلنت Azure Notification Hubs أنه سيتم إهمال واجهة برمجة التطبيقات القديمة Firebase Cloud Messaging (FCM) في يوليو 2024. سيؤثر هذا على جميع تطبيقات الاتصال والدردشة في Azure Communiation Services التي ترسل إشعارات دفع Android. سيحتاج العملاء المتأثرون إلى ترحيل تسجيلاتهم من FCM القديم إلى FCM v1، ويمكنهم البدء في القيام بذلك في مارس 2024. لمزيد من المعلومات بما في ذلك خطوات الترحيل، يرجى الاطلاع على وثائق مركز التوثيق.
يمكنك توصيل Azure Notification Hub بمورد Communication Services لإرسال إعلامات الدفع تلقائيا إلى الجهاز المحمول للمستخدم عند تلقيه مكالمة واردة أو لإعلامه بنشاط الدردشة الفائت. يجب عليك استخدام هذه الإعلامات المنبثقة لتنبيه التطبيق الخاص بك من الخلفية وعرض واجهة المستخدم التي تسمح للمستخدم بقبول المكالمة أو رفضها أو قراءة رسالة الدردشة المستلمة حديثا.
تستخدم Communication Services Azure Notification Hub كخدمة مرور للتواصل مع مختلف خدمات الإعلامات المنبثقة الخاصة بالنظام الأساسي باستخدام Direct Send API. يسمح لك هذا بإعادة استخدام موارد Azure Notification Hub وتكويناته الحالية لتقديم إعلامات ذات زمن انتقال منخفض وموثوق بها لتطبيقاتك.
إشعار
يتم حاليا دعم إعلامات دفع المكالمات والدردشة لكل من Android وiOS.
توفير Azure Notification Hub
لتقديم إعلامات مؤقتة إلى أجهزة العميل باستخدام مراكز الإعلامات، قم بإنشاء مركز إعلام ضمن نفس الاشتراك مثل مورد Communication Services. يجب تكوين Azure Notification Hub لنظام إشعار النظام الأساسي الذي تريد استخدامه. لمعرفة كيفية الحصول على الإعلامات المنبثقة في تطبيق العميل من مراكز الإعلامات، راجع بدء استخدام مراكز الإعلامات وحدّد النظام الأساسي للعميل المستهدف من القائمة المنسدلة بالقرب من أعلى الصفحة.
إشعار
حاليًا يتم دعم أنظمة APNs وFCM الأساسية. يجب تكوين النظام الأساسي APNs باستخدام وضع مصادقة الرمز المميز. وضع مصادقة الشهادة غير معتمد حتى الآن.
بمجرد تكوين Notification hub، يمكنك إقرانه بمورد Communication Services الخاص بك عن طريق توفير سلسلة اتصال للوحة الوصل باستخدام عميل Azure Resource Manager أو من خلال Azure portal. يجب أن يحتوي سلسلة الاتصال على Send أذونات. نوصي بإنشاء نهج وصول آخر بأذونات Send خاصة بمركزك فقط. تعرف على المزيد حول نهج أمان مراكز الإعلامات والوصول إليها
استخدام عميل Azure Resource Manager لربط Notification Hub
لتسجيل الدخول إلى Azure Resource Manager، قم بتنفيذ ما يلي وسجل الدخول باستخدام بيانات الاعتماد الخاصة بك.
armclient login
بمجرد تسجيل الدخول بنجاح قم بتنفيذ ما يلي لتوفير notification hub:
armclient POST /subscriptions/<sub_id>/resourceGroups/<resource_group>/providers/Microsoft.Communication/CommunicationServices/<resource_id>/linkNotificationHub?api-version=2020-08-20-preview "{'connectionString': '<connection_string>','resourceId': '<resource_id>'}"
استخدام Azure portal لربط Notification Hub الخاص بك
في البوابة، انتقل إلى مورد Azure Communication Services الخاص بك.
داخل مورد Communication Services، حدد Push Notifications من القائمة اليسرى لصفحة Communication Services، وقم بتوصيل Notification Hub الذي قمت بتوفيره سابقا.
حدد الاتصال مركز الإعلامات. سترى قائمة بمراكز الإشعارات المتوفرة للاتصال.
حدد مركز الإشعارات الذي تريد استخدامه لهذا المورد.
- إذا كنت بحاجة إلى إنشاء مركز جديد، فحدد إنشاء مركز إعلام جديد للحصول على مركز جديد تم توفيره لهذا المورد.
سترى الآن الإشعارات التي قمت بربطها بحالة الاتصال.
إذا كنت ترغب في استخدام مركز مختلف للمورد، فحدد قطع الاتصال، ثم كرر الخطوات لربط مركز الإعلامات المختلف.
إشعار
وينعكس أي تغيير في كيفية ربط المركز في وحدة البيانات (أي عند إرسال إشعار) في غضون فترة أقصاها 10 دقائق. ينطبق هذا السلوك نفسه عندما يكون المركز مرتبطا للمرة الأولى، إذا تم إرسال الإعلامات قبل التغيير.
تسجيل الجهاز
راجع التشغيل السريع للاتصال الصوتي والتشغيل السريع للدردشة لمعرفة كيفية تسجيل مقبض جهازك باستخدام Communication Services.
دليل استكشاف الأخطاء وإصلاحها للإشعارات المنبثقة
إذا لم تظهر الإشعارات المنبثقة على جهازك، فإنه يجب البحث عن سبب ذلك في أحد الأماكن الثلاثة التالية:
- لم يقبل Azure Notification Hubs الإشعارات من Azure Communication Services
- لم يقبل نظام إشعارات النظام الأساسي (على سبيل المثال APNs وFCM) الإخطار من Azure Notification Hubs
- لم يقم نظام إشعارات النظام الأساسي بتسليم الإشعار إلى الجهاز.
يتم أدناه تغطية المكان الأول الذي يمكن أن يكون سبب عدم ظهور الإشعارات (لم يقبل Azure Notification Hubs الإشعارات من Azure Communication Services). بالنسبة إلى المكانين الآخرين، راجع تشخيص الإعلامات التي تم إسقاطها في مراكز إعلامات Azure.
تتمثل إحدى الطرق لمعرفة ما إذا كان مورد Communication Services الخاص بك يرسل إشعارات إلى Azure Notification Hubs في النظر إلى المقياس incoming messages من مقاييس Azure Notification Hub المرتبطة.
فيما يلي بعض التكوينات الخطأ الشائعة التي قد تكون السبب في عدم قبول Azure Notification Hub الإشعارات من مورد Communication Services.
Azure Notification Hub غير مرتبط بمورد Communication Services
قد تكون هناك حالة حيث لم تربط Azure Notification Hub بمورد Communication Services. يمكنك إلقاء نظرة في قسم توفير مركز الإعلامات لمعرفة كيفية ربطها.
لم يتم تكوين Azure Notification Hub المرتبطة به
يجب عليك تكوين Notification Hub المرتبط به مع بيانات اعتماد نظام إشعارات النظام الأساسي للنظام الأساسي (على سبيل المثال iOS أو android) التي ترغب في استخدامها. لمزيد من التفاصيل حول كيفية القيام بذلك، يمكنك إلقاء نظرة على إعداد الإعلامات المؤقتة في مركز الإعلامات.
Azure Notification Hub المرتبط غير موجود
لم يعد Azure Notification Hub المرتبط بمورد Communication Services موجودًا بعد الآن. تحقق من أن Notification Hub المرتبط لا يزال موجودًا.
تم تكوين النظام الأساسي Azure Notification Hub APNs مع وضع مصادقة الشهادة
في حالة الرغبة في استخدام النظام الأساسي APNs مع وضع مصادقة الشهادة، فهذا غير معتمد حاليًا. يجب تكوين النظام الأساسي ل APNs مع وضع مصادقة الرمز المميز كما هو محدد في إعداد الإعلامات المنبثقة في مركز الإعلامات.
ليس لدى Send سلسلة الاتصال المرتبط إذن
يجب أن يكون لدى Send سلسلة الاتصال الذي استخدمته لربط مركز الإعلامات بمورد Communication Services الإذن. لمزيد من التفاصيل حول كيفية إنشاء سلسلة الاتصال جديد أو رؤية سلسلة الاتصال الحالي من Azure Notification Hub، يمكنك إلقاء نظرة على نهج الأمان والوصول لمراكز الإعلامات
سلسلة الاتصال المرتبطة أو معرف مورد Azure Notification Hub غير صالح
تأكد من تكوين مورد Communication Services مع سلسلة الاتصال الصحيحة ومعرف مورد Azure Notification Hub
تتم إعادة إنشاء سلسلة الاتصال المرتبطة
في حالة إعادة إنشاء سلسلة الاتصال من Azure Notification Hub المرتبط، يجب عليك تحديث سلسلة الاتصال بآخر جديد في مورد Communication Services عن طريق إعادة ربط مركز الإعلامات.
الخطوات التالية
- للحصول على مقدمة حول Azure Event Grid، راجع ما المقصود بشبكة الأحداث؟
- لمعرفة المزيد حول مفاهيم Azure Notification Hub، راجع وثائق Azure Notification Hubs