اختبار رسائل SendGrid

قد تُرسل نشرة إخبارية أُنشئت في Single Sends ورسالة إعادة تعيين كلمة المرور أُرسلت عبر /v3/mail/send من حساب SendGrid نفسه، ومع ذلك تصلان كرسالتين مختلفتين إلى حد كبير، وهذا مهم عند إجراء اختبار للبريد العشوائي. تحاول Marketing Campaigns دائمًا إضافة ترويسات إلغاء الاشتراك، بينما لا تضيفها API إلا إذا طلبت ذلك، لذا حدّد أيًا منهما تختبر قبل إرسال أي شيء.

جهة الاستقبال واحدة في الحالتين. يمنحك Email Spam Tester عنوانًا مؤقتًا، من دون الحاجة إلى حساب. تُحتسب فقط أول رسالة تصل خلال ساعة، وتحصل على تقرير يشمل المصادقة، ونتائج SpamAssassin وRspamd، والمحتوى، وقواعد المرسلين ذوي الإرسال الجماعي التي وضعتها Gmail وYahoo، و21 قائمة حظر يجري الاستعلام فيها باستخدام عنوان IP المرسل.

Single Sends: زر الاختبار والبادئة الخاصة به

يوجد الاختبار المدمج ضمن Marketing > Single Sends. افتح Single Send، وابحث عن Test Your Email، وأدخل عنوان الاختبار، ثم انقر على Send Test Message. يتطلب SendGrid مرسلا وموضوعا قبل أن يسمح لك بإجراء الاختبار، وإذا كان الموضوع يتضمن Handlebars، فيجب ملء Test Data. عند الإرسال، يضيف SendGrid البادئة Test - إلى سطر الموضوع.

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

API وSMTP: أمر curl واحد

مقتطف من مثال البدء السريع في SendGrid، مع وضع عنوان الاختبار كمستلم:

curl --request POST \
  --url https://api.sendgrid.com/v3/mail/send \
  --header 'Authorization: Bearer <<YOUR_API_KEY>>' \
  --header 'Content-Type: application/json' \
  --data '{"personalizations":[{"to":[{"email":"test-xxxxxxxxxxxxxxxxxxxx@t.email-spam-tester.com"}],"subject":"Hello, World!"}],"content":[{"type":"text/plain","value":"Heya!"}],"from":{"email":"you@yourdomain.com","name":"Your Name"}}'

عندما يكون اختبار موضع البريد مفعّلًا، تُضاف صناديق البريد لدى مزودي الخدمة إلى مصفوفة to نفسها، وتُضاف العلامة إلى subject، وبذلك يوضّح لك الطلب نفسه أيضًا المجلد الذي يضع فيه Gmail وOutlook وYahoo ومزودو الخدمة الآخرون الرسالة.

أدخل عنوان الاختبار الخاص بك وعنوان From تحقّق منه SendGrid، إما عبر التحقق من مرسل واحد أو مصادقة النطاق. والأفضل أن ترسل الرسالة الفعلية التي يرسلها تطبيقك، مع محتوى HTML الحقيقي، لأن فحوصات المحتوى ستقيّم ما يوجد في النص الأساسي للرسالة.

إذا كان تطبيقك يتصل عبر SMTP، فلن يتغير شيء سوى طريقة النقل. المضيف هو smtp.sendgrid.net، واسم المستخدم هو حرفيًا السلسلة apikey، وليس مفتاحك، ويعمل SSL على المنفذ 465.

توجد أيضًا نقطة نهاية لإرسال رسالة اختبار، POST /v3/marketing/test/send_email. تقبل ما يصل إلى 10 عناوين، لكنها تعمل فقط مع القوالب الديناميكية للمعاملات، لذلك يُعد استدعاء Mail Send العادي أعلاه الاختبار الفعلي لمعظم الرسائل المرسلة عبر API.

تعتمد ترويسات إلغاء الاشتراك على المسار الذي اخترته

تحاول Marketing Campaigns إضافة ترويسات List-Unsubscribe في كل مرة. أما البريد المرسل عبر API أو SMTP، فلا يحصل عليها إلا عند تفعيل Subscription Tracking ضمن Settings > Tracking. عندئذ يضيف SendGrid ترويسة List-Unsubscribe مع رابط HTTPS وList-Unsubscribe-Post: List-Unsubscribe=One-Click.

من دون Subscription Tracking، أضف الترويسات بنفسك في الطلب:

"headers": {
  "List-Unsubscribe-Post": "List-Unsubscribe=One-Click",
  "List-Unsubscribe": "<mailto:unsubscribe@yourdomain.com>, <https://yourdomain.com/unsubscribe>"
}

يطلب SendGrid كلاً من جزأي mailto وhttps، ويحذر من إلغاء اشتراك أي شخص عند إرسال طلب GET عادي إلى ذلك الرابط. توخ الحذر عند النسخ من مقالة دعم SendGrid حول هذه الترويسات. يضبط المثال الثاني فيها List-Unsubscribe-Post على عناوين URL، وهذا خطأ. القيمة دائمًا هي List-Unsubscribe=One-Click. ستجد بقية التفاصيل في صفحة إصلاح List-Unsubscribe.

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

قراءة نتائج المصادقة

في حساب لم تتم مصادقة نطاقه، يرى المستلمون "via sendgrid.net" بعد عنوان From، وتوضح وثائق SendGrid أن مصادقة النطاق تزيل هذه العبارة. يتضمن التقرير تفاصيل أكثر من هذه العبارة. راجع سطري محاذاة DKIM وSPF. إذا كان التوقيع أو مسار الإرجاع تابعًا لنطاق SendGrid بدلًا من نطاقك، فلن يتمكن DMARC من اجتياز التحقق لعنوان From، ويجب أن توجهك الخطة إلى إعداد مصادقة النطاق. أما الإرسال من عنوان gmail.com أو yahoo.com فهو أسوأ. توضح صفحة DMARC في SendGrid أن SPF وDKIM يفشلان في الحالتين، وتحذر وحدة التحكم نفسها من أن هذه الرسائل قد تفشل في فحص DMARC.

توجد مصادقة النطاق ضمن Settings > Sender Authentication. عند تفعيل الأمان التلقائي، وهو الإعداد الافتراضي، يمنحك SendGrid أربعة سجلات:

• سجل CNAME عند em[0000]، يغطي SPF ويصبح مسار الإرجاع الخاص بك؛
• سجلا CNAME عند s1._domainkey وs2._domainkey من أجل DKIM؛
• سجل TXT عند _dmarc بالقيمة v=DMARC1; p=none;.

عند تعطيل الأمان التلقائي، تحصل على سجل MX وسجل SPF من نوع TXT بالقيمة (v=spf1 include:sendgrid.net ~all) عند em[0000]، بالإضافة إلى سجل DKIM من نوع TXT عند m1._domainkey، وتتولى إدارة سجل SPF بنفسك. إذا كان مزود DNS يرفض أسماء CNAME التي تحتوي على _، فهذا هو الخيار الوحيد. وإذا كانت خدمة أخرى تستخدم المحدد s بالفعل، يتيح لك SendGrid اختيار محدد مخصص. تحقق من النتيجة باستخدام أداة فحص DKIM (المحدد s1) وأداة فحص SPF، التي تحسب أيضًا عمليات بحث DNS إذا أصبح سجل SPF لديك مزدحمًا.

الروابط وعناوين IP وبقية التقرير

تؤدي ميزة تتبع النقرات إلى إعادة كتابة كل رابط. إذا كان نص الرابط نفسه URL، فلن يتطابق العنوان الظاهر مع الوجهة الفعلية، وسيشير فحص عدم تطابق الروابط في التقرير إلى ذلك. توضح صفحة قابلية التسليم في SendGrid المشكلة نفسها. استخدم كلمات كنص للرابط، أو اضبط ميزة تمييز الروابط بعلامتك التجارية بحيث تمر الروابط المتتبعة عبر نطاقك، والذي يجب أن يطابق نطاق عنوان From.

ترسل خطتا Trial وEssentials من مجموعات عناوين IP مشتركة، وتشير SendGrid إلى أن هذه العناوين قد تتغير دون إشعار إذا تغيرت سمعتك، لذلك فإن إدراج أحدها في قائمة حظر يؤثر في جميع مستخدمي تلك المجموعة. تتيح لك أداة فحص قوائم الحظر البحث عن عنوان IP مرة أخرى لاحقًا. لا يمكن إعداد DNS العكسي إلا عند استخدام عنوان IP مخصص، وهو متاح مع Pro Email API وAdvanced Marketing Campaigns.