رسالة الرابط السحري لا تصل — قائمة التحقق من التحقق بنطاق Resend
إذا لم يكن قرّاؤك يتلقّون رسائل تسجيل الدخول بالرابط السحري، فإن السبب الأكثر شيوعاً هو نطاق Resend غير الموثّق. إليك قائمة التحقق التشخيصية الكاملة وكيفية إصلاح كل مشكلة.
فشل رسائل الروابط السحرية في الوصول يعود في الغالب إلى أحد ثلاثة أسباب رئيسية: نطاق المُرسِل في Resend غير موثّق (الأكثر شيوعاً)، أو سجلات DNS الخاصة بـ SPF/DKIM مفقودة أو لا تزال تنتشر، أو أن مزوّد البريد الإلكتروني للقارئ يحجب عنوان IP المُرسِل. إليك كيفية تشخيص كل حالة وإصلاحها.
التحقق 1 — هل نطاق Resend موثّق؟
سجّل الدخول إلى app.resend.com وانتقل إلى Domains. يجب أن يظهر نطاق الإرسال (الذي تمّ تعيينه في RESEND_FROM_EMAIL) بحالة «Verified» مع علامة خضراء. إذا ظهرت حالة «Pending» أو «Failed»، فإما أن سجلات DNS لم تنتشر بعد أو أنها غير صحيحة. يشترط Resend ثلاثة سجلات DNS: سجل TXT للـ SPF، وسجل CNAME للـ DKIM، وسجل TXT للـ DMARC. يجب أن تكون الثلاثة موجودة وخالية من الأخطاء.
# DNS records required by Resend:
# SPF (TXT on @):
v=spf1 include:amazonses.com ~all
# DKIM (CNAME on resend._domainkey):
resend._domainkey.yourdomain.com -> em.yourdomain.resend.com
# DMARC (TXT on _dmarc):
v=DMARC1; p=none; rua=mailto:[email protected]التحقق 2 — اختبر باستخدام عنوان بريد إلكتروني مختلف
أرسل رابطاً سحرياً إلى عنوان Gmail وآخر إلى عنوان Outlook/Hotmail. إذا فشل كلاهما، فالمشكلة في إعداد الإرسال (التحقق من النطاق أو مفتاح API الخاص بـ Resend). إذا نجح Gmail وفشل Outlook، فالمشكلة تتعلق بالسمعة (فلاتر Microsoft أكثر صرامة). إذا لم يصل إلى أيّ منهما، راجع سجلات Resend — app.resend.com ثم Logs — بحثاً عن سجلات الارتداد أو الحجب لعنوان القارئ.
التحقق 3 — هل RESEND_FROM_EMAIL يتطابق مع النطاق الموثّق؟
يُرسل VeloCMS روابط الأعضاء السحرية من العنوان المحدد في متغيّر البيئة RESEND_FROM_EMAIL. يجب أن يتطابق نطاق هذا العنوان (الجزء بعد @) مع نطاق موثّق في Resend. إذا كان RESEND_FROM_EMAIL هو [email protected]، فيجب أن يكون yourblog.com هو نطاق Resend الموثّق. أي تعارض — حتى في نطاق فرعي — يجعل Resend يرفض طلب الإرسال بصمت.
يُظهر قسم Logs في لوحة تحكم Resend كل محاولة إرسال، بما فيها تلك التي قُبلت على مستوى API لكنّها حُجبت لاحقاً في مسار التوصيل. استخدم الفلتر بعنوان البريد الإلكتروني للمستلم لرؤية مسار التوصيل الكامل، بما يشمل أي ارتدادات ناعمة أو صلبة.
التحقق 4 — تحديد المعدل وفترات التهدئة
يُحدّد VeloCMS معدل طلبات الروابط السحرية بـ 3 طلبات في الساعة لكل عنوان بريد إلكتروني منعاً للإساءة. إذا طلب أحد القرّاء أكثر من 3 روابط خلال الساعة الماضية، يُسقَط الطلب الرابع بصمت. يرى القارئ رسالة «تحقق من صندوق الوارد» لكن لا تُرسَل أي رسالة. اطلب من القارئ الانتظار 60 دقيقة والمحاولة مجدداً. إذا استمرت المشكلة بعد فترة التهدئة، فلا علاقة لها بتحديد المعدل — انتقل إلى التحقق من سجلات Resend.