إرسال البريد الإلكتروني

محتوى الرسالة

وفّر هوية from على نطاق موثَّق في مساحة العمل، ومستلِمًا واحدًا على الأقل في to، ومحتوى بصيغة HTML أو نصًا عاديًا أو قالبًا مستضافًا منشورًا واحدًا. يمكن لإرسال المحتوى الخام إغفال subject، فينتج موضوع فارغ. تولّد SendHQ بديلًا نصيًا عاديًا من HTML عند الحاجة، لكن البديل الذي تكتبه بنفسك أكثر موثوقية.

المستلِمون والأرصدة

يمكن أن تتضمن الرسالة 100 وجهة على الأكثر من مجموع To وCc وBcc. تستهلك كل وجهة رصيد تسليم واحدًا للمستلِم. تُفحص عناوين المستلِمين المكررة بعد التطبيع مرة واحدة فقط مقابل قائمة المنع، بينما تُحتسب كل وجهة ضمن حدود الرسالة.

إعادة المحاولة الآمنة

أرسل Idempotency-Key ثابتًا لا يزيد على 200 حرف في عمليات الإرسال المفردة والدفعية. تؤدي إعادة استخدام المفتاح مع حمولة JSON مطابقة إلى إعادة الاستجابة المخزَّنة وإضافة Idempotent-Replayed: true. أما تغيير أي مستلِم أو محتوى أو ترويسة أو بيانات قالب تحت المفتاح نفسه فيُعيد 409؛ ويُعيد كذلك طلب متزامن بالمفتاح نفسه 409 ما دام الأول قيد المعالجة.

الإرسال الدفعي

يقبل POST /emails/batch ما يصل إلى 100 كائن رسالة ويُعيد نتيجة لكل موضع. استخدم كائنات رسائل منفصلة لبيانات القالب المخصّصة بدلًا من إرسال قالب مخصّص واحد إلى عدة مستلِمين.

الردود وسلاسل الرسائل

اضبط reply_to_email_id عند الرد. تشتق SendHQ قيم Message-ID وIn-Reply-To وReferences ومعرّف السلسلة الحالي. استرجع المحادثة كاملة بـ GET /threads/:id.

نموذج الحالات