مشاركة عبر

التشغيل السريع: معالجة رسائل SMS وأحداث تقرير التسليم

  • مقالة

ابدأ مع Azure Communication Services باستخدام Azure Event Grid للتعامل مع أحداث Communication Services SMS. بعد الاشتراك في أحداث SMS مثل الرسائل الواردة وتقارير التسليم، يمكنك إنشاء هذه الأحداث وتلقيها. يتطلب إكمال هذا التشغيل السريع تكلفة صغيرة تبلغ بضعة سنتات أمريكية أو أقل في الحساب في Azure.

هام

تعتمد قدرات الرسائل النصية القصيرة وPSTN على رقم الهاتف الذي تستخدمه والبلد/المنطقة التي تعمل فيها كما يحددها عنوان فوترة Azure. لمزيد من المعلومات، تفضل بزيارة وثائق أهلية الاشتراك .

المتطلبات الأساسية

نبذة عن Event Grid

Event Grid هي خدمة أحداث مستندة إلى السحابة. في هذه المقالة، ستتعلم كيفية الاشتراك في أحداث خدمة الاتصال، وتشغيل حدث لعرض النتيجة. بشكل عام، يمكنك إرسال الأحداث إلى نقطة نهاية تعالج بيانات الحدث وتتخذ الإجراءات. في هذه المقالة، سنرسل الأحداث إلى تطبيق ويب يجمع الرسائل ويعرضها.

إعداد البيئة

لإعداد البيئة التي سنستخدمها لإنشاء الأحداث وتلقيها، اتبع الخطوات الواردة في الأقسام التالية.

تسجيل موفر موارد Event Grid

إذا لم تكن قد استخدمت Event Grid مسبقا في اشتراك Azure الخاص بك، فقد تحتاج إلى تسجيل موفر موارد Event Grid. لتسجيل الموفر، اتبع الخطوات التالية:

  1. انتقل إلى مدخل Azure.
  2. في القائمة اليمنى، حدد الاشتراكات.
  3. حدد الاشتراك الذي تستخدمه لشبكة الأحداث.
  4. في القائمة اليسرى، ضمن Settings، حدد Resource providers.
  5. ابحث عن Microsoft.EventGrid.
  6. إذا لم يكن موفر الموارد مسجلا، فحدد Register.

قد يستغرق التسجيل بعض الوقت. حدد Refresh لتحديث الحالة. عندما يظهر Registered ضمن Status، تكون جاهزا للمتابعة.

نشر عارض Event Grid

لهذا التشغيل السريع، سنستخدم عارض Event Grid لعرض الأحداث في الوقت الفعلي تقريبا. يوفر العارض للمستخدم تجربة موجز في الوقت الحقيقي. أيضا، يجب أن تكون حمولة كل حدث متاحة للفحص.

لإعداد العارض، اتبع الخطوات الواردة في Azure Event Grid Viewer.

الاشتراك في أحداث SMS باستخدام خطافات الويب

يمكنك الاشتراك في أحداث معينة لتزويد Event Grid بمعلومات حول مكان إرسال الأحداث التي تريد تعقبها.

  1. في المدخل، انتقل إلى مورد Communication Services الذي قمت بإنشائه.

  2. داخل مورد Communication Services، في القائمة اليسرى من صفحة Communication Services ، حدد Events.

  3. حدد Add Event Subscription.

    لقطة شاشة تعرض صفحة الأحداث لمورد Azure Communication Services. يتم استدعاء زر اشتراك الحدث.

  4. في صفحة إنشاء اشتراك حدث ، أدخل اسما لاشتراك الحدث.

  5. ضمن أنواع الأحداث، حدد الأحداث التي تريد الاشتراك فيها. بالنسبة للرسائل القصيرة، يمكنك اختيار SMS Received و SMS Delivery Report Received.

  6. إذا طُلب منك تقديم System Topic Name، فلا تتردد في تقديم سلسلة فريدة. هذا المجال ليس له أي تأثير في تجربتك ويستخدم لأغراض القياس الداخلي.

    لقطة شاشة تعرض مربع الحوار إنشاء اشتراك حدث. ضمن أنواع الأحداث، يتم تحديد رسائل SMS المستلمة وتقرير تسليم الرسائل القصيرة المستلمة.

  7. بالنسبة إلى Endpoint type، حدد Web Hook.

    لقطة شاشة تعرض تفاصيل مربع الحوار إنشاء اشتراك حدث. في قائمة نوع نقطة النهاية، يتم تحديد Web Hook.

  8. بالنسبة إلى نقطة النهاية، حدد تحديد نقطة نهاية، ثم أدخل عنوان URL لتطبيق الويب الخاص بك.

    في هذه الحالة، سنستخدم عنوان URL من عارض Event Grid الذي قمنا بإعداده سابقا في التشغيل السريع. يحتوي عنوان URL للعينة على هذا التنسيق: https://{{site-name}}.azurewebsites.net/api/updates

  9. حدد Confirm Selection.

    لقطة شاشة تعرض مربع الحوار Select Web Hook. يحتوي مربع نقطة نهاية المشترك على U R L، وزر تأكيد التحديد مرئي.

عرض أحداث SMS

لإنشاء أحداث SMS وتلقيها، اتبع الخطوات الواردة في الأقسام التالية.

تشغيل أحداث SMS

لعرض مشغلات الأحداث، نحتاج إلى إنشاء بعض الأحداث.

  • SMS Received يتم إنشاء الأحداث عندما يتلقى رقم هاتف خدمات الاتصالات رسالة نصية. لتشغيل حدث، أرسل رسالة من هاتفك إلى رقم الهاتف المرفق بمورد Communication Services.
  • SMS Delivery Report Received يتم إنشاء الأحداث عند إرسال رسالة نصية قصيرة إلى مستخدم باستخدام رقم هاتف Communication Services. لتشغيل حدث، تحتاج إلى تشغيل Delivery Report خيار الرسائل القصيرة التي ترسلها. حاول إرسال رسالة إلى هاتفك مع Delivery Report تشغيل. يتطلب إكمال هذا الإجراء تكلفة صغيرة تبلغ بضعة سنتات من الدولار الأمريكي أو أقل في حساب Azure الخاص بك.

تحقق من القائمة الكاملة للأحداث التي تدعمها Communication Services.

تلقي أحداث SMS

بعد إنشاء حدث، ستلاحظ أنه SMS Received يتم إرسال الأحداث والأحداث SMS Delivery Report Received إلى نقطة النهاية الخاصة بك. تظهر هذه الأحداث في عارض Event Grid الذي قمنا بإعداده في بداية هذا التشغيل السريع. حدد أيقونة العين بجوار الحدث لمشاهدة الحمولة بأكملها. يجب أن تبدو الأحداث مشابهة للبيانات التالية:

لقطة شاشة لعارض Azure Event Grid الذي يعرض مخطط Event Grid لحدث تم تلقيه بواسطة رسالة نصية قصيرة.

لقطة شاشة لعارض Azure Event Grid الذي يعرض مخطط Event Grid لحدث تقرير تسليم SMS.

تعرف على المزيد حول مخططات الأحداث ومفاهيم الأحداث الأخرى.

تنظيف الموارد

إذا كنت ترغب في تنظيف وإزالة اشتراك في خدمات الاتصالات، فيمكنك حذف المورد أو مجموعة الموارد. يؤدي حذف مجموعة الموارد إلى حذف أية موارد أخرى مقترنة بها أيضًا. تعرف على المزيد بشأن تنظيف الموارد.

الخطوات التالية

في هذه البداية السريعة، تعلمت كيفية استهلاك أحداث الرسائل القصيرة. يمكنك استلام رسائل SMS بإنشاء اشتراك Event Grid.

إرسال رسائل قصيرة SMS

قد ترغب أيضًا في: