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

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

وثائق SendGrid الخاصة: مصادقة المرسل · مفاتيح API · التسجيل

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

الإعدادات (Settings) ← مصادقة المرسل (Sender Authentication) ← مصادقة نطاقك (Authenticate Your Domain).

اختر موفر نظام أسماء النطاقات (DNS) الخاص بك من القائمة، وأجب بـ نعم (Yes) على سؤال "هل ترغب أيضاً في وضع علامتك التجارية على الروابط الخاصة بهذا النطاق؟" — تعمل ميزة وضع العلامة التجارية على الروابط على إعادة كتابة الروابط المتتبعة لتشير إلى نطاقك الخاص بدلاً من sendgrid.net، وينبغي للعميل الذي يحوم مؤشر الفأرة فوق رابط في فاتورتك أن يرى اسمك.

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

2. نشر سجلات CNAME

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

| النوع | المضيف | الغرض | | --- | --- | --- | | CNAME | em1234.yourdomain.com | نطاق مسار العودة (الارتداد) | | CNAME | s1._domainkey.yourdomain.com | مفتاح DKIM 1 | | CNAME | s2._domainkey.yourdomain.com | مفتاح DKIM 2 |

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

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

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

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

الإعدادات (Settings) ← مفاتيح API (API Keys) ← إنشاء مفتاح API (Create API Key).

اختر صلاحية مقيدة (Restricted Access) ومنح صلاحية إرسال البريد (Mail Send) ← وصول كامل (Full Access) فقط. لا شيء غير ذلك.

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

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

4. ربطه في Zinn®

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

• الموفر (Provider) — SendGrid
• الإرسال من هذا النطاق (Send from this domain) — mail.yourdomain.com (نطاق وليس عنواناً)
• مفتاح API لـ SendGrid (SendGrid API key) — المفتاح من الخطوة 3

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

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

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

عندما لا يعمل الأمر

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

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

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

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