مشاركة عبر

التشغيل السريع: معالجة أحداث البريد الإلكتروني

  • مقالة

ابدأ مع Azure Communication Services باستخدام Azure Event Grid للتعامل مع أحداث البريد الإلكتروني لخدمات الاتصالات. بعد الاشتراك في أحداث البريد الإلكتروني مثل تقارير التسليم وتقارير التفاوض، يمكنك إنشاء هذه الأحداث وتلقيها. يكلف إكمال هذا التشغيل السريع مبلغًا صغيرًا قدره بضعة سنتات أمريكية أو أقل في حساب 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.

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

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

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

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

  3. حدد Add Event Subscription.

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

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

  5. ضمن أنواع الأحداث، حدد الأحداث التي تريد الاشتراك فيها. بالنسبة للبريد الإلكتروني، يمكنك اختيار Email Delivery Report Received و Email Engagement Tracking Report Received.

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

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

  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. يحتوي مربع نقطة نهاية المشترك على عنوان URL، وزر تأكيد التحديد مرئي.

عرض أحداث البريد الإلكتروني

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

تشغيل أحداث البريد الإلكتروني

لعرض مشغلات الأحداث، نحتاج إلى إنشاء بعض الأحداث. لتشغيل حدث، أرسل بريدا إلكترونيا باستخدام مورد مجال البريد الإلكتروني المرفق بمورد Communication Services.

  • Email Delivery Report Received يتم إنشاء الأحداث عندما تكون حالة البريد الإلكتروني في حالة المحطة الطرفية، أي تم التسليم، فشل، FilteredSpam، معزول.
  • Email Engagement Tracking Report Received يتم إنشاء الأحداث عند فتح البريد الإلكتروني المرسل أو النقر فوق ارتباط داخل البريد الإلكتروني. لتشغيل حدث، تحتاج إلى تشغيل الخيار على User Interaction Tracking مورد مجال البريد الإلكتروني

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

تلقي أحداث البريد الإلكتروني

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

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

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

  • EngagementContext يشير إلى الارتباط الذي تم النقر فوقه عندما يكون نوع التفاوض هو Click.
  • UserAgent يشير إلى User-Agent التي نشأ منها حدث مشاركة البريد الإلكتروني هذا. مثل. إذا تفاعل المستخدم على Edge باستخدام جهاز Win10: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML، مثل Gecko) Chrome/42.0.2311.135 Safari/537.36 Edge/12.246
  • EngagementType يشير إلى نوع التفاوض، والقيم المحتملة هي "عرض" أو "النقر".

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

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

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

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

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

إرسال بريد إلكتروني

للحصول على معلومات المخطط وأحداث المثال، راجع Azure Communication Services - أحداث البريد الإلكتروني.

قد ترغب أيضا في الاطلاع على المقالات التالية: