كيفية الترحيل من Mailgun إلى SendGrid

إذا كان Mailgun هو موفر خدمة البريد الإلكتروني الحالي لديك وكنت تتطلع إلى إجراء تغيير ، فستساعدك هذه الكيفية على الترحيل إلى SendGrid من خلال إبراز الاختلافات بين الخدمتين.

إذا كنت ترغب في إلقاء نظرة حولك قبل البدء ، فراجع وثائق SendGrid التي تتضمن موارد رائعة قبل الغوص في مرجع وتفاصيل API.

المصطلح

إذا كنت تبحث عن معادل SendGrid لوظائف معينة في Mailgun ، فسيساعدك الجدول التالي:

الحصول على مفتاح API

أولاً ، ستحتاج إلى حساب SendGrid. بعد ذلك ، يجب عليك إنشاء مفتاح API الذي ستستخدمه للإرسال. انتقل إلى الإعدادات -> مفاتيح API ، أو استخدم هذا الارتباط. تتمثل أفضل ممارسات SendGrid والأمان في استخدام مفتاح API مختلف لكل تطبيق من تطبيقاتك المختلفة. تحتوي مفاتيح واجهة برمجة التطبيقات على أذونات دقيقة ، لذا يمكنك تمكين أو تعطيل الوصول للقراءة أو الكتابة لنقاط النهاية الفردية. تأكد من أن مفتاح API الذي قمت بإنشائه يتمتع بحق الوصول الكامل إلى إرسال البريد . (ملاحظة: يجب أن يجتاز حسابك التوفير قبل أن تتمكن من إنشاء مفتاح API.)

مكتبات API

لدينا عدد من مكتبات API المدعومة رسميًا لتسهيل التكامل لعملائنا. إذا كنت تعيد كتابة أي رمز ، أو تعيد بناء طريقة تواصلك مع برنامج ESP كجزء من عملية الترحيل ، فهذا هو الوقت المناسب لتقييم هذه المكتبات:

• sendgrid-csharp - مكتبة C # الرسمية
• Sendgrid-go - مكتبة Go الرسمية
• Sendgrid-java - مكتبة Java الرسمية
• Sendgrid-nodejs - مكتبة NodeJS الرسمية
• sendgrid-php - مكتبة PHP الرسمية
• Sendgrid-python - مكتبة Python الرسمية
• Sendgrid-ruby - مكتبة روبي الرسمية

SMTP

إذا كنت ترسل عبر SMTP ، فهناك بعض الاختلافات التي يجب أن تكون على دراية بها. للمصادقة ، قم بتوفير السلسلة "apikey" كاسم مستخدم SMTP ، واستخدم مفتاح API الخاص بك ككلمة المرور. ثم قم بتوجيه اسم المضيف الخاص بك إلى smtp.sendgrid.net .

يمكنك الاتصال باستخدام SMTP عبر غير مشفر أو TLS على المنافذ 25 و 2525 و 587. يمكنك أيضًا الاتصال عبر SSL على المنفذ 465. بشكل عام ، نوصي بالمنفذ 587 لأنه يؤدي إلى أقل عدد من المشكلات مع موفري الاستضافة.

آلية تخصيص البريد الإلكتروني المرسل عبر SMTP هي رأس X-SMTPAPI الخاص بنا. سيسمح لك هذا الرأس بتعريف الاستبدالات ، وإرسال طلبات نمط دمج البريد المجمعة ، وعوامل تصفية التحكم (مثل تعقب النقرات) النشطة للإرسال.

HTTP

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

تتيح لك التخصيصات تحديد المستلمين والبيانات الوصفية لكل رسالة ، مثل القيم البديلة لتخصيص المحتوى أو custom_args لربط الرسائل بمعرفات المستخدم أو أرقام الطلبات. هناك عدد من الأمثلة على التخصيصات لحالات الاستخدام الشائعة. يمكنك أيضًا العثور على مكالمات أمثلة لـ cURL.

يتم تكوين ميزات مثل تتبع النقرات عبر معلمات tracking_settings و mail_settings. يمكنك أيضًا جدولة إرسال ما يصل إلى 72 ساعة مقدمًا باستخدام معلمة "send_at".

يتم التعامل مع المرفقات المرسلة عبر HTTP بشكل مختلف عن Mailgun. يتطلب Mailgun وظيفة POST متعددة الأجزاء / بيانات النموذج تحتوي على الملفات المراد إرفاقها. باستخدام SendGrid ، يتم ترميز المحتوى كـ Base64 ويتم تضمينه مباشرةً في حمولة JSON جنبًا إلى جنب مع معلومات MIME ، مما يحافظ على رسالتك بأكملها في نفس الحمولة وتبسيط طلب HTTP الخاص بك. يمكنك قراءة المزيد حول تضمين المرفقات في القسم التالي من فصل التوثيق.

ويب هوك

توفر SendGrid خطافين للويب: حدث Webhook لنشر الأحداث في الوقت الفعلي ، وخطاف الويب للتحليل الداخلي لتلقي رسائل البريد الإلكتروني والرد عليها برمجيًا. تختلف أشكال البيانات والحمولات قليلاً عما يوفره Mailgun. كما أننا لا ندعم حاليًا توجيه الرسائل الواردة إلى عناوين URL مختلفة لمعاودة الاتصال ؛ ستحتاج إلى التعامل مع هذا النوع من المنطق في الكود وليس على مستوى واجهة برمجة التطبيقات.

نقاط نهاية API لغير البريد الإلكتروني

بالنسبة إلى نقاط نهاية API التي لا ترسل بريدًا إلكترونيًا ، تحقق من نظرة عامة على API v3. نستخدم طرق HTTP ورموز استجابة بديهية في معظم الحالات ، ونفرض حدودًا لمعدل المكالمات. تم إهمال API v2 ، على الرغم من عدم وجود مخطط زمني للتوقف عن دعمه. يجب أن تفضل جميع عمليات الدمج الجديدة الإصدار v3. يتم تحقيق مصادقة API v3 عن طريق رأس مصادقة برمز حامل.

الحملات التسويقية

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

عدد قليل من الأسئلة الشائعة

س: هل تدعم قوالب رسائل البريد الإلكتروني الخاصة بالمعاملات؟

ج: نعم - وهم ديناميكيون! تتميز قوالب معاملات SendGrid بدعم أصلي لبناء جملة المقاود. بالإضافة إلى الاستبدال والبدائل الأساسية ، يمكنك استخدام التعداد / التكرار على القوائم ، والاستفادة من الشروط والمزيد. لمعرفة المزيد، انقر هنا.

س: هل هناك وضع حماية أو طريقة لاختبار رسائلي الإلكترونية دون إرسالها؟

ج: يمكنك تمكين وضع الحماية عند الإرسال عبر HTTP. هناك أيضًا عنوان "حوض" يمكنك استخدامه للاختبار.

س: هل من الممكن نقل عنوان IP / سمعة المرسل إلى SendGrid؟

ج: لا يمكننا ترحيل عنوان IP أو سمعة ولكن يمكننا المساعدة في تهيئة عنوان IP جديد لك تلقائيًا.

س: هل تدعم SendGrid TLS المفروضة ؟

ج: إطلاقا. يمكنك أن تطلب من خوادم الاستلام دعم TLS وإسقاط الرسائل التي تنتقل إلى الخوادم التي لا تمتثل.

س: هل يمكنني السماح للمستلمين بتحديد أنواع رسائل البريد الإلكتروني التي يريدون تلقيها؟

ج: نعم. يتيح لك منح المستلمين مزيدًا من التحكم في بريدهم الإلكتروني إرسال بريد إلكتروني يريده الأشخاص ، وهو أمر أفضل للجميع. تحقق من مجموعات إلغاء الاشتراك لمزيد من المعلومات.

إذا كنت مهتمًا بالترحيل إلى SendGrid ، فيمكنك العثور على مزيد من المعلومات على sendgrid.com/pricing.