ایمیل ورودی
ایمیل را روی دامنه‌های خودتان بگیرید و به اپلیکیشن‌تان بدهید
رکوردهای MX را به Mail.Land اشاره دهید، برای هر نشانی تعیین کنید با پیام‌ها چه شود و آن‌ها را به‌صورت JSON امضاشده و تجزیه‌شده دریافت کنید. صندوق پشتیبانی، پردازش پاسخ‌ها و ایمیل‌هایی که سیستم‌ها می‌فرستند، همه از همین‌جا شروع می‌شوند.
{
"event": "inbound.received",
"event_id": "evt_3f9c...",
"schema_version": 1,
"data": {
"idempotency_key": "k7m2x9q4p1w8z3_r2d8...",
"email": {
"envelope": {
"from": "[email protected]",
"to": ["[email protected]"]
},
"headers": { "subject": "Re: order 1042" },
"body": { "text_preview": "Hi, the parcel...", "has_html": true },
"attachments": [{
"file_name": "photo.jpg",
"size_bytes": 482113,
"download_url": "https://..."
}],
"authentication": {
"spf": { "result": "pass" },
"dkim": { "result": "pass" },
"dmarc": { "result": "pass" }
},
"spam": { "is_spam": false }
},
"matched_route": { "id": "r2d8...", "name": "support" }
}
}ایمیل ورودی چطور کار می‌کند
ایمیل ورودی و مسیرها را در پنل یا از طریق API تنظیم کنید و رکوردهای MX را نزد سرویس DNS خود منتشر کنید.
1. رکوردهای MX را تنظیم کنید
رکوردهای MX دامنه را اضافه کنید و دریافت ایمیل را برای آن روشن کنید. Mail.Land فقط ایمیل نشانی‌هایی را می‌پذیرد که با یکی از مسیرهای شما جور باشند، یا اگر گزینه‌ی همه‌ی نشانی‌ها (catch-all) روشن باشد، ایمیل هر نشانی را. بقیه پیش از پذیرش رد می‌شوند.
2. مسیر بسازید
هر مسیر بخش پیش از @ را در نشانی بررسی می‌کند و یک یا چند اقدام را اجرا می‌کند. مسیرها به ترتیب اولویتی که تعیین می‌کنید بررسی می‌شوند و می‌توانید پیش از رسیدن هر ایمیلی آزمایش کنید که یک نشانی با کدام مسیر جور می‌شود.
3. پیام را دریافت کنید
Mail.Land سرآیندها، بدنه و پیوست‌ها را تجزیه می‌کند، SPF، DKIM و DMARC را بررسی می‌کند و بعد، طبق مسیر، پیام را ذخیره می‌کند، به وب‌هوک شما می‌فرستد یا رونوشتی از آن را هدایت می‌کند.
یک مسیر چه کارهایی می‌کند
مسیرها می‌توانند دقیق، با پیشوند، پسوند یا بخشی از متن، با آدرس‌دهی + (مثل support+هرچیز)، به‌صورت همه‌ی نشانی‌ها یا با عبارت باقاعده (regex) مقایسه کنند.
| چه اتفاقی می‌افتد | ترکیب با اقدام‌های دیگر | |
|---|---|---|
| ذخیره | پیام تجزیه‌شده را برای پنل و API از ۱ تا ۹۰ روز نگه می‌دارد (پیش‌فرض ۳۰ روز) | بله، با وب‌هوک و هدایت |
| وب‌هوک | پیام تجزیه‌شده را به‌صورت JSON امضاشده به یکی از وب‌هوک‌های شما می‌فرستد | بله، با ذخیره و هدایت |
| هدایت | رونوشتی را از مسیر عادی ارسال به نشانی دیگری می‌فرستد؛ دامنه‌ی مسیر باید برای ارسال تأیید شده باشد | بله، با ذخیره و وب‌هوک |
| رد | پیام را در SMTP با کد وضعیت و متنی که انتخاب می‌کنید رد می‌کند | خیر، باید تنها اقدام مسیر باشد |
| حذف بی‌صدا | پیام را می‌پذیرد و دور می‌اندازد؛ نه ذخیره می‌شود و نه جایی فرستاده می‌شود | خیر، باید تنها اقدام مسیر باشد |
| صندوق لغو اشتراک | نشانی را صندوقی می‌داند که پشت سرآیند List-Unsubscribe شماست | خیر، باید تنها اقدام مسیر باشد |
مسیرهای regex به طرح Pro یا Max نیاز دارند. مسیرها هیچ‌وقت فرستنده، موضوع یا سرآیندهای دیگر را بررسی نمی‌کنند.
برای هر پیام چه دریافت می‌کنید
همان اطلاعات پیام در بدنه‌ی وب‌هوک، در پنل و در API، هر کدام در قالب خودش.
JSON تجزیه‌شده و امضاشده
فرستنده و گیرندگان پاکت، سرآیندهای From، To، Cc، Subject و Reply-To، پیش‌نمایش متن و مسیری که با پیام جور شده است؛ همه با امضای HMAC-SHA256، مثل همه‌ی وب‌هوک‌های Mail.Land.
پیوست‌ها به‌صورت پیوند
هر پیوست با نام، نوع، اندازه و یک پیوند دانلود می‌آید که ۱۵ دقیقه اعتبار دارد. شناسه‌ی پیوست در هر تلاش دوباره ثابت می‌ماند، پس می‌دانید کدام را قبلاً دانلود کرده‌اید.
نتیجه‌ی احراز هویت و هرزنامه
نتیجه‌ی SPF، DKIM و DMARC و برچسب هرزنامه همراه با امتیاز آن برای هر پیام، تا کد شما تصمیم بگیرد به چه چیزی اعتماد کند.
بدنه‌ی کامل و پیام خام
تا وقتی پیام ذخیره است، بدنه‌ی متنی و HTML آن را از API بگیرید (HTML خیلی بزرگ کنار گذاشته می‌شود) یا خود پیام اصلی را به‌صورت فایل .eml دانلود کنید.
ارسال دوباره و حذف تکراری‌ها
هر تحویل یک شناسه‌ی رویداد ثابت و یک کلید idempotency دارد تا تکراری‌ها را کنار بگذارید. می‌توانید پیامی را دستی دوباره به وب‌هوکش بفرستید؛ ارسال دوباره شناسه‌ی رویداد تازه‌ای می‌گیرد که به رویداد اصلی اشاره می‌کند.
کنترل آنچه وارد می‌شود و آنچه بیرون می‌رود
ایمیل ورودی دری به سیستم‌های شماست؛ Mail.Land ابزار بررسی لازم را می‌دهد تا این در تنگ بماند.
فهرست مجاز و فهرست مسدود فرستنده‌ها
فرستنده‌های فهرست مجاز از فیلتر هرزنامه عبور می‌کنند. فرستنده‌ی فهرست مسدود، به انتخاب شما، در SMTP رد می‌شود، هرزنامه علامت می‌خورد یا بی‌صدا حذف می‌شود. ایمیل‌های هرزنامه در قرنطینه‌ای می‌مانند که می‌توانید بررسی‌شان کنید؛ آزاد کردن پیام فقط برچسب هرزنامه را برمی‌دارد و برای رسیدن به وب‌هوک باید آن را دستی دوباره بفرستید.
هدایت بدون رضایت انجام نمی‌شود
پیش از هدایت هر پیامی به نشانی بیرون از دامنه‌های خودتان که برای ارسال تأیید شده‌اند، صاحب آن نشانی پیوند تأییدی دریافت می‌کند که ۷ روز اعتبار دارد. اگر رد کند، این تصمیم قطعی است.
آنچه هرگز هدایت نمی‌شود
ایمیلی که هرزنامه شناخته شده، ایمیلی که با سیاست quarantine یا reject در DMARC رد شده، ایمیل بیش از حد بزرگ و ایمیلی که حلقه می‌سازد، نه هدایت می‌شود و نه هزینه‌ای دارد. هر رونوشت هدایت‌شده یک ارسال از طرح شما حساب می‌شود.
پیش از شروع بدانید
محدودیت‌ها، بی‌پرده.
مسیریابی فقط بر اساس گیرنده
مسیرها فقط بخش پیش از @ در نشانی گیرنده را می‌بینند. قاعده‌های مبتنی بر فرستنده یا موضوع را در کد خودتان و با فیلدهای وب‌هوک بنویسید.
۲۵ مبی‌بایت برای هر پیام
برای هر دامنه می‌توانید سقف کمتری بگذارید و برای تعداد پیام‌های پذیرفته‌شده در روز هم حد تعیین کنید. پیام‌های بزرگ‌تر در SMTP رد می‌شوند.
مدت نگهداری با شما
پیام‌های ذخیره‌شده برای هر دامنه از ۱ تا ۹۰ روز، و به‌طور پیش‌فرض ۳۰ روز، نگه داشته و سپس حذف می‌شوند.
بدون ویروس‌یابی
Mail.Land پیوست‌ها را برای بدافزار بررسی نمی‌کند. در اپلیکیشن‌تان با هر پیوست مثل فایلی نامطمئن رفتار کنید.
پیش‌نمایش در وب‌هوک
وب‌هوک فقط پیش‌نمایش متن را دارد، نه بدنه‌ی کامل را. تا وقتی پیام ذخیره است، بدنه یا پیام خام را از API بگیرید.
پرسش‌های ایمیل ورودی
باید همه‌ی ایمیل‌های دامنه‌ام را به Mail.Land منتقل کنم؟
خیر. ایمیل ورودی روی دامنه‌هایی کار می‌کند که رکورد MX آن‌ها به Mail.Land اشاره دارد. بسیاری از تیم‌ها از یک زیردامنه مثل replies.yourdomain.com استفاده می‌کنند و صندوق‌های معمولشان را همان‌جا که هست نگه می‌دارند.
می‌توانم ببینم فرستنده‌ی پیام چطور احراز هویت شده است؟
بله. نتیجه‌ی SPF، DKIM و DMARC هر پیام، مثل pass، fail یا none، در بدنه‌ی وب‌هوک و در API هست. این نتیجه‌ها به کد شما می‌گویند بررسی‌ها چه یافته‌اند، نه اینکه فرستنده واقعاً کیست. هدایت هم ایمیلی را که با سیاست quarantine یا reject در DMARC رد شده باشد کنار می‌گذارد.
پیوست‌ها را چطور بگیرم؟
هر پیوست در وب‌هوک یک پیوند دانلود دارد که بدون کلید API و تا ۱۵ دقیقه کار می‌کند. بعد از آن، پیوست را از API دانلود کنید یا پیام خام را بگیرید.
ممکن است یک پیام دو بار به وب‌هوکم برسد؟
بله، تحویل دست‌کم یک‌بار است: اگر سمت شما زمان پاسخ تمام شود، تلاش دوباره ممکن است تحویل را تکرار کند. همه‌ی تلاش‌های خودکارِ یک رویداد شناسه‌ی یکسانی دارند؛ شناسه‌هایی را که پردازش کرده‌اید نگه دارید و تکراری‌ها را رد کنید. ارسال دوباره‌ی دستی شناسه‌ی تازه‌ای می‌گیرد.
هدایت از سهمیه‌ی طرح من کم می‌شود؟
بله. رونوشت هدایت‌شده ایمیل تازه‌ای است که از مسیر عادی ارسال می‌رود، پس هر کدام یک ارسال حساب می‌شود. رونوشت‌هایی که هرگز هدایت نمی‌شوند، مثل هرزنامه، هزینه‌ای ندارند.
کدام طرح‌ها ایمیل ورودی دارند؟
مسیرهای ایمیل ورودی بخشی از پلتفرم‌اند؛ مسیرهای regex به طرح Pro یا Max نیاز دارند. صفحه‌ی قیمت‌ها نشان می‌دهد هر طرح چه چیزهایی دارد.
دریافت ایمیل روی دامنه‌تان را شروع کنید
حساب رایگان بسازید، دامنه‌تان را اضافه کنید و اولین مسیر را تنظیم کنید.