ضبط إعدادات البريد الإلكتروني

يتم الآن عرض مستندات Apigee Edge.
انتقِل إلى مستندات Apigee X. المعلومات

ترسل بوابة "خدمات المطوِّرين" تلقائيًا رسائل إلكترونية استجابةً لأحداث معيّنة. على سبيل المثال، عندما يسجّل مطوّر برامج جديد على المنصة، ترسل البوابة تلقائيًا رسالة ترحيب إلكترونية إلى المطوّر. أو إذا فقد المطوّر كلمة المرور، يمكنه طلب رسالة إلكترونية تحتوي على كلمة مرور مؤقتة.

بصفتك موفّر واجهة برمجة تطبيقات، يمكنك التحكّم في جميع جوانب الرسائل الإلكترونية التي تنشئها البوابة، بما في ذلك:

  • تنسيق الرسائل الإلكترونية التلقائية التي ترسلها البوابة
  • تحديد خادم SMTP الذي تستخدمه البوابة
  • إضافة قواعد لإنشاء رسائل إلكترونية استجابةً للأحداث على البوابة

إرسال رسائل إلكترونية من بوابة مستنِدة إلى السحابة الإلكترونية

يجب استخدام إعدادات البريد الإلكتروني التلقائية للبوابة المستنِدة إلى السحابة الإلكترونية والتي تم نشرها في Pantheon أو Acquia في بيئات غير إنتاجية فقط. قد يتم حظر الرسائل الإلكترونية المُرسَلة من خادم سحابي مجهول أو وضع علامة عليها كرسالة غير مرغوب فيها.

بالنسبة إلى بوابات الإنتاج، يمكنك استخدام أحد الخيارات التالية لإرسال الرسائل الإلكترونية:

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

ويتم إرسال البريد تلقائيًا باستخدام الدالة PHP mail(). تحاول لغة PHP إرسال رسالة إلكترونية باستخدام sendmail على النظام المحلي، والذي يمكن تهيئته في ملف php.ini بلغة PHP.

بالنسبة إلى بوابات الإنتاج، يمكنك استخدام وحدة SMTP الموضحة أدناه لإرسال رسالة إلكترونية عبر خادم SMTP أو خادم الشركة.

تهيئة خادم SMTP

تتطلب بوابة المطوّرين ضبط خادم SMTP لإرسال الرسائل الإلكترونية. لضبط خادم SMTP، يجب أولاً تفعيل وحدة دعم مصادقة بروتوكول نقل البريد البسيط (SMTP) في Drupal على بوابة المطوّرين.

بعد ضبط خادم SMTP، جميع الرسائل الإلكترونية التي ترسلها بوابة المطوّرين تستخدم خادم SMTP. وتشمل هذه الرسائل الإلكترونية المُرسَلة إلى المطوّرين الجدد والرسائل الإلكترونية المُرسَلة إلى المطوّرين الذين فقدوا كلمة مرورهم والرسائل الإلكترونية المُرسَلة إلى المطوّرين الذين لديهم حسابات محظورة.

لضبط خادم SMTP:

  1. سجّل الدخول إلى المنصة كمستخدم لديه امتيازات المشرف أو امتيازات إنشاء المحتوى.
  2. اختر الوحدات في قائمة إدارة Drupal.
    ستفتح صفحة "الوحدات".
  3. فعّل وحدة دعم مصادقة SMTP.
  4. احفظ الضبط.
  5. بعد تفعيل الوحدة، اختَر ضبط في إدخال دعم مصادقة SMTP في صفحة "الوحدات".
    تظهر صفحة إعداد دعم مصادقة SMTP.
  6. ضمن تفعيل هذه الوحدة أو تفعيل، اختَر تفعيل.
  7. في قسم إعدادات خادم SMTP، أدخِل المعلومات التالية:
    • عنوان خادم SMTP على سبيل المثال، بالنسبة إلى خادم SMTP للبريد الصادر في Gmail، استخدِم smtp.gmail.com.
    • يمكنك اختياريًا إدخال عنوان خادم SMTP الاحتياطي. هذه القيمة غير مطلوبة.
    • أدخِل منفذ SMTP. يمكن أن تختلف قيمة هذا المنفذ استنادًا إلى بروتوكول التشفير المحدّد. على سبيل المثال، في Gmail، يكون المنفذ هو 465 عند استخدام طبقة المقابس الآمنة و587 لطبقة النقل الآمنة.
    • حدد بروتوكول التشفير كـ None، أو طبقة المقابس الآمنة، أو TLS.
  8. في منطقة مصادقة SMTP، حدِّد اسم المستخدم وكلمة المرور المستخدَمين في مصادقة SMTP. ويجب أن يكون اسم المستخدم وكلمة المرور صالحان في خادم SMTP.
  9. ضمن خيارات البريد الإلكتروني، أدخِل عنوان البريد الإلكتروني واسم المستخدم الذي أنشأ الرسالة الإلكترونية. تتوافق هذه القيم مع العنوان "من" للرسالة الإلكترونية.
  10. اختياريًا، ضمن إرسال رسالة إلكترونية تجريبية، أدخِل عنوان بريد إلكتروني حيث ترسل البوابة رسالة اختبار.
  11. احفظ الضبط.
    يؤدي حفظ الإعدادات إلى إنشاء رسالة اختبار إلكترونية وعرض أي أخطاء في الإعداد. تحقَّق من البريد الوارد لعنوان البريد الإلكتروني لرسالة الاختبار للتأكّد من وصولها.
  12. اختَر الإعداد > النظام > معلومات الموقع الإلكتروني في قائمة إدارة Drupal.
  13. ضمن Site Details (تفاصيل الموقع الإلكتروني)، اضبط عنوان البريد الإلكتروني على عنوان البريد الإلكتروني نفسه الذي حددته في الخطوة 9.
    تستخدم بعض وحدات Drupal التي تنشئ عناوين بريد إلكتروني هذا الحقل لتحديد عنوان "من" للرسالة الإلكترونية، وليس القيمة في صفحة دعم مصادقة SMTP.
  14. احفظ الضبط.

تهيئة إشعارات البريد الإلكتروني وتنسيقها

يمكنك إعداد إشعارات البريد الإلكتروني المختلفة التي يتم إرسالها استجابةً لأنشطة معيَّنة مثل تسجيل حسابات المطوّرين وحذفها وحظرها وإزالة حظرها.

ويمكنك أيضًا التحكّم في عنوان الحقل "من" للرسائل الإلكترونية.

لضبط الإشعارات عبر البريد الإلكتروني:

  1. سجّل الدخول إلى المنصة كمستخدم لديه امتيازات المشرف أو امتيازات إنشاء المحتوى.
  2. اختَر الضبط > الأشخاص > إعدادات الحساب في قائمة إدارة Drupal. وسيؤدي ذلك إلى فتح صفحة "إعدادات الحساب".
  3. حدد نوع إشعار البريد الإلكتروني في القسم "الرسائل الإلكترونية" من صفحة "إعدادات الحسابات". على سبيل المثال، يمكنك اختيار عبارة "مرحبًا (لا تلزم الموافقة)"، لإرسال رسالة إلكترونية عندما تتم الموافقة على حساب المطوّر تلقائيًا أثناء عملية تسجيل المطوّر.

  4. عدِّل موضوع ونص إشعار البريد الإلكتروني.
    ضَع المؤشر في حقل، مثل الموضوع، ثم انقر على رابط تصفّح الرموز المميّزة المتاحة أسفل النموذج للاطّلاع على قائمة الرموز المميّزة التي يمكنك استخدامها في الحقل. ستظهر نافذة منبثقة تتيح لك اختيار رمز مميّز لإضافته، مثل [user:name]، والذي يتوافق مع اسم المستخدم للمطوّر.
  5. انقر على حفظ الضبط.

يمكنك أيضًا تغيير اسم وعنوان الحقل "من" في إشعار البريد الإلكتروني.

لتغيير الاسم والعنوان في الحقل "من":

  1. سجّل الدخول إلى المنصة كمستخدم لديه امتيازات المشرف أو امتيازات إنشاء المحتوى.
  2. اختَر الضبط > النظام > دعم مصادقة SMTP في قائمة إدارة Drupal. يؤدي ذلك إلى فتح صفحة دعم مصادقة SMTP.
  3. حدِّد عنوان البريد الإلكتروني للحقل "من" في الحقل عنوان البريد الإلكتروني من:.
  4. حدد اسم "من" في الحقل اسم الرسالة الإلكترونية الواردة.
  5. انقر على حفظ الضبط.
  6. اختَر الإعداد > النظام > معلومات الموقع الإلكتروني في قائمة إدارة Drupal.
  7. حدد عنوان البريد الإلكتروني نفسه الذي استخدمته في الخطوة 3 في حقل "عنوان البريد الإلكتروني".
  8. انقر على حفظ الضبط.

إنشاء رسالة إلكترونية عند وقوع الحدث

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

يتضمّن هذا القسم مثالاً على كيفية إنشاء قاعدة لإنشاء رسالة إلكترونية عندما يسجّل المطوّر تطبيقًا. عدِّل هذا الإجراء حسب الضرورة لإنشاء رسائل إلكترونية لفعاليات أخرى.

لإنشاء رسالة إلكترونية عندما ينشئ المطوِّر تطبيقًا:

  1. سجّل الدخول إلى المنصة كمستخدم لديه امتيازات المشرف أو امتيازات إنشاء المحتوى.
  2. اختر الوحدات في قائمة إدارة Drupal.
  3. تأكَّد من تفعيل وحدة واجهة مستخدم القواعد.
  4. اختَر الضبط > سير العمل > القواعد في قائمة إدارة Drupal. يؤدي هذا إلى فتح صفحة "القواعد".
  5. اختَر الزر إضافة قاعدة جديدة.
  6. في صفحة القواعد الجديدة، حدِّد ما يلي:
    • اسم القاعدة، مثلاً "إرسال قاعدة البريد الإلكتروني".
    • يمكنك، إن أردت، تحديد أي علامات يتم استخدامها لتصنيف القواعد الخاصة بالبحث.
    • في القائمة المنسدلة التفاعل عند الحدث، اختَر Devconnect > عند إنشاء تطبيق مطوِّر.
  7. احفظ القاعدة.
    يؤدي حفظ القاعدة إلى فتح نموذج تعديل "القواعد" من ثلاثة أجزاء: الأحداث (التي أنشأتها للتو) والشروط والإجراءات.
  8. ضمن الإجراءات، اختَر إضافة إجراء.
  9. من القائمة المنسدلة اختَر الإجراء المطلوب إضافته، اختَر النظام > إرسال بريد.
    يفتح هذا الاختيار صفحة تتيح لك تنسيق الرسالة الإلكترونية. استخدِم هذا النموذج لتحديد حقول "إلى" و"الموضوع" و"الرسالة" وغيرها من حقول الرسالة الإلكترونية.

    وسِّع رابط أنماط الاستبدال أسفل كل حقل للاطّلاع على قائمة الأنماط التي يمكنك استخدامها في الحقل. على سبيل المثال، إذا وسّعت أنماط الاستبدال ضمن الحقل "إلى"، ستظهر لك قائمة بالأنماط التي تتضمّن [app:developer]. إذا حددت هذا النمط في الحقل "إلى"، يتم إرسال الرسالة الإلكترونية إلى منشئ التطبيق.
  10. اضبط الحقول كما هو موضّح أدناه:
  11. اختَر حفظ للعودة إلى صفحة تعديل القاعدة.
  12. اختَر حفظ التغييرات.

اختبِر القاعدة من خلال إضافة تطبيق جديد على البوابة. من المفترض أن تتلقّى إشعارًا عبر البريد الإلكتروني في ردّ يظهر على النحو التالي:

Subject: App test email app created

App: test email app
API products: PremiumWeatherAPI, weatherapikey-Product
Created at: Mon, 01/27/2014 - 10:16