إرسال البريد الإلكتروني عبر حساب SendGrid الخاص بك

ستحتاج إلى حساب في SendGrid (Twilio SendGrid) وإمكانية الوصول إلى DNS الخاص بنطاقك.

وثائق SendGrid الخاصة: Sender authentication · API keys · Sign up

1. مصادقة نطاقك

Settings ← Sender Authentication ← Authenticate Your Domain.

اختر مضيف DNS الخاص بك من القائمة، وأجب بـ Yes على "Would you like to also brand the links for this domain?" — تُعيد العلامة التجارية للروابط كتابة الروابط المُتتبَّعة لتشير إلى نطاقك الخاص بدلاً من sendgrid.net، كما ينبغي للعميل الذي يمرر مؤشر الماوس فوق رابط في فاتورتك أن يرى اسمك.

أدخل نطاقاً فرعياً مثل mail.yourdomain.com عندما يُطلب منك النطاق الذي ترسل منه.

2. نشر سجلات CNAME

يمنحك SendGrid ثلاثة أو خمسة سجلات CNAME. أضفها جميعاً.

⭐ يستخدم SendGrid سجلات CNAME بدلاً من سجلات TXT عن قصد، وهو خيار أفضل بالفعل: فالقيم الفعلية للمفاتيح محفوظة لدى SendGrid، وبذلك يمكنهم تدوير مفاتيح التوقيع الخاصة بهم دون أن تضطر إلى تعديل DNS الخاص بك مجدداً.

⚠️ إذا كان مزود DNS الخاص بك هو Cloudflare، فاضبط هذه السجلات على DNS only (سحابة رمادية)، وليس مُعاد توجيهه عبر البروكسي (proxied). فسجل CNAME الموجه عبر البروكسي يُحلَّل إلى عناوين Cloudflare ويفشل فحص SendGrid.

اضغط على Verify في SendGrid. انتظر مدة تصل إلى ساعة واحدة.

3. إنشاء مفتاح API

Settings ← API Keys ← Create API Key.

اختر Restricted Access وامنح إذن Mail Send ← Full Access فقط. لا شيء غير ذلك.

⛔ لا تستخدم مفتاح Full Access. يمكن لمفتاح Full Access قراءة جهات الاتصال الخاصة بك، وتغيير إعدادات حسابك وإنشاء المزيد من المفاتيح؛ والشيء الوحيد الذي نحتاج للقيام به هو إرسال رسالة. إذا تعرّضت نسختنا من مفتاحك للكشف في أي وقت، فإن الفارق بين هذين المفتاحين هو الفارق بين بعض رسائل البريد الإلكتروني غير المرغوب فيها وبين اختراق الحساب بالكامل.

⚠️ يُعرض المفتاح مرة واحدة فقط. انسخه قبل مغادرة الصفحة — لا يمكن لـ SendGrid عرضه لك مرة أخرى، بل استبداله فقط.

4. ربطه في Zinn®

افتح إرسال البريد الإلكتروني في لوحة التحكم الخاصة بك:

• المزود — SendGrid
• الإرسال من هذا النطاق — mail.yourdomain.com (نطاق، وليس عنواناً)
• مفتاح API لـ SendGrid — المفتاح من الخطوة 3

لا يحتاج SendGrid إلى أي إعدادات أخرى منك.

5. إرسال الاختبار وإدخال الرمز

اضغط على إرسال رسالة اختبار إلى صندوق وارد على نطاق مختلف، واقرأ الرمز منها، ثم أدخله.

عندما لا تنجح العملية

403 Forbidden — مفتاح API الخاص بك لا يملك إذن Mail Send. هذا هو السبب الأكثر شيوعاً للفشل بفارق كبير: فمفتاح Restricted Access الذي تم إنشاؤه دون تحديد أي نطاقات صلاحيات تتم مصادقته بنجاح تام ولكن لا يُسمح له بفعل أي شيء.

"The from address does not match a verified Sender Identity" — لم تكتمل مصادقة نطاقك بنجاح بعد، أو أن النطاق الموجود في الإرسال من هذا النطاق ليس هو النطاق الذي قمت بمصادقته. يتحقق SendGrid من النطاق الدقيق: فمصادقة mail.yourdomain.com لا تخول الإرسال من yourdomain.com.

تم القبول ولكن لم يتم التسليم أبداً — انظر إلى Activity في SendGrid. يُعلَّق الحساب الجديد كلياً في بعض الأحيان للمراجعة خلال اليوم الأول تقريباً، وتظل الرسائل معلقة هناك بدلاً من ارتدادها.

تم تعليق حسابك بعد بضع عمليات إرسال — SendGrid صارم للغاية بشأن الحسابات الجديدة التي ترسل إلى عناوين ترتد منها الرسائل. تأكد من نظافة قائمة عملائك قبل التبديل.