بداية سريعة: التعامل مع أحداث SMS لتقارير التسليم والرسائل الواردة
هام
تعتمد الإمكانات المتوفرة (PSTN/SMS، الواردة/الصادرة) على البلد الذي تعمل فيه (موقع عنوان فوترة Azure)، وحالة الاستخدام، ونوع رقم الهاتف الذي حددته. وتختلف هذه الإمكانات باختلاف البلد بسبب المتطلبات التنظيمية. لمزيد من المعلومات، قم بزيارة وثائق Phone number types.
ابدأ مع Azure Communication Services باستخدام Azure Event Grid للتعامل مع أحداث Communication Services SMS.
حول Azure Event Grid
Azure Event Grid هي خدمة أحداث مستندة إلى مجموعة النظراء. في هذه المقالة، ستتعرف على كيفية الاشتراك فيأحداث خدمة الاتصال، وتشغيل حدث لعرض النتيجة. بشكل عام، يمكنك إرسال الأحداث إلى نقطة نهاية تعالج بيانات الحدث وتتخذ الإجراءات. في هذه المقالة، سنرسل الأحداث إلى تطبيق ويب يجمع الرسائل ويعرضها.
المتطلبات الأساسية
- حساب Azure باشتراك نشط. إنشاء حساب مجاناً.
- مورد Azure Communication Service. يمكن العثور على مزيد من التفاصيل في البدء السريع إنشاء مورد Azure Communication Services.
- رقم هاتف ممكن لرسائل SMS. احصل على رقم هاتف.
الإعداد
تمكين موفر موارد Event Grid
إذا لم تكن قد استخدمت Event Grid من قبل في اشتراك Azure الخاص بك، فقد تحتاج إلى تسجيل مزود مورد Event Grid باتباع الخطوات التالية:
في مدخل Microsoft Azure:
- حدد Subscriptions في القائمة اليمنى.
- حدد الاشتراك الذي تستخدمه لـ Event Grid.
- في القائمة اليسرى، ضمن Settings، حدد Resource providers.
- ابحث عن Microsoft.EventGrid.
- إذا لم تكن مسجلاً، فحدد Register.
قد يستغرق التسجيل لحظات حتى ينتهي. حدد Refresh لتحديث الحالة. عندما تتحول Status إلى Registered تصبح مستعدًا للمتابعة.
نشر Event Grid Viewer
في هذه البداية السريعة، سنستخدم نموذج Azure Event Grid Viewer لعرض الأحداث في الوقت الفعلي تقريبًا. سيوفر هذا للمستخدم تجربة موجزة في الوقت الفعلي. بالإضافة إلى ذلك، يجب أن تكون الحمولة لكل حدث متاحة للفحص أيضًا.
اشترك في أحداث الرسائل القصيرة باستخدام خطافات الويب
في المدخل، انتقل إلى مورد Azure Communication Services الذي قمت بإنشائه. داخل مورد خدمة الاتصال، حدد Eventsمن القائمة اليسرى لصفحة خدمات الاتصال.
اضغط على Add Event Subscription للدخول إلى معالج الإنشاء.
في صفحة Create Event Subscription، أدخل اسمًا لاشتراك الحدث.
يمكنك الاشتراك في أحداث محددة لإخبار Event Grid بأحداث الرسائل القصيرة التي تريد تتبعها، ومكان إرسال الأحداث. حدد الأحداث التي ترغب في الاشتراك فيها من القائمة المنسدلة. بالنسبة إلى الرسائل القصيرة SMS، سيكون لديك خيار اختيار SMS Received وSMS Delivery Report Received.
إذا طُلب منك تقديم System Topic Name، فلا تتردد في تقديم سلسلة فريدة. هذا المجال ليس له أي تأثير في تجربتك ويستخدم لأغراض القياس الداخلي.
تحقق من القائمة الكاملة للأحداث التي تدعمها Azure Communication Services.
حدد Web Hook في Endpoint type.
بالنسبة إلى Endpoint، انقر فوق Select an endpoint، وأدخل عنوان URL لتطبيق الويب الخاص بك.
في هذه الحالة، سنستخدم عنوان URL من نموذج عارض شبكة حدث Azure الذي قمنا بإعداده مسبقًا في البداية السريعة. سيكون عنوان URL الخاص بالنموذج بالتنسيق: https://{{site-name}}.azurewebsites.net/api/updates
ثم حدد Confirm Selection.
عرض أحداث الرسائل القصيرة
تفعيل أحداث الرسائل القصيرة
لعرض مشغلات الحدث، يجب علينا إنشاء الأحداث في المقام الأول.
SMS Receivedيتم إنشاء الأحداث عندما يتلقى رقم هاتف خدمات الاتصالات رسالة نصية. لبدء حدث ما، ما عليك سوى إرسال رسالة من هاتفك إلى رقم الهاتف المرفق بمورد خدمات الاتصال.SMS Delivery Report Receivedيتم إنشاء الأحداث عندما ترسل رسالة قصيرة SMS إلى مستخدم باستخدام رقم هاتف خدمات الاتصالات. لتشغيل حدث، أنت مطالب بتمكينDelivery Reportفي خيارات الرسائل القصيرة المرسلة. حاول إرسال رسالة إلى هاتفك باستخدامDelivery Report. يتطلب إكمال هذا الإجراء تكلفة صغيرة تبلغ بضعة سنتات من الدولار الأمريكي أو أقل في حساب Azure الخاص بك.
تحقق من القائمة الكاملة للأحداث التي تدعمها Azure Communication Services.
استقبال أحداث الرسائل القصيرة
بمجرد إكمال أي من الإجراءين أعلاه، ستلاحظ أنه تم إرسال أحداث SMS Received و SMS Delivery Report Received إلى نقطة النهاية الخاصة بك. ستظهر هذه الأحداث في نموذج عارض شبكة حدث Azure الذي قمنا بإعداده في البداية. يمكنك الضغط على أيقونة العين بجوار الحدث لرؤية الحمولة بالكامل. ستبدو الأحداث على النحو التالي:
تعرف على المزيد حول مخططات الأحداث ومفاهيم الأحداث الأخرى.
تنظيف الموارد
إذا كنت ترغب في تنظيف وإزالة اشتراك Communication Services، يمكنك حذف المورد أو مجموعة الموارد. يؤدي حذف مجموعة الموارد إلى حذف أية موارد أخرى مقترنة بها أيضًا. تعرف على المزيد بشأن تنظيف الموارد.
الخطوات التالية
في هذه البداية السريعة، تعلمت كيفية استهلاك أحداث الرسائل القصيرة. يمكنك استلام رسائل SMS بإنشاء اشتراك Event Grid.
قد ترغب أيضًا فيما يلي: