يحدد هذا المستند الطرق الشائعة التي يستخدم فيها عملاؤنا Bird للتكامل العام.  تشمل هذه التكاملات مواضيع أساسية مثل “كيف أرسل البريد الإلكتروني؟” و “كيف أعرف ماذا حدث للبريد الإلكتروني؟”  إذا كنت تنتقل من 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 API REST شامل يمكنه قبول قالب JSON، قائمة بالمستلمين، وبيانات الاستبدال عبر HTTPS ثم تحويل ذلك إلى بريد إلكتروني مُنشأ (مدمج) ليتم إرساله إلى العالم عبر بروتوكول SMTP القياسي. هذا مفيد بشكل خاص لتخفيف عبء العمل من خوادم الويب إلى محرك البريد.

المثال:

تقوم خوادمك بإنشاء نشرة إخبارية تُرسل إلى 50,000 مستلم يوميًا بدمج البيانات الشخصية ثم إرسال كل منها فرديًا عبر Postfix.
· قم بإنشاء كائنات JSON للمستلمين وبيانات الاستبدال وقالب المحتوى.
· استخدم REST API لإرسال كائنات JSON إلى 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 يمكن أن تكون "مدفوعة" ك webhook أو "مسحوبة" مع استدعاء 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 metrics للاستطلاع SparkPost للحصول على البيانات التي تحتاجها، ويتم تصديرها تلقائيًا كـ JSON

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

-توم