ارسال

ارسال ایمیل

پیام‌های تراکنشی، دسته‌ای، پاسخ‌ها، پیوست‌ها و قالب‌های میزبانی‌شده را به‌صورت امن ارسال کنید.

محتوای پیام

یک هویت from روی یک دامنه تأییدشده فضای کاری، دست‌کم یک گیرنده to و محتوای HTML، متنی یا یک قالب میزبانی‌شده منتشرشده ارائه دهید. در ارسال با محتوای خام می‌توان subject را حذف کرد که به موضوعی خالی منجر می‌شود. SendHQ در صورت نیاز نسخه متن ساده را از HTML تولید می‌کند، اما نسخه‌ای که خودتان بنویسید قابل‌اعتمادتر است.

گیرندگان و اعتبار ارسال

هر پیام حداکثر می‌تواند مجموعاً 100 مقصد To، Cc و Bcc داشته باشد. هر مقصد یک اعتبار تحویل به گیرنده مصرف می‌کند. نشانی‌های تکراری گیرنده پس از نرمال‌سازی فقط یک بار از نظر فهرست توقف ارسال بررسی می‌شوند، اما هر مقصد همچنان در محدودیت‌های پیام شمرده می‌شود.

تلاش مجدد امن

در ارسال‌های تکی و دسته‌ای یک Idempotency-Key پایدار با حداکثر 200 کاراکتر بفرستید. استفاده مجدد از یک کلید با payload یکسان JSON، پاسخ ذخیره‌شده را دوباره برمی‌گرداند و Idempotent-Replayed: true را اضافه می‌کند. تغییر هر گیرنده، محتوا، هدر یا داده قالب با همان کلید 409 برمی‌گرداند؛ یک درخواست هم‌زمان با آن کلید نیز تا زمانی که درخواست اول در جریان است 409 برمی‌گرداند.

ارسال دسته‌ای

POST /emails/batch حداکثر 100 شیء پیام می‌پذیرد و برای هر موقعیت یک نتیجه برمی‌گرداند. برای داده‌های شخصی‌سازی‌شده قالب، به‌جای ارسال یک قالب شخصی‌سازی‌شده به چند گیرنده، از اشیای پیام جداگانه استفاده کنید.

پاسخ‌ها و رشته‌های گفتگو

هنگام پاسخ دادن، reply_to_email_id را تنظیم کنید. SendHQ مقادیر Message-ID، In-Reply-To، References و شناسه رشته گفتگوی موجود را استخراج می‌کند. کل مکالمه را با GET /threads/:id دریافت کنید.

مدل وضعیت

queuedپیش از ارسال به ارائه‌دهنده ذخیره شده استsentتوسط ارائه‌دهنده پذیرفته شده استdeliveredسرور گیرنده تحویل را پذیرفته استbouncedشکست دائمی تحویلcomplainedگیرنده گزارش اسپم داده استfailedارسال به ارائه‌دهنده شکست خورد