يحدد هذا المستند الطرق الشائعة التي يستخدم بها عملاؤنا Bird للدمج العام. تغطي هذه التكاملات مواضيع أساسية مثل "كيف أرسل البريد الإلكتروني؟" و "كيف أعرف ما حدث للبريد الإلكتروني؟" بالنسبة للمؤسسات التي تُحافظ على إعدادات هجينة بين الأجهزة المحلية والسحابة مع متطلبات الأمان، يغطي دليل تطبيق S/MIME للمنصات المحلية تكوينات PowerMTA و Momentum لتسليم البريد الإلكتروني الآمن. إذا كنت تنتقل من Postfix، أو Sendmail، أو Exim، يجب أن يشرح لك هذا المستند كل ما تحتاج معرفته حول أساسيات إرسال البريد الإلكتروني وإعداد التقارير عنه.  باقي هذا المستند يفترض أن لديك حساب SparkPost قائم.

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

سيقبل Bird البريد للتحويل بعدة طرق. إلى الآن، الأكثر شيوعًا هو SMTP (بروتوكول نقل البريد البسيط) ويقدم Bird نفسه بالضبط مثل أي وسيط بريد إلكتروني آمن آخر على المنفذ 587. إذا كان لديك حاليًا برنامج توليد أو دمج بريد يُنشئ بريدًا إلكترونيًا للتسليم، سيقبله Bird كرسالة SMTP قياسية ويُحاول تسليمها. ستحتاج إلى نظام بشهادة TLS صالحة يمكنه توليد رسائل SMTP وإرسالها عبر المنفذ 587. يمتلك كل من Postfix، و Sendmail، و Exim هذه القدرة بطبيعتها.

مثال 1:

لديك خادم ويب يولد رسالة مدمجة لتسليم البريد الإلكتروني عبر Postfix.
· ضبط برنامج توليد خادم الويب لإرسال رسالة SMTP إلى خادم SparkPost المخصص لك بدلاً من خادم Postfix
· نعم، الأمر سهل فعلاً

مثال 2:

لديك بعض الأكواد الإدارية التي تحتاج لاستخدام وظيفة “Mail” للخادم المحلي.
· إذا كنت تستخدم Sendmail، قم بتحرير ملف /etc/mail/sendmail.mc لإضافة تعريف “smart-host”.
مثل: define(`SMART_HOST’,`smtp.MyMessageBirdServer.com’)
· إذا كنت تستخدم Postfix، قم بتحرير ملف /etc/postfix/transport لإضافة تعريف تحويل smtp.
مثل: * smtp:MyMessageBirdServer.com
· تأكد من تمكين TLS وضبط منفذك الخارجي على 587.
· تطبيق التغييرات وإعادة تشغيل خدمات البريد المحلي
· تنفيذ الأكواد الإدارية وكما سيقوم البريد بالتحويل إلى MessageBird للتسليم

ماذا عن حقن REST؟

بالنسبة للعملاء الذين يستخدمون HTTP(S) لنقل البيانات في شبكاتهم، يمكن أن يكون تحويل الرسالة إلى SMTP مرهقًا. يمتلك Bird واجهة برمجية REST شاملة يمكنها قبول قالب JSON، قائمة المستلمين، وبيانات الاستبدال عبر HTTPS ثم تحويل ذلك إلى بريد إلكتروني مدمج يُرسل إلى العالم عبر SMTP القياسي. هذا مفيد بشكل خاص لتحميل عمل التوليد من خوادم الويب إلى محرك البريد.

مثال:

تولد خوادمك رسالة إخبارية لـ50,000 مستلم يوميًا بدمج البيانات الشخصية ثم إرسال كل منها على حدة عبر Postfix.
· إنشاء كائنات JSON للمستلمين، بيانات الاستبدال، وقالب المحتوى.
· استخدام واجهة REST لطلب POST لكائنات JSON إلى واجهة Transmission API لـBird. القيام بذلك يُحول عملية التوليد إلى SparkPost لتسليم أسرع.
· يمكنك حتى وضع JSON في ملف واستخدام cURL:

curl -v -H "Content-Type: application/json" -X POST \ https://api.bird.com/api/v1transmissions -d@./newsletter.json

كيف أحصل على معلومات التسليم؟

يجمع Bird كميات ضخمة من معلومات التسليم ويجعلها متاحة لك بصيغة JSON يمكن "دفعها" كويب هوك أو "سحبها" مع استدعاء API. تتمثل بيانات التسليم في شيء مثل الآتي:

{      "campaign_id":"Welcome_Letter",    "customer_id":"108",    "delv_method":"esmtp",    "event_id":"84769964978165188",    "friendly_from":"bounce@sp-send.com",    "ip_address":"50.116.50.117",    "ip_pool":"default",    "message_id":"00046a82565a6d39451a",    "msg_from":"abc-bounces-108@sp-send..com",    "msg_size":"2164",    "num_retries":"0",    "queue_time":"1759",    "raw_rcpt_to":"fakespark+32@deadboltemail.com",    "rcpt_meta":{      },    "rcpt_tags":[      ],    "rcpt_to":"fakespark+32@deadboltemail.com",    "routing_domain":"deadboltemail.com",    "sending_ip":"52.38.47.118",    "subject":"Welcome Letter Template",    "tdate":"2018-01-10T21:15:24.000Z",    "template_id":"welcome-letter",    "template_version":"5",    "transmission_id":"84769964922735103",    "type":"delivery",    "timestamp":"2018-01-10T14:15:24.000-07:00" }

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

أمثلة:

1) عادةً ما تصدر سجلات Postfix إلى Excel حتى تتمكن من فرزها وتحليلها.
A) تنفيذ اتصال API للرسائل وتنفيذ بيانات JSON الناتجة عبر JSON2CSV.

2) تحب تحويل سجلات Postfix إلى JSON، ثم سحبها إلى خدمة ويب للقراءة والتحليل.
A) استخدام واجهة برمجية لمؤشرات MessageBird لاستطلاع SparkPost للبيانات التي تحتاجها ويتم تصديرها تلقائيًا بصيغة JSON

3) لديك عملية منفصلة تتابع وتحلل السجلات في الوقت الفعلي وتُحدث قاعدة بيانات المستلمين المنفصلة.
A) يمكن لـSparkPost توفير ويب هوك في الوقت الفعلي يمكنه تغذية عملية شكوى البريد العشوائي والمشتركين غير المسجلين خصيصًا لهذا الغرض. التنفيذ بسيط.

-توم