ارسال ایمیل از طریق حساب SendGrid خودتان

شما به یک حساب SendGrid (Twilio SendGrid) و دسترسی به DNS دامنه خود نیاز خواهید داشت.

مستندات خود SendGrid: احراز هویت فرستنده · کلیدهای API · ثبت‌نام

۱. دامنه خود را احراز هویت کنید

تنظیمات (Settings) ← احراز هویت فرستنده (Sender Authentication) ← احراز هویت دامنه خود (Authenticate Your Domain).

میزبان DNS خود را از فهرست انتخاب کنید و به پرسش "آیا مایلید پیوندهای این دامنه را نیز با نام تجاری خود نشانه‌گذاری کنید؟" پاسخ بله (Yes) بدهید — نشانه‌گذاری پیوندها، پیوندهای رهگیری‌شده را به جای sendgrid.net به دامنه خودتان بازنویسی می‌کند و مشتری‌ای که نشانگر ماوس را روی پیوندی در صورت‌حساب شما نگه می‌دارد باید نام شما را ببیند.

هنگامی که دامنه ارسال خود را خواستید، یک زیردامنه (subdomain) مانند mail.yourdomain.com وارد کنید.

۲. رکوردهای CNAME را منتشر کنید

SendGrid سه یا پنج رکورد CNAME به شما می‌دهد. همه آن‌ها را اضافه کنید.

| نوع (Type) | میزبان (Host) | هدف (Purpose) | | --- | --- | --- | | CNAME | em1234.yourdomain.com | دامنه مسیر بازگشت (bounce) | | CNAME | s1._domainkey.yourdomain.com | کلید DKIM شماره ۱ | | CNAME | s2._domainkey.yourdomain.com | کلید DKIM شماره ۲ |

⭐ SendGrid عمداً از CNAMEها به جای رکوردهای TXT استفاده می‌کند، و این واقعاً بهتر است: مقادیر کلید واقعی در SendGrid قرار دارند، بنابراین آن‌ها می‌توانند کلیدهای امضای خود را بدون نیاز به اینکه شما دوباره به DNS خود دست بزنید، تغییر دهند.

⚠️ اگر ارائه‌دهنده DNS شما Cloudflare است، این رکوردها را روی فقط DNS (DNS only) (ابر خاکستری) تنظیم کنید، نه پروکسی‌شده. یک CNAME پروکسی‌شده به آدرس‌های Cloudflare تفکیک می‌شود و بررسی SendGrid با شکست مواجه می‌شود.

در SendGrid روی تأیید (Verify) کلیک کنید. حداکثر یک ساعت زمان بدهید.

۳. ایجاد یک کلید API

تنظیمات (Settings) ← کلیدهای API (API Keys) ← ایجاد کلید API (Create API Key).

گزینه دسترسی محدود (Restricted Access) را انتخاب کنید و فقط دسترسی ارسال ایمیل (Mail Send) ← دسترسی کامل (Full Access) را اعطا کنید. هیچ چیز دیگری نباشد.

⛔ از کلید دسترسی کامل استفاده نکنید. کلید دسترسی کامل می‌تواند مخاطبان شما را بخواند، تنظیمات حساب شما را تغییر دهد و کلیدهای بیشتری ایجاد کند؛ تنها کاری که باید انجام دهیم ارسال یک پیام است. اگر نسخه کلید شما روزی فاش شود، تفاوت بین آن دو کلید، تفاوت میان مقداری ایمیل ناخواسته و یک حساب به خطر افتاده است.

⚠️ این کلید فقط یک بار نمایش داده می‌شود. پیش از ترک صفحه آن را کپی کنید — SendGrid نمی‌تواند دوباره آن را به شما نشان دهد، بلکه فقط می‌تواند آن را جایگزین کند.

۴. اتصال آن در Zinn®

گزینه ارسال ایمیل (Email sending) را در داشبورد خود باز کنید:

• ارائه‌دهنده (Provider) — SendGrid
• ارسال از این دامنه (Send from this domain) — mail.yourdomain.com (یک دامنه، نه یک آدرس)
• کلید API سرویس SendGrid (SendGrid API key) — کلید حاصل از مرحله ۳

SendGrid به هیچ تنظیم دیگری از سوی شما نیاز ندارد.

۵. ارسال آزمایشی و وارد کردن کد

روی ارسال پیام آزمایشی (Send test message) به یک صندوق ورودی در دامنه‌ای دیگر کلیک کنید، کد را از آن بخوانید و وارد کنید.

هنگامی که کار نمی‌کند

خطای ۴۰۳ ممنوع (403 Forbidden) — کلید API شما مجوز ارسال ایمیل (Mail Send) را ندارد. این رایج‌ترین خرابی با اختلاف زیاد است: یک کلید دسترسی محدود که بدون هیچ محدوده (scope) تیک‌خورده‌ای ایجاد شده است، به شکل بی‌نقص احراز هویت می‌شود و اجازه انجام هیچ کاری را ندارد.

«آدرس فرستنده با یک هویت فرستنده تأییدشده مطابقت ندارد» ("The from address does not match a verified Sender Identity") — احراز هویت دامنه شما هنوز سبز نشده است، یا دامنه موجود در بخش ارسال از این دامنه (Send from this domain) همان دامنه‌ای نیست که احراز هویت کرده‌اید. SendGrid دامنه دقیق را بررسی می‌کند: احراز هویت کردن mail.yourdomain.com مجوز ارسال از yourdomain.com را صادر نمی‌کند.

پذیرفته شده اما هرگز تحویل داده نشده است (Accepted but never delivered) — بخش فعالیت (Activity) را در SendGrid بررسی کنید. یک حساب کاملاً جدید گاهی اوقات برای بررسی در روز اول یا بیشتر نگه داشته می‌شود و پیام‌ها به جای برگشت خوردن، همان‌جا باقی می‌مانند.

حساب شما پس از چند ارسال معلق شد (Your account was suspended after a few sends) — SendGrid نسبت به ارسال حساب‌های جدید به آدرس‌هایی که برگشت می‌خورند سخت‌گیر است. پیش از جابجایی، مطمئن شوید فهرست مشتریانتان پاک‌سازی شده است.