شما به یک حساب SendGrid (Twilio SendGrid) و دسترسی به DNS دامنه خود نیاز خواهید داشت.
مستندات خود SendGrid: احراز هویت فرستنده · کلیدهای API · ثبتنام
۱. دامنه خود را احراز هویت کنید
Settings → Sender Authentication → Authenticate Your Domain.
میزبان DNS خود را از فهرست انتخاب کنید، و به "Would you like to also brand the links for this domain?" پاسخ Yes بدهید — برندسازی پیوندها، پیوندهای رهگیریشده را به جای sendgrid.net به دامنه خودتان بازنویسی میکند، و مشتری که نشانگر ماوس را روی پیوندی در فاکتور شما میبرد باید نام شما را ببیند.
هنگامی که دامنهای که از آن ارسال میکنید خواسته شد، یک زیردامنه مانند mail.yourdomain.com وارد کنید.
۲. رکوردهای CNAME را منتشر کنید
سرویس SendGrid به شما سه یا پنج رکورد CNAME میدهد. همه آنها را اضافه کنید.
| Type | Host | Purpose |
|---|
CNAME | em1234.yourdomain.com | دامنه مسیر بازگشت (Return-path/bounce) |
CNAME | s1._domainkey.yourdomain.com | کلید ۱ DKIM |
CNAME | s2._domainkey.yourdomain.com | کلید ۲ DKIM |
⭐ SendGrid عمداً بهجای رکوردهای TXT از CNAME استفاده میکند، و این واقعاً بهتر است: مقادیر واقعی کلید در SendGrid قرار دارند، بنابراین آنها میتوانند کلیدهای امضای خود را بدون نیاز به اینکه شما مجدداً دست به DNS خود بزنید، بازنشانی کنند.
⚠️ اگر ارائهدهنده DNS شما Cloudflare است، این رکوردها را روی DNS only (ابر خاکستری) تنظیم کنید، نه پروکسیشده. یک CNAME پروکسیشده به نشانیهای Cloudflare اشاره میکند و بررسی SendGrid ناموفق خواهد بود.
در SendGrid روی Verify کلیک کنید. تا یک ساعت فرصت دهید.
۳. یک کلید API ایجاد کنید
Settings → API Keys → Create API Key.
گزینه Restricted Access را انتخاب کنید و فقط مجوز Mail Send → Full Access را اعطا کنید. هیچ چیز دیگری نه.
⛔ از کلید Full Access استفاده نکنید. یک کلید Full Access میتواند مخاطبین شما را بخواند، تنظیمات حساب شما را تغییر دهد و کلیدهای بیشتری ایجاد کند؛ تنها کاری که ما باید انجام دهیم ارسال یک پیام است. اگر نسخه ما از کلید شما تا به حال افشا میشد، تفاوت بین این دو کلید تفاوت میان چند ایمیل ناخواسته و یک حساب به خطر افتاده است.
⚠️ کلید فقط یک بار نشان داده میشود. قبل از خروج از صفحه آن را کپی کنید — SendGrid نمیتواند آن را دوباره به شما نشان دهد، فقط میتواند آن را جایگزین کند.
۴. آن را در Zinn® متصل کنید
بخش ارسال ایمیل را در پیشخوان خود باز کنید:
- ارائهدهنده — SendGrid
- ارسال از این دامنه —
mail.yourdomain.com (یک دامنه، نه یک آدرس)
- کلید API سرویس SendGrid — کلید مربوط به مرحله ۳
سرویس SendGrid به هیچ تنظیمات دیگری از سوی شما نیاز ندارد.
۵. آزمون را ارسال کرده و کد را وارد کنید
روی ارسال پیام آزمایشی به صندوق ورودی در یک دامنه دیگر کلیک کنید، کد را از داخل آن بخوانید، و آن را وارد کنید.
وقتی کار نمیکند
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 در مورد حسابهای جدیدی که به آدرسهای بازگشتی (bounce) ارسال میکنند سختگیر است. قبل از شروع فرایند انتقال، مطمئن شوید که فهرست مشتریان شما پاکسازی شده است.