استكشاف الأخطاء وإصلاحها·6 min read·

لماذا لا يصل بريد رابط الدخول السحري؟

التحقق من SPF/DKIM عبر Resend، توجيه الرسائل إلى مجلد الرسائل غير المرغوب فيها، انتهاء صلاحية الرابط السحري بعد 24 ساعة، وفترات الانتظار بين الطلبات — أصلح مشكلات تسليم بريد تسجيل دخول الأعضاء في مدونتك.

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

تحقق من مجلد الرسائل غير المرغوب فيها أولًا (بجدية)

قبل أي شيء آخر: ترسل VeloCMS رسائل الرابط السحري عبر Resend باستخدام عنوان الإرسال الذي ضبطته في الإعدادات ← الإدارة ← البريد الإلكتروني. إذا لم يكن نطاق الإرسال موثقًا بالكامل (SPF + DKIM)، فإن Gmail وOutlook وApple Mail ستوجّه الرسالة مباشرةً إلى مجلد الرسائل غير المرغوب فيها. يحتاج العضو إلى التحقق من مجلد البريد العشوائي والنقر على "ليس بريدًا عشوائيًا" — وهذا يدرّب المرشح على المستقبل.

يجب أن يكون عنوان الإرسال ضمن نطاق تمتلكه وقمت بالتحقق منه في لوحة تحكم Resend. الإرسال من عنوان Gmail أو Outlook كبريد مدونتك سيؤدي شبه حتمي إلى تصفيته كبريد عشوائي، لأنك لا تستطيع إضافة سجلات SPF/DKIM على نطاق Gmail.

تحقق من سجلات SPF وDKIM لنطاق الإرسال

انتقل إلى لوحة تحكم Resend ← النطاقات ← نطاقك. ستجد قائمة مراجعة بسجلات DNS التي يجب إضافتها، وهي ثلاثة أنواع: سجل TXT لـ SPF، وسجل CNAME لـ DKIM، وسجل DMARC اختياري. يجب أن تعرض الثلاثة علامة اختيار خضراء. إن ظهر أيٌّ منها باللون البرتقالي أو الأحمر، فهذا يعني إما أن السجل مفقود أو أنه لم ينتشر بعد.

  • SPF: أضف سجل TXT عند @: v=spf1 include:_spf.resend.com ~all. إذا كان لديك سجل SPF قائم، أضف include:_spf.resend.com داخل السجل الموجود بدلًا من إنشاء سجل مكرر — فامتلاك سجلَي SPF يُفسد التحقق من SPF.
  • DKIM: أضف سجل CNAME الذي يعرضه Resend. اسمه resend._domainkey.yourdomain.com ويشير إلى قيمة يوفرها Resend.
  • DMARC: مستحسن لكنه غير إلزامي. أضف سجل TXT عند _dmarc.yourdomain.com بالقيمة v=DMARC1; p=none; rua=mailto:[email protected] للبدء في وضع المراقبة.
  • يستغرق انتشار DNS من 5 إلى 30 دقيقة. بعد إضافة السجلات، انقر على "التحقق" في لوحة تحكم Resend وانتظر قبل افتراض أن السجلات خاطئة.

انتهاء صلاحية الرابط السحري — نافذة 24 ساعة

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

الروابط السحرية للاستخدام مرة واحدة فقط. بمجرد النقر عليها، تُبطَل فورًا. إذا حصل العضو على خطأ "الرابط منتهي الصلاحية أو مستخدم مسبقًا"، فكل ما عليه هو طلب رابط جديد.

فترة الانتظار في Resend — كثرة الطلبات

إذا نقر العضو على "أرسل لي رابط تسجيل الدخول" مرارًا في فترة قصيرة، تطبّق VeloCMS حدًّا للمعدل لمنع إساءة استخدام البريد الإلكتروني. بعد 3 طلبات خلال 5 دقائق، يعرض نموذج تسجيل الدخول رسالة "يرجى الانتظار قبل طلب رابط آخر". تنتهي فترة الانتظار بعد 5 دقائق. هذا سلوك مقصود — إذ تشير الطلبات المتكررة في الغالب إلى أن الرسائل السابقة انتهت في مجلد البريد العشوائي بدلًا من فشل التسليم.

وصل البريد لكن الرابط لا يعمل

إذا وصل البريد لكن النقر على الرابط يعرض صفحة خطأ، فالسبب الأكثر شيوعًا هو خدمة تغليف الروابط التي تعدّل عنوان URL. بعض بوابات البريد الإلكتروني في الشركات (مثل Proofpoint وMimecast وMicrosoft Safe Links) تُعيد كتابة روابط النقر وقد تُفسد الرمز المميز. افحص عنوان URL الذي انتقل إليه المتصفح — إذا كان يشير إلى link.protection.outlook.com أو ما شابه بدلًا من yoursite.com/member/verify، فهذا يعني أن البوابة أعادت كتابته. يجب على العضو نسخ الرابط الأصلي من مصدر البريد ولصقه مباشرةً في شريط العناوين.

سجلات Resend — تأكيد التسليم

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